在 Harmonica OS 上使用 CUPS 設定 USB 和網路印表機

在 Harmonica OS (HamoniKR) 系統中，首先開啟「印表機」應用程式：新增 USB 印表機或選擇已發現的網路印表機，如果裝置支持，請優先使用免驅動 IPP 模式。http://localhost:631需要檢查列印佇列、調整預設設定或手動新增裝置時，請使用 CUPS Web 介面。對於較舊的硬體或缺少特定於印表機的功能，廠商驅動程式是備用方案，並非首選步驟。

1. 選擇連線並檢查列印服務

CUPS（通用 UNIX 列印系統）管理列印佇列和列印作業。連線協定決定了是否可以在沒有驅動程式的情況下建立佇列、如何發現裝置以及您可以控制哪些設定。 HamoniKR 8.0 文件涵蓋了自動網路發現和該system-config-printer實用程式；特定的選單標籤可能因版本而異。

聯繫	非常合身	權衡
透過印表機使用 USB	一台印表機透過實體方式連接到一台電腦。	取決於本地設備檢測和相容的列印支援
無人駕駛IPP/IPP無所不在	受信任區域網路上的現代印表機	某些後製、會計或供應商特定的控制功能可能無法使用。
AppSocket / HP JetDirect	具有已知 IP 位址的傳統網路印表機	通常使用原始 TCP 連接埠 9100，不進行傳輸加密；需要合適的驅動程式。
製造商 PPD 或包裝	舊型號或關鍵專有功能	維護和相容性取決於供應商；PPD驅動程式正在被上游逐步淘汰。

安裝任何程式之前，請先連接印表機，如果印表機使用 Wi-Fi 或乙太網路連接，請檢查其顯示器上的 IP 位址，並確認電腦已連接到正確的網路。然後確認 CUPS 是否可用：

systemctl is-active cups
lpstat -r

如果服務處於非活動狀態，請使用以下命令啟動它sudo systemctl enable --now cups。如果未安裝 CUPS，請執行以下命令，sudo apt update然後執行sudo apt install cups；軟體包的可用性取決於您配置的 HamoniKR 儲存庫。請避免僅因未發現設備而更換正在使用的列印組件。

印表機設定窗口，未安裝任何印表機，並顯示一個藍色的「新增印表機」按鈕。 — 開啟印表機實用程序，選擇「新增印表機」開始設定本機佇列。

2. 在桌面實用程式中新增 USB 印表機

開啟應用程式選單，然後選擇「管理」>「印表機」或印表機設定面板，如 HamoniKR 指南中所述。您也可以打開終端機並執行命令system-config-printer。按一下“新增”並檢查本機裝置清單。對於 USB 設備，請選擇偵測到的確切型號，而不是名稱相似的無關型號。繼續選擇驅動程序，為佇列命名，然後套用配置。

「新增印表機」視窗列出了兩個 USB 設備，其中已選擇 HP DeskJet。 — USB 裝置清單會在選擇驅動程式和建立佇列之前識別本機印表機。

如果始終無法辨識 USB 設備，請嘗試使用網路線直接連接，而不是透過 USB 集線器，並檢查印表機是否已通電。 CUPS 無法透過選擇不同的網路協定來解決 USB 連線失敗的問題。只有在確認偵測到設備後，才能嘗試使用製造商提供的特定軟體包。

3. 優先選擇網路上已發現的IPP印表機

在「新增印表機」對話方塊中，開啟「網路印表機」或「尋找網路印表機」。如果發現具有免驅動 IPP 選項的設備，請選擇該連接並繼續。印表機將提供其支援的文件格式和選項，從而減少對特定型號 PPD 的依賴。對於相容的現代網路印表機而言，這通常是最簡單的選擇。

網路印表機發現清單（包含 IP 位址）和免驅動 IPP 連接 — 發現的網路設備無需手動輸入驅動程式檔案即可提供免驅動 IPP 連線。

發現印表機並不代表列印功能一定正常：無線用戶端隔離、訪客網路、組播 DNS 過濾或錯誤的子網路都可能導致印表機被隱藏。如果印表機可見但雙面列印、裝訂或色彩控制功能受限，請在更換驅動程式之前，先對照製造商文件檢查可用選項。 HamoniKR 8.0 印表機文件特別提醒，無驅動列印可能會導致某些製造商提供的功能無法使用。

4. 使用 CUPS Web 介面管理佇列

為了獲得更多控制權，請http://localhost:631在 HamoniKR 電腦上開啟 CUPS，選擇“管理”，然後按一下“新增印表機”。 CUPS 可能會要求您提供具有列印管理權限的帳戶憑證。選擇已發現的本機或網路設備，輸入簡短的佇列名稱，然後選擇適當的免驅動或特定型號選項。儲存前，請檢查預設設置，例如紙張尺寸。

