盘天下 | 免费精选资源分享

?️ 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 使用基础，希望快速部署 实用工具 的 开发 者
• 家庭或小型 团队 内部共享打印机的场景

夸克资源精选合集