很多家庭/办公的普通老式打印机非常鸡肋，必须开电脑、装驱动、本地连接才能打印，极其不方便。今天给大家分享一套基于 NAS Docker 部署的开源打印方案，无需 APP、无需电脑、无需驱动，让普通打印机直接支持网页管理 + 微信远程云打印，随时随地即可打印文件。

本方案基于 CUPS 协议，兼容市面 95% 以上打印机，支持 IPP/IPPS 通用打印协议，部署简单、稳定性强。

一、项目介绍

本次整合两款优质开源镜像，实现完整打印服务：

• tzishue/cloud-printer：云打印核心服务，支持微信小程序远程打印，采用设备ID绑定+加密传输，支持图片、文档、文本多格式打印。
• hanxi/cups-web：可视化网页管理后台，支持文件拖拽上传、自动PDF转换、打印参数自定义、多用户管理、打印记录留存。

检测打印机是否支持IPP协议

局域网浏览器访问：http://打印机IP/ipp/print

页面返回 405 Method Not Allowed，即代表打印机支持 IPP 协议，可正常使用本方案。

二、前置准备（威联通NAS）

1、打开 NAS 文件管理器，进入默认 Docker 目录 /Container

2、新建文件夹 cups，并在内部创建5个子目录：

• uploads
• data
• cloud-printer-device-id
• cloud-printer-logs
• cloud-printer-cups

• ---

三、Docker Compose 部署配置

打开威联通【Container Station】-【应用程序】-【创建】，自定义应用名称，粘贴以下完整配置，验证通过后直接创建。

services:
  cups:
    image: tzishue/cloud-printer:latest
    container_name: cups
    ports:
      - "631:631"
    environment:
      - TZ=Asia/Shanghai
      - CUPS_ADMIN_PASSWORD=admin123
    volumes:
      - /share/Container/cups/cloud-printer-cups:/etc/cups
      - /share/Container/cups/cloud-printer-logs:/var/log/printer-client
      - /share/Container/cups/cloud-printer-device-id:/etc/printer-device-id-vol
    privileged: true
    restart: unless-stopped
  web:
    image: docker.1ms.run/hanxi/cups-web:latest
    container_name: cups-web
    user: root
    environment:
      - SESSION_HASH_KEY=Qm1u6pZqJq4u1z0mV4xq2lJHq7x8T9pQ2u3r5s7v9wA=
      - SESSION_BLOCK_KEY=Z4p8K2mQ9tR1sV6yB3nE7wL0dF5hJ2kP8rT4uY1oC6M=
      - SESSION_SECURE=false # 外网访问请改为true
      - CUPS_HOST=cups:631
    volumes:
      - /share/Container/cups/data:/data
      - /share/Container/cups/uploads:/uploads
    ports:
      - "1180:8080"
    depends_on:
      - cups
    restart: unless-stopped
volumes:
  cloud-printer-cups:
  cloud-printer-logs:
  cloud-printer-device-id:

部署说明：

1、631、1180 端口请勿与NAS其他服务冲突；

2、外网使用务必将 SESSION_SECURE 改为 true；

3、部署完成后，容器列表会显示 cups、cups-web 两个运行容器。

四、添加打印机（核心步骤）

方式一：CUPS 后台添加（推荐）

1、访问 CUPS 后台：http://NASIP:631

2、登录账号：root，密码：admin123

3、依次点击：Administration - Add Printer

4、协议选择：互联网打印协议（ipp）

5、填写打印机 IPP 地址：ipp://打印机IP/ipp

6、自定义打印机名称，勾选 Share This Printer 共享打印机

7、选择对应打印机品牌，无对应型号则选择 IPP Everywhere 通用驱动

8、默认 A4 纸张配置，点击 Set Default Options 完成添加

9、可点击 Print Test Page 打印测试页，验证是否正常工作。

方式二：微信小程序添加

1、查看 cups 容器日志，获取设备ID和绑定二维码；

2、微信搜索小程序【互维云+】；

3、添加设备，输入设备ID完成绑定，检测打印机即可使用。

五、功能体验

1、微信云打印

无需安装任何软件，手机微信即可远程打印，支持聊天记录文件、图片、文本、办公文档打印，内置海量学习、办公模板，还支持自助打印店铺功能。

2、网页端管理后台

访问地址：http://NASIP:1180

默认账号密码：admin / admin

核心功能：

• 拖拽上传 Word/Excel/PPT/PDF/图片，自动转PDF预览打印；
• 自定义黑白/彩色、双面、份数、纸张尺寸等参数；
• 多用户账号管理、打印记录查询、自动清理数据；
• 安全防护：CSRF防护、会话加密、密码加密存储。

• ---

六、总结

这套 NAS 打印方案，低成本改造传统普通打印机，完美解决老式打印机无法远程、依赖电脑、驱动繁琐的痛点。只需一台 NAS，即可实现全平台远程打印+可视化网页管理，家庭、小型办公场景都非常实用，简单易部署、零使用门槛。