实用Docker推荐 #绿联NAS #部署docker-cups实现打印机共享

在NAS上通过Docker部署CUPS打印服务，可以让老旧打印机（无网络功能or仅局域网打印功能）变身网络打印机，实现无线&远程打印。
本文将分享完整的部署流程和配置要点。


1准备工作

首先确保NAS已启动Docker套件，并将打印机通过USB连接到NAS，或者与NAS同处于一个局域网。建议在Docker文件夹下新建cups目录，用于存放配置文件和持久化数据。
镜像选择

推荐使用ydkn/cups镜像，该镜像更新频繁、驱动完善，支持AirPrint隔空打印功能。相比其他镜像，ydkn/cups内置了Avahi服务，可以让手机和电脑自动发现打印机，无需手动填写IP地址。


2Docker Compose配置

使用Docker Compose部署是最便捷的方式。以下是一个完整的配置示例：

1. version: '3.8'
   
2. services:
   
3.   cups:
   
4.     image: ydkn/cups:latest
   
5.     container_name: cups
   
6.     network_mode: host
   
7.     privileged: true
   
8.     restart: unless-stopped
   
9.     ports:
   
10.       - "631:631"
    
11.     volumes:
    
12.       - /var/run/dbus:/var/run/dbus
    
13.       - ./config:/etc/cups
    
14.       - ./services:/services
    
15.     devices:
    
16.       - /dev/bus:/dev/bus
    
17.       - /dev/usb:/dev/usb
    
18.     environment:
    
19.       - CUPSADMIN=admin
    
20.       - CUPSPASSWORD=admin
    
21.       - TZ=Asia/Shanghai

复制代码

3关键配置说明：

• network_mode: host：使用主机网络模式，这是AirPrint多播发现协议的必要条件
  
• privileged: true：赋予容器访问USB设备的权限
  
• 端口631映射：CUPS管理界面默认端口
  
• 卷挂载：持久化配置文件和Avahi服务文件
  
  
  

4部署与配置

• 启动容器：直接容器界面启动
• 访问管理界面：浏览器访问http://NAS_IP:631，使用admin/admin登录
• 添加打印机：在Administration → Add Printer中添加USB打印机，选择对应型号驱动
  
• 共享设置：务必勾选"共享此打印机"选项
  

5客户端连接

• Windows：控制面板 → 设备和打印机 → 添加打印机 → 按名称选择共享打印机，输入http://NAS_IP:631/printers/打印机名称
  
• macOS/iOS：设备会自动发现AirPrint打印机，无需手动配置
  
• Android：使用手机自带打印服务或第三方打印APP
  
  
  

6常见问题处理

端口冲突：如果631端口被占用，使用netstat -tuln检查占用进程，或修改容器映射端口为其他端口。
手机无法发现打印机：确保使用ydkn/cups镜像，该镜像内置Avahi服务支持自动发现。如果使用其他镜像可能缺少此功能。
打印机驱动缺失：如果CUPS未识别打印机型号，可尝试选择Generic → PostScript Printer通用驱动，或手动安装PPD驱动文件。


通过以上配置，你的NAS就能成为家庭打印服务器，让所有设备都能无线打印，特别适合有孩子的家庭，老师发的作业图片可以直接从手机打印，省去转存电脑的麻烦。

都识别不到打印机？怎么回事？

VNfdVJ 发表于 2026-1-10 09:18
都识别不到打印机？怎么回事？

什么打印机呢？

不错

无法用host模式，怎么办？

Qirinstudio 发表于 2026-1-22 12:21
无法用host模式，怎么办？

可以改成host，加个631的端口号吧

请问怎么确定Avahi服务文件？我在windows里面已经搞好了，但是Mac里面怎么都找不到打印机

都设置好了，电脑也发现打印机了，点了打印没反应

大佬  我现在cups已经部署好了  win端也能手动输入地址识别到打印机也能打印 但是mac无法识别 手机端也找不到  这怎么搞哇，是哪里出了问题？

zC2Hgw 发表于 2026-2-21 17:26
大佬  我现在cups已经部署好了  win端也能手动输入地址识别到打印机也能打印 但是mac无法识别 手机端也找不 ...

检查并启用CUPS的Bonjour广播
登录CUPS的管理界面（通常是 http://[CUPS服务器IP]:631）。
进入 Administration​ -> Advanced。
找到 “Share printers connected to this system”​ 和 “Advertise shared printers locally”​ 选项，确保它们都被勾选。
更重要的是，找到 “Browse Web Interface”​ 或 “Browse protocols”​ 选项，确保 dnssd(Bonjour)​ 在已启用的协议列表中。如果没有，请启用它。
保存设置后，重启CUPS服务