pfakanator/unraid_airprint

镜像概述

该Docker镜像基于Ubuntu系统运行CUPS实例，主要用于提供AirPrint服务，支持苹果设备（如iPhone、iPad）通过无线方式打印。镜像基于quadportnick/docker-cups-airprint项目开发，采用host网络模式简化端口穿透，也可手动映射端口（不推荐混合使用）。

核心功能

• 运行CUPS打印服务，兼容标准打印协议
• 提供AirPrint功能，满足苹果设备无线打印需求
• 生成Avahi服务文件，实现网络服务发现
• 支持持久化存储打印机配置及服务文件
• 通过环境变量配置管理员账户及密码

使用场景

• Unraid系统中为苹果设备提供无线打印服务
• 家庭/小型办公环境跨设备无线打印场景
• 需要统一管理打印机配置的场景

配置说明

环境变量

• PUID: 运行服务的用户ID（默认1000）
• PGID: 运行服务的用户组ID（默认1000）
• TZ: 时区设置（如Asia/Shanghai）
• CUPSADMIN: 可选，CUPS管理员用户名
• CUPSPASSWORD: 可选，CUPS管理员密码

卷映射

• /config: 存储打印机持久化配置
• /services: 存储生成的Avahi服务文件
• /var/run/dbus: 映射DBus服务以支持Avahi

部署示例

Docker Compose

yaml
airprint:
  image: pfakanator/unraid_airprint:latest
  container_name: airprint
  network_mode: host
  environment:
    - PUID=1000
    - PGID=1000
    - TZ=Asia/Shanghai
    - CUPSADMIN=admin  # 可选
    - CUPSPASSWORD=your_password  # 可选
  volumes:
    - /path/to/airprint/services:/services
    - /path/to/airprint/config:/config
    - /var/run/dbus:/var/run/dbus
  restart: unless-stopped

Docker Create命令

bash
docker create \
  --name=airprint \
  --restart=always \
  --net=host \
  -v /path/to/airprint/config:/config \
  -v /path/to/airprint/services:/services \
  -e CUPSADMIN="admin" \
  -e CUPSPASSWORD="your_password" \
  pfakanator/unraid_airprint

启动容器：

bash
docker start airprint

停止容器：

bash
docker stop airprint

删除容器：

bash
docker rm airprint

使用说明

CUPS管理界面可通过http://localhost:631访问，执行管理操作需输入配置的CUPSADMIN和CUPSPASSWORD。注意：CUPS不会立即写入printers.conf，修改配置后需等待片刻让服务文件更新，避免立即停止容器导致配置丢失。