CUPS Web：轻松实现家用打印机网络化

什么是CUPS Web？

CUPS Web是一款专为家庭用户、个人工作室和小型办公环境设计的打印机管理工具。它允许用户通过浏览器直接上传文件并进行打印，无需通过远程桌面连接电脑。

界面预览

核心功能亮点

远程网页打印

通过浏览器即可完成文件上传与打印操作，不受设备和地点限制。

多格式文件支持

支持图片、PDF文件直接打印，并可将Office文档自动转换为PDF后打印。

基础安全认证

内置账号密码登录机制，避免打印机被未授权访问。

Docker一键部署

提供完整的docker-compose.yml配置，省去复杂环境搭建过程。

技术架构说明

• 打印服务：CUPS
• 后端语言：Go
• 前端框架：Vue.js

整体架构简洁清晰，专注于“稳定打印 + 轻量管理”。

使用Docker快速启动

项目已提供标准的Docker Compose配置文件，可直接用于部署。

环境变量准备

启动前需配置Session加密相关变量，用于登录态安全。

启动服务

在项目目录下执行：docker-compose up -d

服务启动完成后，即可通过浏览器访问网页打印界面。

使用建议与注意事项

• 根据实际打印机型号，在宿主系统中为CUPS安装对应驱动
• 如需使用Office文档转PDF功能，服务器需具备LibreOffice环境
• 官方提供的Web镜像已预装LibreOffice，可直接使用转换能力

项目地址

GitHub：https://github.com/hanxi/cups-web

适合哪些人使用？

• 想将家用打印机变成“随时可用”的网络打印设备
• 不希望折腾复杂企业级打印系统的个人用户
• 有Docker使用基础，希望快速部署实用工具的开发者
• 家庭或小型团队内部共享打印机的场景