CUPS Web - 网页打印机

还在为远程打印文件而远程桌面连接家里的电脑？CUPS Web 是一个轻量级的网页打印机管理工具，让你只需打开浏览器，即可远程上传并打印任意文件，彻底告别繁琐操作。

✨ 核心功能

• 远程打印：通过网页上传文件，直接发送至家中/办公室的物理打印机；
• 多格式支持：
  • 原生支持：PDF、JPG、PNG 等常见格式；
  • 自动转换：Word (docx)、Excel (xlsx)、PPT (pptx) 等 Office 文档通过 LibreOffice 自动转为 PDF 后打印；
• 基础安全：简单的用户名+密码登录，防止未授权访问；
• 一键部署：基于 Docker，5 分钟完成安装与配置。

🛠️ 技术架构

快速部署（Docker Compose）

1. 配置环境变量

在项目目录中编辑 docker-compose.yml，设置以下关键参数：

environment:
  - USERNAME=your_print_user
  - PASSWORD=your_strong_password
  - SESSION_HASH_KEY=...    # 32位随机密钥
  - SESSION_BLOCK_KEY=...   # 32位随机密钥

生成加密密钥（在终端执行）：

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

将输出结果分别填入 SESSION_HASH_KEY 和 SESSION_BLOCK_KEY。

💡 提示：这两个密钥用于加密用户会话，务必保密且唯一。

2. 启动服务

docker-compose up -d

服务将在后台运行，默认端口 8080。

3. 访问与使用

浏览器打开 http://你的服务器IP:8080，登录后即可上传文件并选择打印机队列进行打印。

⚠️ 注意事项

• 打印机驱动：
  CUPS 依赖正确安装的打印机驱动。建议在宿主机或容器中提前安装对应型号的 PPD 驱动，以确保最佳兼容性。
• Office 转换依赖：
  本项目使用的镜像 hanxi/cups-web 已预装 LibreOffice，无需额外配置。若使用自定义镜像，请确保 LibreOffice 已安装。
• 网络与权限：
  • 确保服务器防火墙开放 8080 端口；
  • 若打印机通过 USB 连接，需将设备挂载至容器（可在 docker-compose.yml 中配置 devices）。

💡 适用场景

• 家庭用户：出差时远程打印孩子作业、合同文件；
• SOHO 办公室：无需共享打印机权限，通过网页安全提交打印任务；
• 技术爱好者：作为家庭服务器生态的一部分，集成到现有自建服务中。