Cups on Yang's Notes

在 Synology NAS 上通过 CUPS Docker 实现 AirPrint

yang@yhu.me (Yang Hu) — Wed, 11 Mar 2026 00:00:00 -0800

在 Synology NAS 上配置 AirPrint 的操作手册，让 iOS/macOS 设备可以通过局域网打印到 USB 或网络打印机。使用 Docker CUPS 容器和 Synology 内置的 avahi（mDNS）守护进程实现服务发现。

架构
#

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


iPhone
 │ mDNS 发现 (_ipp._tcp)
 ▼
Synology avahi-daemon（eth4，端口 5353）
 │ 从 /etc/avahi/services/ 读取服务文件
 │
CUPS Docker 容器（host 网络模式，端口 631）
 │ 生成 /etc/avahi/services/AirPrint-*.service
 │ 将打印任务代理到打印机
 ▼
打印机（如 socket://10.0.20.50:9100）

关键设计决策：