
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
该镜像提供CUPS构建版本,包含一些额外特性以简化其在Docker中的安装和维护。与Docker Hub上其他CUPS镜像不同,本镜像不使用发行版包,而是从源码构建CUPS和cups-filters。这意味着可以更快地更新到新版本,并支持指定CUPS版本进行部署。
自2.3版本起,本镜像基于Buster。目前Debian Buster上的dnssd发现功能不稳定,使用IP地址或常规主机名时工作正常,但dnssd发现的打印机可能会间歇性断开连接。这可能通过调整avahi配置解决,但avahi默认不包含在镜像中,仅在安装hplip驱动时才会安装。
用户管理机制尚不完善,CUPS默认配置也不太适合Docker环境。欢迎通过文档改进、源码补丁或安装配置补丁等方式提交修复建议,以提升镜像可用性。
CUPS默认安装的驱动较少,若无驱动则功能有限。建议通过创建基于本镜像的Dockerfile来安装所需驱动。为简化驱动安装,镜像在/usr/local/docker/share/drivers目录下提供了Shell脚本,用于安装常见驱动。若成功安装新驱动,欢迎在GitHub issue跟踪器提交安装方法描述或PR。
可通过在镜像中运行/usr/local/docker/share/drivers/hplip.sh安装hplip,之后需执行hp-plugin并接受许可协议以完成完整安装。
可通过运行/usr/local/docker/share/drivers/foomatic.sh安装foomatic,该脚本仅安装foomatic-filters和foomatic-db-filters。若需安装foomatic-db和foomatic-db-nonfree,需后续运行/usr/local/docker/share/drivers/foomatic-db.sh。未来在测试并确认foomatic-filters安装稳定后,可能会将其整合到主构建脚本中,并将三个db包合并为单个安装脚本。
/config该卷包含以下子目录:
/config/etc
存储CUPS配置文件。
/config/log
存储日志文件。
/config/init.d(可选)
可选子目录,包含CUPS守护进程启动前需运行的脚本。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务
以下是 jacobalberty/cups 相关的常用 Docker 镜像,适用于 不同场景 等不同场景: