
如果你使用 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 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本镜像基于https://hub.docker.com/_/debian%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%AE%89%E8%A3%85%E4%BA%86CUPS%E6%89%93%E5%8D%B0%E7%B3%BB%E7%BB%9F%EF%BC%8C%E5%90%AF%E7%94%A8Apple AirPrint和Google Cloud Print Connector,并支持Canon UFR II(UFR2)驱动。
CUPS是一款开源打印系统,支持IPP及其他协议,更多信息可访问cups.org。
本镜像安装了CUPS v2.2.1,构建了最新版本的Google Cloud Print Connector(上次发布时为1.16),并安装了v3.7.0版本的Canon UFR II驱动。AirPrint配置通过Timothy J Fontaine创建的脚本实现。
适用于家庭或小型办公环境,需要为苹果设备(AirPrint)、云设备(Google Cloud Print)及使用Canon UFR II驱动的打印机提供统一打印支持的场景。
bashdocker run -rm -d -e CUPS_USER_ADMIN=admin -e CUPS_USER_PASSWORD=secr3t \ --name cups-ufrii --hostname cups \ -p 137:137/udp -p 139:139/tcp -p 445:445/tcp -p 631:631/tcp -p 5353:5353/udp \ -v /share/docker/cups/config:/etc/cups/:rw \ -v /share/docker/cups/logs:/var/log/cups:rw \ -v /share/docker/cups/cpc:/etc/cloud-print-connector:rw \ docker.xuanyuan.run/jakbutler/ufrii-airprint:2.0.0
yamlversion: "3" services: cups: container_name: cups-ufrii hostname: cups image: docker.xuanyuan.run/jakbutler/ufrii-airprint:2.0.0 restart: unless-stopped environment: CUPS_USER_ADMIN: admin CUPS_USER_PASSWORD: secr3t volumes: - /share/docker/cups/config:/etc/cups/:rw - /share/docker/cups/logs:/var/log/cups:rw - /share/docker/cups/cpc:/etc/cloud-print-connector:rw ports: - 137:137/udp - 139:139/tcp - 445:445/tcp - 631:631/tcp - 5353:5353/udp
参数由冒号分隔为两部分,左侧为宿主机端,右侧为容器端。例如-v external:internal表示将容器内的internal目录映射到宿主机的external目录。
环境变量
| 变量名 | 描述 | 默认值 |
|---|---|---|
TZ | 容器使用的时区,有助于日志时间查看 | America/Los_Angeles |
CUPS_USER_ADMIN | CUPS web界面基础认证的用户名 | admin |
CUPS_USER_PASSWORD | CUPS web界面基础认证的密码,强烈建议修改默认值 | secr3t |
CANON_DRIVER_URL | Canon UFRII驱动的下载地址 | http://gdlp01.c-wss.com/gds/8/0100007658/08/linux-UFRII-drv-v370-uken-05.tar.gz |
CUPS_ENV_DEBUG | 是否启用调试输出(0/1),启用后会输出更多信息到stdout | 0 |
共享卷
| 卷路径 | 描述 |
|---|---|
/etc/cups/ | (必填)存储CUPS配置的本地目录,用于保存自定义打印机配置 |
/var/log/cups | (可选)存储CUPS日志的本地目录 |
/etc/cloud-print-connector | (必填)存储Google Cloud Print Connector配置文件的本地目录 |
bashdocker exec -it cups-ufrii /bin/bash
bashcd /etc/cloud-print-connector /opt/cloud-print-connector/gcp-connector-util init
注意:必须将容器内的/etc/cloud-print-connector目录映射到宿主机本地目录,以确保配置文件在重启后保留。
在unRaid上,从Community Repositories安装,输入所需的文件夹路径即可。
在QNAP上,通过ContainerStation的创建容器页面安装:搜索ufrii,选择Docker Hub中的镜像,点击创建。指定名称,设置命令为/root/start-cups.sh,调整CPU和内存限制,然后进入高级设置指定环境变量和卷映射,最后点击创建。
注意:由于QNAP自身运行CUPS和avahi实例,建议将容器网络设置为Bridge模式,并分配到与主网络不同的适配器/虚拟交换机。
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。
来自真实用户的反馈,见证轩辕镜像的优质服务