CUPS 本機主機管理頁面顯示「新增印表機」和「管理印表機」控制項 — CUPS 提供了一個本機 Web 管理頁面，用於新增印表機和管理列印佇列。

網頁和桌面實用程式修改的是同一個底層列印系統；它們是兩種不同的操作方式，並非需要安裝的兩個獨立驅動程式。使用桌面工具進行日常設置，使用網頁介面查看佇列狀態、測試頁和印表機選項。 CUPS 在其OpenPrinting CUPS 管理文件中記錄了這些操作。除非您有專門設計的、安全的遠端管理方案，否則請將管理權限限制在本機上；不要僅僅為了新增印表機而將 631 連接埠開放給公共網路。

5. 僅在必要時才回退到手動地址或供應商驅動程式。

如果發現失敗，但印表機在已知地址上回應，請查閱製造商文件以取得其實際的列印服務 URI。ipps://如果印表機支援安全 IPP 且其憑證可以驗證，則首選使用端點。ipp://在受控的本地網路中，端點也是一個可行的選擇。不要假設每台印表機都使用端點/ipp/print。

對於支援原始套接字列印但不支援 IPP 的舊型號印表機，HamoniKR 文件中提到 AppSocket/HP JetDirect：輸入主機位址並確認印表機使用預期連接埠（通常為 9100）。這種方法可以避免服務發現，但缺少 IPP 的功能協商，通常不提供加密。

手動網路印表機對話方塊顯示主機 192.168.1.50 和連接埠 9100 字段 — 手動設定 AppSocket 需要印表機主機以及該裝置支援的連接埠。

如果您已驗證 IPP Everywhere URI，管理員也可以透過命令列建立佇列。以下地址僅供參考；請將其替換為實際的印表機 URI：

sudo lpadmin -p OfficePrinter -E -v ipp://192.168.1.50/ipp/print -m everywhere

此-p參數指定佇列名稱、-v目標位址，並-m everywhere請求使用無驅動模式。這僅在印表機聲明具備所需的 IPP 功能時才有效。 OpenPrinting lpadmin 參考文件對此格式進行了說明，並警告傳統的基於 PPD 的驅動程式已被棄用。

如果模型仍然無法列印或遺失所需功能，請先檢查 HamoniKR 文件中記錄的發行版支援的軟體包：

sudo apt update
sudo apt install hamonikr-printer-drivers

如果您需要廠商提供的 Linux 驅動程式或 PPD 文件，請從原廠商處取得，確認其支援您的裝置型號和架構，並僅在確認無誤後才進行安裝。切勿因為品牌匹配就隨意選擇 PPD 檔案。某些廠商提供的驅動程式佇列雖然能提供更完善的裝置特定選項，但可能難以在未來的更新中維護。

印表機驅動程式選擇對話框，包含 HP 製造商清單、型號選擇和「提供 PPD 檔案」按鈕 — 型號選擇畫面可以提供打包驅動程式或明確提供的製造商 PPD。

6. 設定預設設定並驗證印表機是否正常運作

在印表機屬性或 CUPS 設定預設選項頁面中，設定正確的媒體尺寸，並檢查所選驅動程式提供的選項。 A4 和 Letter 紙張尺寸差異常常會導致列印尺寸意外變化。雙面列印、品質和色彩設定因裝置而異；請勿假定範例中顯示的每個控制項都適用於您的印表機。

CUPS印表機選項頁面顯示了A4紙、一般媒體、標準列印品質和單面列印選項。 — 儲存印表機預設設定前，請檢查紙張尺寸和可用的列印選項。

在 CUPS 中，開啟“印表機”，選擇您的列印佇列，然後從“維護”中選擇“列印測試頁”。您也可以在不使用瀏覽器的情況下檢查相同列印佇列：

lpstat -p -d
lpstat -o
lp -d OfficePrinter /path/to/test.pdf

CUPS 印表機頁面顯示 OfficePrinter 處於閒置狀態並正在接受作業，且已選擇「列印測試頁」。 — 佇列視圖會顯示印表機狀態，並提供測試頁操作來驗證輸出。

配置成功意味著測試頁能夠以預期的頁面尺寸和佈局列印出來，作業從佇列中清除，並且正常的應用程式可以列印到相同目標位置。「空閒，正在接受作業」僅表示 CUPS 可以將作業加入佇列；這並不能證明紙張已到達出紙匣。如果列印停止，請lpstat -o檢查所選設備的 URI，確認其可及性，並將印表機的 IPP 或套接字設定與其文件進行比較。對於網路設置，CUPS 防火牆和網路端口指南指出，IPP 使用 TCP 631 端口，mDNS 發現使用 UDP 5353 端口；任何防火牆更改都應僅在受信任的 LAN 上應用。

有關使用者預設設定和命令列作業的更多詳細信息，請參閱CUPS 命令列列印參考文件。如果目前的無驅動列印佇列能夠正確列印測試頁，請保留它，不要新增重疊的舊版列印佇列。