yaurora/cups-google-airprint

cups-google-airprint 镜像文档

镜像概述

cups-google-airprint 是一个基于 phusion/baseimage master 镜像构建的 Docker 镜像，集成了 CUPS 打印服务，并启用了 Google 云打印（Google Cloud Print）和 AirPrint 功能，支持 HP 及多种其他品牌打印机。该镜像支持多架构（amd64/armv7/arm64），可在多种设备上部署使用。

核心功能与特性

• 多打印协议支持：同时支持 Google 云打印和 AirPrint，满足网络打印需求
• 多架构支持：通过 Docker manifest 实现对 amd64、armv7 和 arm64 架构的支持，适应不同硬件环境
• 设备兼容性：支持 HP 及多种其他品牌打印机
• 配置持久化：可通过卷挂载实现配置文件持久化，方便自定义设置
• 灵活部署：支持 host 网络模式和 bridge 网络模式，适应不同网络环境

更新日志

• 2022年3月17日：添加 Docker manifest，实现单一镜像支持多架构（amd64/armv7/arm64），最新标签 latest 已支持这些架构

使用场景

• 家庭或小型办公环境中实现跨设备打印（如手机、平板、电脑通过 AirPrint 或 Google 云打印连接打印机）
• Synology NAS 设备上部署，替代系统自带 CUPS 服务，提供更灵活的打印功能
• 嵌入式设备（如 arm64 开发板）上构建轻量级打印服务器

使用方法

前置要求

• 网络模式：推荐使用 host 网络模式（--net="host"），以确保 GCP 和 Avahi 正常工作
• 特权模式：需要启用特权模式（--privileged="true"）
• 设备挂载：需挂载 USB 总线设备（/dev/bus/usb:/dev/bus/usb）以支持 USB 连接的打印机

Synology 用户特别说明

由于 Synology 系统自带 CUPS 服务且会随系统启动自动运行，需先禁用系统自带 CUPS 服务，否则会与容器内 CUPS 服务冲突：

1. 停止并禁用 CUPS 服务：

   shell
   synoservice --hard-disable cupsd
   synoservice --hard-disable cups-lpd
   synoservicecfg --hard-disable cupsd
   synoservicecfg --hard-disable cups-lpd
   synoservicectl --stop cups-lpd
   synoservicectl --stop cupsd
   

2. 修改启动配置文件： 使用 root 权限编辑 /usr/share/init/cups-service-handler.conf，确保以下三行被注释：

   shell
   if [ ${PRINTER_NUM} -gt 0 ]; then
           #echo "Printer exist. Start cupsd and cups-lpd." || true
           #/usr/syno/sbin/synoservice --start cupsd || true
           #/usr/syno/sbin/synoservice --start cups-lpd || true
   fi
   

3. 启用 Bonjour 服务发现：在 Synology 系统中启用“Bonjour 服务发现 --> 通过 Bonjour 共享打印机”

Google 云打印模式配置

默认情况下，镜像仅启用本地打印模式（local_printing_enable: true），可通过修改配置文件启用云打印模式：

1. 配置文件路径：容器内路径为 /config/gcp/gcp-cups-connector.config.json，若挂载了本地配置目录（如 /volume1/docker/airprint/config），则文件位于本地目录的 gcp 子目录下

2. 修改配置：将配置文件中的 cloud_printing_enable 设为 true：

   json
   { "local_printing_enable": true, "cloud_printing_enable": true, "log_level": "INFO", "log_file_name": "/tmp/cloud-print-connector" }
   

3. 重启容器：修改配置后需重启容器使设置生效

Docker 部署示例

1. 使用 host 网络模式（推荐）

shell
docker run -d --name="airprint" \
--restart=always \
--net="host" --privileged="true" \
-e CUPS_USER_ADMIN=cupsadmin \
-e CUPS_USER_PASSWORD=password \
-v /volume1/docker/airprint/config:/config \
-v /dev/bus/usb:/dev/bus/usb \
yaurora/cups-google-airprint:latest

2. 使用 bridge 网络模式（需手动暴露端口）

shell
docker run -d --name="airprint" \
--restart=always \
--net="bridge" --privileged="true" \
-p 631:631 \
-p 5353:5353 \
-e CUPS_USER_ADMIN=cupsadmin \
-e CUPS_USER_PASSWORD=password \
-v /volume1/docker/airprint/config:/config \
-v /dev/bus/usb:/dev/bus/usb \
yaurora/cups-google-airprint:latest

3. 解决端口冲突（修改 CUPS 端口）

若 631 端口被占用，可修改映射端口（如使用 632 端口）：

shell
docker run -d --name="airprint" \
--restart=always \
--net="bridge" --privileged="true" \
-p 632:631 \
-p 5353:5353 \
-e CUPS_USER_ADMIN=cupsadmin \
-e CUPS_USER_PASSWORD=password \
-v /volume1/docker/airprint/config:/config \
-v /dev/bus/usb:/dev/bus/usb \
yaurora/cups-google-airprint:latest

环境变量说明

项目源码

https://github.com/yaurora/cups-google-airprint