CUPS Web：把家用 USB 打印机变成随时可访问的网络打印服务

🖨️ CUPS Web 是什么？

CUPS Web 是一个基于浏览器的网页打印机管理工具，目标很明确：让原本只能本地使用的家用 USB 打印机，变成随时可访问的网络打印服务。无需再通过远程桌面连接家里的电脑，只要打开浏览器，就能直接上传文件并完成打印。

它适用于家庭用户、个人工作室、小型办公环境，在保证部署简单的前提下，提供了足够实用的打印能力与基础安全防护。

📸界面预览

登录认证	打印机列表
文件上传	打印任务

🌐 核心功能亮点

远程网页打印

通过浏览器即可完成文件上传与打印操作，不受设备和地点限制，电脑、平板等均可使用。

多格式文件支持

支持图片、PDF 文件直接打印，并可将 Office 文档（docx、xlsx、ppt 等）自动转换为 PDF 后再打印。文档转换能力基于 LibreOffice 实现，兼顾兼容性与稳定性。

基础安全认证

内置账号密码登录机制，避免打印机被未授权访问，满足家庭与内部网络使用的安全需求。

Docker 一键部署

提供完整的 docker-compose.yml 配置，省去复杂环境搭建过程，新手也能快速上手。

🛠️ 技术架构说明

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

整体架构简洁清晰，专注于“稳定打印 + 轻量管理”，不引入多余复杂组件，适合长期运行。

🚀 使用 Docker 快速启动

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

环境变量准备

启动前需配置 Session 加密相关变量，用于登录态安全。可通过以下命令生成随机密钥：

openssl rand -base64 32 | tr -d '\n'

启动服务

在项目目录下执行：

docker-compose up -d

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

⚠️ 使用建议与注意事项

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

🔗 项目地址

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

📌 适合哪些人使用？

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