【OpenWrt / NAS 安装 CUPS 打印服务全教程】Docker 搭建全屋无线打印服务器，老旧打印机秒变网络共享

孩子开学打印作业还要先开台式电脑？手把手教你在 24 小时开机的 OpenWrt 软路由或群晖 NAS 上通过 Docker 一键部署 CUPS 打印服务器，支持手机与全屋电脑随时无线打印。

## 教程简介

家里老旧的 USB 打印机如果通过 Windows 电脑共享到局域网，每次手机或另一台笔记本想打印文件都必须先把那台主机开机。如果你家里有长期开机的 **OpenWrt 软路由** 或 **群晖/飞牛 NAS**，只需通过 Docker 部署 **CUPS 无线打印服务**，即可让老打印机秒变全屋 24 小时待命的 AirPrint / 局域网无线打印机。

## 一、SSH 一键部署 CUPS 容器

将打印机通过 USB 连接到你的 OpenWrt 软路由或 NAS（OpenWrt 需确保已安装 USB 打印支持组件并能在后台识别到打印机型号），使用 SSH 登录设备执行以下命令：

```bash
docker run -d   --name cups   --restart unless-stopped   --net host   --privileged   -v /var/run/dbus:/var/run/dbus   -v /dev/bus/usb:/dev/bus/usb   -e CUPSADMIN=admin   -e CUPSPASSWORD=admin   olbat/cupsd:latest
```

> **提示**：如果拉取镜像缓慢或超时，请先确保软路由自身开启了代理或配置了可用的 Docker 镜像加速源。

## 二、进入 CUPS Web 后台添加打印机与驱动

1. 浏览器访问 `https://你的设备IP:631`（注意系统会跳转到 **HTTPS** 协议，点击高级继续访问）。
2. 点击顶部导航栏 **`Administration` → `Add Printer`**，输入默认管理员账号密码 `admin` / `admin`。
3. 在 `Local Printers` 下勾选识别到的 USB 打印机型号点击 Continue，**务必勾选 `Share This Printer`（共享此打印机）**。
4. **选择或上传 `.ppd` 驱动文件**：
   - 如果列表中直接有你的打印机型号（带 `CUPS` 标识），直接选中添加即可；
   - 如果列表没有你的型号，可在驱动库中按品牌搜索下载对应的 `.ppd` 驱动文件，点击 **`Or Provide a PPD File`** 上传即可完成添加，并可在网页端点击 `Print Test Page` 打印测试页。

## 三、电脑与手机无线打印连接

- **Windows 电脑**：打开「设置 → 蓝牙和其他设备 → 打印机和扫描仪 → 添加设备」，系统会自动发现局域网内的 CUPS 共享打印机，点击添加即可自动装好驱动。
- **安卓 / 苹果手机**：打开相册或文档点击「分享 → 打印」，即可直接搜到刚添加的无线打印机并选定纸张尺寸一键打印！