如何在 HamoniKR 作業系統上透過 CUPS 設定印表機

需要在 HamoniKR OS 上新增 USB 或網路印表機？最快捷的方式通常是使用桌上型印表機實用程式。 CUPS（通用 UNIX 列印系統）為許多 Linux 桌面工具提供列印佇列支持，並且還提供基於本機瀏覽器的管理頁面。當桌面實用程式偵測到印表機時，請使用它；當需要檢查佇列或手動輸入連接 URI 時，請直接使用 CUPS。

本文標題中的名稱通常寫作“Harmonica OS”，但該專案的官方英文拼寫為HamoniKR OS。其目前的印表機文件描述了圖形化設定流程和免驅動 IPP 支援。選單和可用軟體包可能因版本而異，因此請將以下標籤視為版本相關說明。本指南中的 CUPS 圖示為示意圖，並非來自已測試的 HamoniKR 安裝的實體圖。

快速參考

1. 開啟印表機設定並檢查 CUPS

在 HamoniKR 中，開啟「選單」>「管理」>「印表機」，或開啟「系統設定」中的「印表機」部分。 HamoniKR 8.0 官方指南也列出system-config-printer了啟動其印表機實用程式的方法。如果您的桌面選單不同，請在應用程式啟動器中搜尋「印表機」。

如果您需要使用 CUPS Web 介面，請http://localhost:631在管理印表機的同一台電腦上的瀏覽器中開啟該位址。此位址指向本機電腦。如果無法載入，請檢查 CUPS 是否已安裝並正在運作：

systemctl status cups

在基於 Debian 或 Ubuntu 的 HamoniKR 安裝中，如果缺少 CUPS，請從已配置的發行版儲存庫安裝該軟體包，然後啟動該服務：

sudo apt update
sudo apt install cups
sudo systemctl start cups

使用軟體套件管理器的提示在接受軟體包之前進行檢查。個人桌面通常不需要將 CUPS 管理頁面暴露給外部網路。保持瀏覽器開啟localhost；不要為了新增本機印表機而放寬 CUPS 存取規則或開啟 631 連接埠。

2. 透過 CUPS Web 介面新增印表機

在 CUPS 中，選擇「管理」，然後選擇「新增印表機」。出現提示時，請使用有權管理此電腦上列印的帳戶登入。清單可能顯示本地連接的 USB 裝置和網路上發現的印表機。選擇正確的設備，確認其連接，並為佇列指定一個您能識別的簡短名稱，例如「印表機」office_laser。

如果網路印表機未顯示，請使用其網路位址，不要猜測。您可以在印表機的網路選單、路由器裝置清單或製造商的設定頁面中找到該位址。在 CUPS 連線步驟中，選擇相符的協定並輸入印表機文件中提供的 URI。對於許多現代設備，IPP URI 類似於 ` ipp://192.168.1.50/ipp/print<IPP URI>/<IPPS ...

3. 選擇驅動程式或免驅動程式IPP，然後設定預設值

當安裝精靈詢問印表機型號或驅動程式時，如果印表機支持，建議優先選擇IPP Everywhere或 HamoniKR 工具的免驅動 IPP選項。免驅動列印會讀取相容印表機報告的功能，而不是依賴傳統的特定型號的 PPD 檔案。對於許多新型網路印表機來說，這是一個不錯的首選方案，但它可能無法啟用所有廠商功能。

如果免驅動安裝不可用或列印不正確，請從可用清單中選擇準確的印表機品牌和型號。 HamoniKR 的文件建議，如果印表機無法識別，請安裝其印表機支援包：

sudo apt update
sudo apt install hamonikr-printer-drivers

確認您設定的 HamoniKR 版本軟體倉庫中是否提供了該軟體包。如果仍缺少某個型號，請造訪印表機製造商的官方 Linux 支援頁面，尋找特定的型號以及與您的作業系統版本相容的軟體套件。切勿為了完成嚮導而選擇型號過於相似的產品：不支援的解析度、雙面列印、紙匣或顏色模式可能會導致列印品質不佳。

新增列印佇列後，請設定您實際使用的選項：紙張尺寸（例如，Letter 或 A4）、彩色或灰階列印，以及是否支援雙面列印。根據驅動程式的不同，CUPS 和桌面對話方塊可能提供不同的控制項。選擇“設定預設選項”或等效的“應用/儲存”控件，以便設定生效。

4. 列印測試頁並驗證結果

在印表機的 CUPS 設定頁面中，使用維護選單選擇「列印測試頁」。您也可以從桌面應用程式列印簡單的文件。設定成功後，列印作業會出現在佇列中，狀態變成“已完成”，並且列印出的頁面具有預期的方向、紙張尺寸、顏色和邊距。

若要快速檢查終端，請列出已設定的佇列及其狀態：

lpstat -t

若要將文件列印到指定佇列，請使用：

lp -d office_laser /path/to/test.pdf

請將佇列名稱和檔案路徑替換為您自己的名稱和路徑。如果您想從終端機新增 IPP Everywhere 印表機，CUPS 命令列格式如下：

sudo lpadmin -p office_laser -E -v ipp://PRINTER_IP/ipp/print -m everywhere

將 URI 路徑替換PRINTER_IP為印表機的官方位址。此命令用於建立或更新佇列；它不會為每個型號自動查找正確的 URI。

常見問題及實用解決方法

• 印表機未顯示在裝置清單中：請確認印表機已喚醒、連接至相同網絡，且未連接到訪客 Wi-Fi 網路。嘗試使用製造商提供的 IP 位址或連接方式。如果是 USB 連接，請直接連接到電腦並重新開啟「印表機」公用程式。
• CUPS 已開啟但拒絕變更：已登入帳戶可能沒有列印管理權限。請使用已授權的本機帳戶或要求系統管理員授予存取權限；請勿透過變更廣泛存取規則作為變通方法。
• 佇列顯示空閒，但沒有任何列印輸出：請檢查紙張、碳粉或墨水、印表機顯示錯誤以及佇列作業狀態。確認所選的 URI 和驅動程序，然後發送一份單頁測試文件。
• 頁面列印版面錯誤或缺少選項：請檢查應用程式和印表機預設設定中的紙張尺寸和方向。嘗試使用供應商提供的驅動程序，或者如果可用，請嘗試使用受支援的免驅動 IPP 佇列。
• 這台印表機目前仍不受支援：請查看 HamoniKR 的支援包可用性以及製造商提供的 Linux 下載，以找到適用於您特定型號的驅動程式。無驅動列印可以提供基本輸出，但無法使用專有功能。

最終檢查清單

• 印表機已通電，並透過 USB 連接埠或連接至相同可信任網路。
• 印表機公用程式或 CUPS 會顯示目標裝置和正確的連線。
• 此佇列使用相容的驅動程式或受支援的免驅動 IPP 模式。
• 紙張尺寸和其他預設設定與文件和印表機相符。
• 測試頁已完成，並且在紙上看起來正確。

有關特定版本的說明，請先參閱HamoniKR 印表機指南。有關 CUPS 的詳細信息，請參閱官方CUPS 概述、印表機管理參考和網路印表機指南。選單路徑、驅動程式套件和支援的功能清單可能會因作業系統版本和印表機型號而異。