hanxi/cups-web：README に基づく導入ガイド

hanxi/cups-web の README はプロジェクトを「把家用 USB 打印机变成随时可访问的网络打印服务」と説明しています。ここではリポジトリで確認できる事実だけを整理します。star 数やバッジは注目度の手掛かりであり、品質の証明ではありません。「🖨️ CUPS Web , 网页打印管理」には次の説明があります。基于 CUPS 的网页版打印管理工具。通过浏览器上传文件、远程提交打印任务，支持多用户管理与打印记录追踪，适合家庭和小型办公室使用。。これは範囲の説明であり、本番検証の結果ではありません。

README の「打印能力」にある内容から、用途が合うかを先に判断できます。自动转换：Office 文档通过 LibreOffice 转 PDF；OFD 通过内置 Java 转换器（基于 ofdrw）转 PDF；文本/图片在服务端渲染为 PDF。目的が違うなら、人気だけで採用する理由にはなりません。プロジェクト名やコマンドは原文のまま残し、一次資料へ戻って用語を確認できるようにしています。 README には次の確認可能な項目もあります。多格式支持：PDF、图片（JPG/PNG/GIF/HEIC）、Office 文档（doc/docx/xls/xlsx/ppt/pptx）、OFD、纯文本。初回テストの材料にはなりますが、実際の環境での確認を省略する理由にはなりません。

動作の説明は「打印机驱动」など複数の箇所に分かれています。確認できる情報は次の通りです。| 驱动 | 命令名 | 架构 | 适用机型 | | --- | --- | --- | --- | | Canon UFR II | canon-ufr2 | amd64 / arm64 | i-SENSYS LBP/MF、imageCLASS、imageRUNNER 等 | | Canon CAPT | canon-capt | 全架构 🔧 | LBP2900 / LBP2900B | | HP LaserJet 1020 固件 | hp-laserjet1020 |。書かれていない構成、性能、セキュリティを推測で補いません。導入時はディレクトリ、設定ファイル、release 履歴を確認してください。

初回導入は README の入口から始めます。確認できるコマンドは次の通りです。 # 查看可用驱动 docker exec cups driver-list # 安装驱动 docker exec cups driver-install canon-ufr2 # 查看已安装驱动 docker exec cups driver-list --installed # 卸载驱动 docker exec cups driver-remove canon-ufr2 実行可能なコマンドがない場合は手順を作らず、「📸 界面预览」で依存関係、待受ポート、初回設定を確認します。

日常運用は公式文書の範囲に限ります。「打印机驱动」には> 🔧 = 需要在容器内现场编译，耗时较长（几分钟到十几分钟，ARM 小主机更慢）。其他驱动是下载 + 解包安装，通常几十秒内完成。 > > Epson ESC/P-R 2 在 amd64 / armhf 上直接安装预编译包，在 arm64 上会回退到源码编译，也需要几分钟。 > > 「架构」列就是实际的硬限制：厂商没有提供对应架构的二进制时，Web 界面会把该驱动的「安装」按钮禁用并提示原因，不会让你点一个必然失败的按钮。とあります。設定、環境変数、権限、データ保存先は明記されたものだけを扱います。未記載の既定値は隔離環境で確認し、戻せる設定を保存してください。 同じ資料には打印选项：份数、单双面、彩色/黑白、纸张大小、纸张类型、页面方向、页码范围、缩放、镜像打印ともあります。