thbe/cups

Docker上的CUPS服务

这是一个基于Alpine Linux的Docker镜像，用于运行CUPS（通用UNIX打印系统）实例，并内置Apple zeroconf支持，方便设备自动发现打印服务。

镜像概述

该镜像基于官方Alpine Linux镜像构建，集成CUPS打印服务及相关工具，支持通过环境变量配置管理员密码，提供轻量、灵活的打印服务部署方案。

核心功能

• 运行标准CUPS打印服务，兼容多种打印机协议
• 内置Apple zeroconf（Bonjour），实现跨设备自动发现
• 支持环境变量设置管理员密码，提升安全性
• 提供调试模式，便于排查服务运行问题
• 基于Alpine镜像，资源占用低，启动速度快

使用场景

• 个人或小型办公环境快速搭建共享打印服务
• 开发测试环境模拟打印场景
• 跨平台（Mac、Linux、Windows）打印机共享需求

配置说明

环境变量

• CUPS_PASSWORD：设置root用户密码（管理员账号）
• CUPS_DEBUG：启用调试模式（设置任意非空值即可）

部署示例

1. 下载镜像

bash
docker pull docker.xuanyuan.run/thbe/cups

2. 启动服务（使用官方脚本）

bash
wget https://raw.githubusercontent.com/thbe/docker-cups/master/start_cups.sh
export CUPS_PASSWORD='你的管理员密码'
chmod 755 start_cups.sh
./start_cups.sh

3. 检查服务状态

bash
docker logs --tail 1000 --follow --timestamps cups

4. 进入容器终端

bash
docker exec -ti cups /bin/sh

5. 源码构建镜像

bash
git clone https://github.com/thbe/docker-cups.git
cd docker-cups
docker build --rm --no-cache -t thbe/cups .

重要注意事项

• 默认管理员账号为root，初始密码为password（建议通过CUPS_PASSWORD修改）
• 后续版本将支持持久化CUPS配置文件

技术细节

• 基础镜像：Alpine Linux
• CUPS版本：来自Alpine官方软件仓库

开发贡献

若需扩展功能或优化镜像，可fork GitHub仓库（https://github.com/thbe/docker-cups）并提交合并请求。