duanconsulting/docker-cups-airprint

duanconsulting/docker-cups-airprint

镜像概述

本镜像基于Ubuntu系统，运行CUPS服务并作为AirPrint中继，旨在解决网络中不支持AirPrint协议的打印机无法被苹果设备发现的问题。特别适用于Synology NAS用户，可替代NAS内置的CUPS服务（当内置服务无法正常工作时），同时利用Avahi实现打印机的网络广告。

核心功能

1. 运行CUPS服务，提供打印机管理接口
2. 作为AirPrint中继，将非AirPrint打印机转换为支持AirPrint的设备
3. 利用Avahi协议在网络中广播打印机信息
4. 支持配置持久化存储，确保打印机设置不丢失

使用场景

• Synology NAS用户：当NAS内置CUPS服务无法兼容现有打印机时
• 家庭/小型办公网络：让旧款打印机支持苹果设备的AirPrint功能
• 需要统一管理网络打印机的场景

配置说明

卷映射

• /config：存储持久化的打印机配置文件
• /services：生成Avahi服务文件的目录（需映射到NAS的/etc/avahi/services以生效）

环境变量

• CUPSADMIN：CUPS管理员用户名（需自定义）
• CUPSPASSWORD：CUPS管理员密码（需自定义）

端口暴露

• 631：CUPS服务的TCP端口，必须暴露以访问管理界面

部署示例

Docker Run命令

bash
docker run -d \
  --name cups-airprint \
  -p 631:631 \
  -v /your/local/config:/config \
  -v /your/local/services:/services \
  -e CUPSADMIN=admin \
  -e CUPSPASSWORD=your_secure_password \
  duanconsulting/docker-cups-airprint

Docker Compose配置

yaml
version: "3"
services:
  cups-airprint:
    image: duanconsulting/docker-cups-airprint
    container_name: cups-airprint
    ports:
      - "631:631"
    volumes:
      - ./config:/config
      - ./services:/services
    environment:
      - CUPSADMIN=admin
      - CUPSPASSWORD=your_secure_password
    restart: unless-stopped

使用说明

1. 访问http://[设备IP]:631进入CUPS管理界面，使用配置的用户名和密码进行管理
2. 若/services卷未直接映射到NAS的/etc/avahi/services，需手动复制生成的.service文件到该路径
3. 修改打印机配置后，需等待片刻让CUPS写入printers.conf并更新服务文件，避免立即停止容器导致配置丢失