
该镜像提供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 镜像,适用于 不同场景 等不同场景:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。




探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务