CUPS Web

CUPS Web是一款开源的网页版打印管理系统。它在CUPS（Linux标准打印系统）基础上，提供了现代化的Web界面，支持通过浏览器上传文件并远程打印。项目采用Docker一键部署，适合家庭、SOHO和小团队使用。核心目标是让打印机从“本地设备”变成“随时可用”的网络服务。

核心功能

• 多格式支持：兼容PDF、图片（JPG/PNG/GIF/HEIC）、Office文档（Word/Excel/PPT）、OFD格式、纯文本等。
• 自动格式转换：Office文件通过LibreOffice转PDF，OFD通过内置转换器处理，图片支持多张合并打印。
• 丰富打印选项：份数、单双面、彩色/黑白、纸张大小、页码范围、缩放、镜像等。
• 实时预览：上传后可预览PDF效果和纸张布局。
• 多用户管理：支持admin和普通用户角色，记录每次打印日志。
• 打印记录追踪：管理员可查看历史记录、按条件过滤、下载原始文件。

CUPS Web 网站截图

技术特色

• 后端：Go语言开发，使用SQLite数据库，轻量高效。
• 前端：Vue 3 + Nuxt UI + Tailwind CSS，界面现代简洁。
• 打印核心：集成CUPS + 丰富驱动支持（HP、Epson、Brother、Canon等主流品牌）。
• 部署友好：提供完整Docker镜像和docker-compose.yml，一键启动CUPS+Web服务。
• 安全设计：Session认证、CSRF防护、密码bcrypt加密。

适用场景

• 家庭多设备共享打印机（手机、电脑、平板均可打印）。
• 小型办公室远程打印需求。
• 需要打印OFD格式文件的用户（常见于电子发票、政务文件）。
• 追求数据本地化、不想依赖云打印服务的用户。

部署与使用教程

推荐Docker部署（最简单）：

1. 下载项目中的docker-compose.yml文件。
2. 创建.env文件配置CUPS管理员账号密码。
3. 执行docker-compose up -d启动服务。
4. 访问官网 使用默认admin/admin登录（首次建议修改密码）。
5. 在CUPS管理界面（端口631）添加并共享打印机。

打印流程： 上传文件 → 选择打印机 → 调整参数 → 预览 → 提交打印。

支持ARM设备（树莓派等），兼容多种架构。

优缺点

优点：部署简单、支持格式全、驱动丰富、界面友好、完全本地化、开源免费、多用户管理实用。 缺点：依赖CUPS和Docker环境，初次配置打印机需一定操作；OFD转换在非Docker部署时需额外配置。

用户评价

项目上线后获得开源社区关注，用户反馈部署后“终于实现了手机远程打印”“OFD支持很实用”“家庭打印共享方便多了”。界面简洁、转换成功率高是主要好评点，适合有一定动手能力的用户。

总结

CUPS Web 为家用和小型办公打印机提供了现代化Web解决方案。它把传统USB打印机升级为支持远程、多人、跨设备使用的网络打印服务，极大提升了打印便利性。项目持续更新，驱动支持丰富，是自建打印服务的优秀开源选择。