?️ 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 使用基础，希望快速部署 实用工具 的 开发 者
- 家庭或小型 团队 内部共享打印机的场景
夸克资源精选合集
评论列表
发表评论