tigerj/cups-airprint

已归档

目前该仓库将不再更新。有关特定使用场景的可能解决方案，请查看_forks_。

目录

• 关于
• 简介
• 多架构镜像
• 快速开始
  • Docker Run
  • Docker Create
    • 参数说明
  • Docker Compose
  • Docker Build
• 使用方法
• 注意事项
• 故障排除
  • 缺少打印机驱动
  • 驱动版本问题

关于

源代码修改自：https://github.com/quadportnick/docker-cups-airprint

简介

此基于Ubuntu的Docker镜像运行CUPS实例，旨在作为AirPrint中继，适用于已接入网络但不支持AirPrint的打印机。本地Avahi将用于在网络上广播打印机。

多架构镜像

以下命令引用位于https://hub.docker.com/r/tigerj/cups-airprint的https://docs.docker.com/engine/reference/commandline/manifest/，该镜像使用Docker的https://docs.docker.com/develop/develop-images/build_enhancements/构建。直接运行使用此镜像的命令将根据主机架构拉取匹配的镜像架构（如`amd64`、`arm32v7`或`arm64`）。因此，无论是在传统`amd64`桌面/笔记本电脑还是**树莓派**上，以下命令均适用。**注意**：由于该镜像以`ubuntu`为基础镜像，目前不提供`arm32v6`架构，这意味着如果目标硬件是**树莓派Zero**或类似`arm 6`架构设备，此镜像无法运行。

快速开始

本节概述运行tigerj/cups-airprint Docker镜像容器所需的基本选项/参数。

Docker Run

快速运行cups/airprint容器：

$ docker run \
       -d \
       --name=cups \
       --net=host \
       -v /var/run/dbus:/var/run/dbus \
       --device /dev/bus \
       --device /dev/usb \
       -e CUPSADMIN="admin" \
       -e CUPSPASSWORD="password" \
       tigerj/cups-airprint

停止容器：

$ docker stop cups

删除容器：

$ docker rm cups

警告：删除容器（如示例中的cups）将永久删除docker volume存储的数据。如果需要永久保存数据，请参见下方的docker create示例。更多关于Docker卷的详情，请阅读注意事项部分。

• 注意：Dockerfile明确在/config和/services设置了卷（参见https://github.com/RagingTiger/docker-cups-airprint/blob/2a30b6690a08262fb64375b74f07ab7b3f77ec4a/Dockerfile#L16-L17）。`docker container的必要配置将存储在这些目录中，即使容器停止也会保留。Docker会将这些容器内目录的内容存储在/var/lib/docker/volumes`（参考https://docs.docker.com/storage/volumes/）。

Docker Create

创建容器通常比直接运行更可取：

$ docker create \
       --name=cups \
       --restart=always \
       --net=host \
       -v /var/run/dbus:/var/run/dbus \
       -v ~/airprint_data/config:/config \
       -v ~/airprint_data/services:/services \
       --device /dev/bus \
       --device /dev/usb \
       -e CUPSADMIN="admin" \
       -e CUPSPASSWORD="password" \
       tigerj/cups-airprint

然后运行docker start启动cups/airprint打印机：

$ docker start cups

停止容器：

$ docker stop cups

删除容器：

$ docker rm cups

• 注意：如Run部分的注意所述，Dockerfile在容器内明确声明了/config和/services两个卷作为挂载点。此处我们覆盖了Docker默认的卷管理系统，在主机系统上声明了自己的路径来挂载/config和/services目录。这样做的原因是：如果容器因任何原因被删除，数据仍会保留。示例中将内部/config和/services目录分别挂载到~/airprint_data/config和~/airprint_data/services，但也可挂载到文件系统的任何位置。

参数说明

• --name：为容器指定名称，便于操作（如示例中的cups）
• --restart：容器重启策略（如always表示始终重启）
• --net：加入的网络（如host网络）
• -v ~/airprint_data/config:/config：持久化打印机配置的存储位置
• -v ~/airprint_data/services:/services：Avahi服务文件的生成位置
• -e CUPSADMIN：要创建的CUPS管理员用户
• -e CUPSPASSWORD：CUPS管理员用户的密码
• --device /dev/bus：用于与USB打印机交互的设备挂载
• --device /dev/usb：用于与USB打印机交互的设备挂载

Docker Compose

如果不想输入冗长的Docker命令，可使用https://docs.docker.com/compose/设置镜像。只需克隆仓库并运行：

$ git clone https://github.com/RagingTiger/docker-cups-airprint
$ cd docker-cups-airprint
$ docker-compose up

注意：此compose文件针对USB打印机设计，包含USB打印机的device挂载。如果没有USB打印机，可将这些配置注释掉。config/services数据将保存到用户的$HOME目录，也可根据需要修改。

Docker Build

如果要本地构建镜像，克隆仓库并运行docker build命令：

$ git clone https://github.com/RagingTiger/docker-cups-airprint
$ cd docker-cups-airprint
$ docker build -t tigerj/cups-airprint .

之后通过docker run或docker create部署容器，cups-airprint服务器即可配置并使用。

使用方法

可通过http://localhost:631配置CUPS，执行管理操作时需使用CUPSADMIN/CUPSPASSWORD。

如果/services卷未映射到/etc/avahi/services，需通过命令行手动将.service文件复制到该路径。

注意事项

• CUPS在进行更改时不会立即写入printers.conf，尽管更改在CUPS中已生效。因此服务文件更新需要几分钟时间。
• 若要保留持久配置，不要立即停止容器，原因同上。

故障排除

本节讨论用户在设置和配置打印机以使用tigerj/cups-airprint镜像时最常见的问题。

缺少打印机驱动

这是用户设置打印机时最常见的问题。尽管tigerj/cups-airprint镜像包含多个打印机驱动，但很可能不包含所有打印机的驱动。解决方法如下：

• 确定所需的打印机驱动，提交关于缺少驱动的issue，包含该驱动的必要包将被添加到Dockerfile。

驱动版本问题

有时tigerj/cups-airprint Docker镜像中已安装正确的打印机驱动，但版本不是最新的。此问题可通过以下两种方式解决：

• 克隆docker-cups-airprint git仓库并构建新镜像

  • 这将从包管理器拉取最新版本的打印机驱动。

• 直接从制造商下载驱动并添加到镜像

  • 如果构建新镜像无法更新驱动版本，则需要从制造商获取最新的打印机驱动。