簡(jiǎn)介這份文檔是統(tǒng)信UOS適配惠普打印機(jī)的官方安裝說(shuō)明面向在國(guó)產(chǎn)操作系統(tǒng)上配置打印外設(shè)的運(yùn)維人員、企業(yè)IT管理員及日常辦公用戶(hù)。內(nèi)容首先明確驅(qū)動(dòng)安裝前需要準(zhǔn)備的物料與系統(tǒng)版本要求然后給出從確認(rèn)打印機(jī)型號(hào)、下載驅(qū)動(dòng)包到完成安裝的完整流程并以表格形式列出hplip-3.20.9.1驅(qū)動(dòng)所支持的數(shù)十款惠普激光打印機(jī)型號(hào)覆蓋M1005、1020 Plus、P1106/P1108、M126/M128、M1136、M203/M227/M403/M427/M305/M405/M329等常見(jiàn)系列。文檔由統(tǒng)信官方于2020年10月發(fā)布正文約1.14MB壓縮包僅包含1個(gè)docx文件便于直接查閱與分發(fā)。已有7800余人學(xué)習(xí)瀏覽適合需要快速為UOS設(shè)備部署惠普打印驅(qū)動(dòng)的讀者參考。1. 拿到《統(tǒng)信UOS官方安裝HP打印機(jī)驅(qū)動(dòng)說(shuō)明文檔.docx》先確認(rèn)它解決什么問(wèn)題這份《統(tǒng)信UOS官方安裝HP打印機(jī)驅(qū)動(dòng)說(shuō)明文檔.docx》是運(yùn)維把辦公電腦從Windows遷到UOS時(shí)最先找的參考材料。它解決的不是下載一個(gè)驅(qū)動(dòng)點(diǎn)下一步的Windows式問(wèn)題而是把HP打印機(jī)的驅(qū)動(dòng)依賴(lài)、插件授權(quán)、CUPS服務(wù)這三段鏈路一次性理順。看完你能回答當(dāng)前系統(tǒng)該裝哪個(gè)包、裝完怎么添加隊(duì)列、打印卡住去哪里查日志。我建議桌面支持團(tuán)隊(duì)把它當(dāng)安裝基線而不是混用一堆來(lái)路不明的教程。原因在于UOS雖然基于Debian但打印組件做過(guò)裁剪直接用Debian源里的命令不一定完整同時(shí)HP驅(qū)動(dòng)又分自由版和專(zhuān)用插件少了插件打印機(jī)驅(qū)動(dòng)裝上也會(huì)被識(shí)別成未知設(shè)備。這篇文章不會(huì)替代文檔內(nèi)容只把文檔里沒(méi)明說(shuō)的邊界補(bǔ)上先看系統(tǒng)架構(gòu)再裝HPLIP最后落到打印管理器避免一上來(lái)就把Windows下的老思路硬套過(guò)來(lái)。2. 從說(shuō)明文檔的目錄結(jié)構(gòu)看懂HP打印機(jī)驅(qū)動(dòng)安裝鏈路2.1 HPLIP是主線UOS驅(qū)動(dòng)包與HP驅(qū)動(dòng)的關(guān)系官方說(shuō)明文檔的章節(jié)順序通常會(huì)把安裝HPLIP放在打印機(jī)添加的前一步。這個(gè)順序不是隨便排的HP在Linux桌面上的驅(qū)動(dòng)事實(shí)上是以HPLIPHP Linux Imaging and Printing為載體的UOS軟件源里的惠普驅(qū)動(dòng)包本質(zhì)也是把HPLIP重新打了一遍。HPLIP不是單一驅(qū)動(dòng)文件而是包含PPD描述文件、后端程序、過(guò)濾器、配置工具和專(zhuān)有插件下載器的集合。CUPS負(fù)責(zé)調(diào)度打印任務(wù)真正和打印機(jī)通信的是HPLIP提供的后端與過(guò)濾器。所以安裝驅(qū)動(dòng)在UOS上應(yīng)該理解成安裝一整套打印運(yùn)行時(shí)。裝完系統(tǒng)里會(huì)多出 hp-setup、hp-plugin、hp-check、hp-ppd-upload 等命令打印管理器添加打印機(jī)時(shí)才能從本地PPD列表里找到對(duì)應(yīng)機(jī)型。理解這一點(diǎn)能解釋后面大多數(shù)翻車(chē)很多人以為驅(qū)動(dòng)是一個(gè) .deb 包裝完就不管了實(shí)際上HPLIP包本身只是入口后續(xù)的插件、權(quán)限、隊(duì)列URI才是完整鏈路。從官方說(shuō)明文檔的寫(xiě)法看它默認(rèn)讀者已經(jīng)知道HPLIP的存在所以不會(huì)花篇幅解釋原理而是直接給安裝命令。但這條主線必須被運(yùn)維記在腦子里如果一臺(tái)HP打印機(jī)在UOS上怎么都裝不上先查HPLIP是否完整不要先去打印機(jī)網(wǎng)頁(yè)面板里翻固件。那么如何判斷當(dāng)前系統(tǒng)是否已經(jīng)有了HPLIP在UOS終端里運(yùn)行下面的檢查命令dpkg -l | grep hplip systemctl is-active cups which hp-setup hp-plugindpkg -l | grep hplip如果列出ii狀態(tài)說(shuō)明包管理器層面已經(jīng)安裝systemctl is-active cups返回active說(shuō)明打印服務(wù)在跑which同時(shí)確認(rèn)三個(gè)常用命令是否在 PATH 里。三行輸出缺任何一個(gè)都說(shuō)明鏈路沒(méi)完整繼續(xù)往下走會(huì)踩坑。2.2 官方文檔常見(jiàn)的三個(gè)安裝入口應(yīng)用商店、命令行、打印管理器UOS下裝HPLIP說(shuō)明文檔一般會(huì)給三個(gè)入口應(yīng)用商店、命令行、打印管理器。它們結(jié)果相同但適用場(chǎng)景完全不同。應(yīng)用商店是UOS的圖形化軟件管理搜索HP或HPLIP點(diǎn)安裝。優(yōu)點(diǎn)是鼠標(biāo)完成適合單臺(tái)辦公電腦缺點(diǎn)是商店里的版本往往滯后于軟件源而且裝完后不會(huì)自動(dòng)提示專(zhuān)有插件。如果用戶(hù)已經(jīng)裝過(guò)舊版商店還可能出現(xiàn)安裝成功但實(shí)際沒(méi)變化的問(wèn)題。遇到這種情況我一般會(huì)直接在終端里再跑一遍 apt install確認(rèn)包真正落到系統(tǒng)里。命令行是最適合批量運(yùn)維的入口sudo apt update sudo apt install -y hplip這里-y讓apt自動(dòng)確認(rèn)所有提示避免安裝程序問(wèn)一半卡住sudo apt update刷新軟件源索引如果省掉很可能裝的是緩存里很舊的版本或者直接報(bào)包找不到。注意不要用apt upgrade來(lái)順帶裝驅(qū)動(dòng)那樣會(huì)連帶升級(jí)一堆無(wú)關(guān)包打印機(jī)驅(qū)動(dòng)沒(méi)問(wèn)題反而把別的東西升級(jí)出問(wèn)題。打印管理器入口更特殊UOS的打印管理器基于CUPS的圖形配置工具在添加打印機(jī)向?qū)Ю镞x擇設(shè)備后系統(tǒng)會(huì)從本機(jī)已知的PPD清單里匹配驅(qū)動(dòng)。如果沒(méi)有提前裝HPLIP打印管理器只能列出Generic通用驅(qū)動(dòng)雖然也能建隊(duì)列但打印質(zhì)量、雙面、紙盒選項(xiàng)都會(huì)缺失。所以文檔把打印管理器放在安裝后的位置順序不能倒。三個(gè)入口對(duì)比如下安裝入口適用對(duì)象說(shuō)明文檔推薦的語(yǔ)氣實(shí)際要注意的點(diǎn)應(yīng)用商店單臺(tái)桌面非技術(shù)用戶(hù)最優(yōu)先展示版本滯后裝完要檢查命令命令行批量部署、運(yùn)維穩(wěn)定可復(fù)現(xiàn)需要sudo專(zhuān)有插件還要單獨(dú)跑打印管理器驅(qū)動(dòng)已裝好的日常維護(hù)作為驗(yàn)證手段沒(méi)有PPD時(shí)只能選通用驅(qū)動(dòng)這張表也說(shuō)明了一個(gè)事實(shí)官方文檔并不只面向運(yùn)維還要照顧普通用戶(hù)所以它會(huì)把應(yīng)用商店寫(xiě)在前。但落到企業(yè)交付命令行路徑才是能沉淀成腳本的那條。2.3 先分清驅(qū)動(dòng)類(lèi)型PCL、PostScript與專(zhuān)有插件HPLIP不是萬(wàn)能藥。HP打印機(jī)按固件內(nèi)置的頁(yè)面描述語(yǔ)言可以分成幾類(lèi)官方說(shuō)明文檔的驅(qū)動(dòng)選擇表往往是按這個(gè)分類(lèi)寫(xiě)的。第一類(lèi)是PCLPrinter Command Language大多數(shù)單功能黑白激光機(jī)和部分噴墨機(jī)使用。HPLIP提供對(duì)應(yīng)的PPD文件CUPS通過(guò)PPD把應(yīng)用文檔轉(zhuǎn)成PCL數(shù)據(jù)發(fā)給打印機(jī)。這類(lèi)機(jī)型安裝最順利通用規(guī)則是先裝HPLIP包再用打印管理器或lpadmin建隊(duì)列。第二類(lèi)是PostScript。部分高端彩色激光機(jī)、復(fù)合機(jī)內(nèi)置PostScript解釋器系統(tǒng)里有一批PostScript通用PPD可用甚至不需要HP專(zhuān)用的HPLIP后端。但判斷不能只看型號(hào)名需要在打印機(jī)面板或管理頁(yè)面確認(rèn)固件是否開(kāi)放了PS支持沒(méi)開(kāi)放的話即使選了PS驅(qū)動(dòng)輸出也會(huì)是亂碼或空白。第三類(lèi)是獨(dú)立于頁(yè)面描述語(yǔ)言的專(zhuān)有插件。HP的多功能一體機(jī)里掃描、傳真、卡片讀取這些功能依賴(lài)二進(jìn)制固件這些固件不在HPLIP開(kāi)源包里需要安裝時(shí)通過(guò) hp-plugin 從HP服務(wù)器下載。這類(lèi)機(jī)型常常是UOS交付里最耗時(shí)間的因?yàn)椴寮螺d、許可確認(rèn)、架構(gòu)支持三個(gè)環(huán)節(jié)都可能出問(wèn)題。在安裝任何驅(qū)動(dòng)以前可以先查一下當(dāng)前CUPS認(rèn)識(shí)的HP驅(qū)動(dòng)有哪些lpinfo -m 2/dev/null | grep -i hplpinfo -m列出CUPS能識(shí)別的全部驅(qū)動(dòng)模型。如果grep結(jié)果為空說(shuō)明HPLIP沒(méi)裝好或者CUPS服務(wù)沒(méi)起來(lái)打印管理器里自然看不到任何HP選項(xiàng)。反過(guò)來(lái)如果列表里有機(jī)型但找不到自己的具體型號(hào)不必急著下結(jié)論P(yáng)PD清單經(jīng)常用兼容產(chǎn)品系列命名選系列里相鄰的一臺(tái)通常能正常工作。在后續(xù)章節(jié)里我會(huì)按官方文檔最常見(jiàn)的一條路徑走命令行裝HPLIP再用打印管理器添加打印機(jī)。這條路徑出問(wèn)題最少也是所有腳本類(lèi)交付的骨架。3. 按說(shuō)明跑通最小安裝從依賴(lài)檢查到打印測(cè)試頁(yè)3.1 安裝前的檢查系統(tǒng)版本、架構(gòu)與已裝組件拿到任何一臺(tái)新到的UOS機(jī)器先不要急著敲安裝命令。HPLIP對(duì)系統(tǒng)架構(gòu)很敏感UOS同時(shí)存在amd64和arm64兩種主流桌面環(huán)境HP的專(zhuān)有插件對(duì)arm64的支持并不完整。先確認(rèn)機(jī)器架構(gòu)能避免后面所有 plugin required but not found 的無(wú)效嘗試。cat /etc/os-release uname -m dpkg -l | grep -E hplip|cups || true systemctl is-active cupscat /etc/os-release用來(lái)確認(rèn)UOS的具體版本號(hào)和代號(hào)方便判斷軟件源是否正常uname -m輸出x86_64或aarch64對(duì)應(yīng)amd64和arm64包體系dpkg -l | grep -E hplip|cups看當(dāng)前可執(zhí)行環(huán)境里是否已經(jīng)有相關(guān)包|| true是防止grep沒(méi)有匹配時(shí)讓腳本以非零碼退出systemctl is-active cups確認(rèn)打印服務(wù)狀態(tài)。四行命令組合起來(lái)基本把環(huán)境狀態(tài)交代清楚了。常見(jiàn)情況是系統(tǒng)里其實(shí)已經(jīng)裝了hplip但CUPS服務(wù)因?yàn)樯?jí)或依賴(lài)損壞沒(méi)有跑起來(lái)。這時(shí)候直接添加打印機(jī)界面會(huì)一直轉(zhuǎn)圈任務(wù)發(fā)到隊(duì)列里也不執(zhí)行。先跑上面檢查比在圖形界面里猜原因高效得多。如果dpkg -l顯示 hplip 處于ii狀態(tài)而which hp-setup找不到說(shuō)明包在數(shù)據(jù)庫(kù)里存在但文件被手動(dòng)刪過(guò)此時(shí)需要sudo apt install --reinstall hplip讓它重新落文件。這種文件和數(shù)據(jù)庫(kù)不一致的問(wèn)題在Windows下基本見(jiàn)不到Linux里卻很常見(jiàn)屬于部署階段最大的黑匣子。3.2 命令行安裝HPLIP的最小命令與參數(shù)對(duì)amd64的UOS機(jī)器安裝HPLIP的最小命令就是我前面寫(xiě)過(guò)的兩條。為了工程化我會(huì)再補(bǔ)一條依賴(lài)修復(fù)sudo apt update sudo apt install -y hplip sudo apt-get install -fsudo apt update刷新源列表sudo apt install -y hplip安裝主包sudo apt-get install -f是一個(gè)兜底如果安裝過(guò)程中發(fā)現(xiàn)依賴(lài)不完整它會(huì)自動(dòng)補(bǔ)裝缺失的依賴(lài)包。對(duì)UOS這種在Debian基礎(chǔ)上裁剪過(guò)的發(fā)行版-f這步能救回不少因?yàn)檐浖礇_突導(dǎo)致的半裝狀態(tài)。安裝完成后不要急著添加打印機(jī)先順手確認(rèn)一下GUI組件是否存在。不同UOS版本里hplip-gui這個(gè)包不一定存在有的版本把hp-setup的圖形界面打包進(jìn)hplip主包有的版本需要單獨(dú)安裝?？梢杂靡粭l命令處理sudo apt install -y hplip hplip-gui如果軟件源里沒(méi)有 hplip-guiapt會(huì)報(bào)無(wú)法定位軟件包這時(shí)候不用慌張hp-setup命令行模式同樣能用。關(guān)鍵在于看到這個(gè)報(bào)錯(cuò)不要繼續(xù)apt install -y hplip-gui死磕而應(yīng)該記下當(dāng)前源里沒(méi)有GUI包后續(xù)用命令行交互否則容易在第一步就浪費(fèi)時(shí)間。3.3 GUI方式添加打印機(jī)UOS打印管理器操作順序HPLIP裝完后最穩(wěn)妥的落地方式是UOS自帶的打印管理器Print Manager。它的底層調(diào)用的是system-config-printer但對(duì)國(guó)內(nèi)用戶(hù)做了界面漢化和設(shè)備掃描優(yōu)化。操作順序通常是這樣的打開(kāi)打印管理器確認(rèn)服務(wù)狀態(tài)顯示運(yùn)行中。點(diǎn)擊添加打印機(jī)系統(tǒng)先做本地USB掃描再掃網(wǎng)絡(luò)打印機(jī)。如果是USB連接列表里會(huì)直接出現(xiàn)打印機(jī)的USB路徑選中下一步。如果列表里沒(méi)有點(diǎn)手動(dòng)輸入U(xiǎn)RI填socket://打印機(jī)IP:9100或ipp://打印機(jī)IP/ipp/print。下一步選擇驅(qū)動(dòng)PPD正常情況下列表里會(huì)出現(xiàn)HP開(kāi)頭的項(xiàng)按型號(hào)或兼容系列選擇。設(shè)置打印機(jī)名稱(chēng)建議用HP_型號(hào)這種不帶空格的名稱(chēng)方便寫(xiě)腳本和命令行。最后一步打印測(cè)試頁(yè)。這里每一步都有對(duì)應(yīng)的坑。第二步如果掃描不出來(lái)先回命令行執(zhí)行l(wèi)pinfo -v看有沒(méi)有direct usb://或network socket://的輸出。沒(méi)有輸出說(shuō)明后端沒(méi)探測(cè)到設(shè)備問(wèn)題大概率出在內(nèi)核或權(quán)限而不是打印管理器本身。第五步選擇PPD時(shí)如果列表里只有Generic說(shuō)明HPLIP沒(méi)裝成功回到上一節(jié)重新裝。網(wǎng)絡(luò)打印機(jī)強(qiáng)烈建議在添加前把打印機(jī)本體設(shè)置為固定IP不要在打印機(jī)面板里開(kāi)DHCP。理由很直接CUPS隊(duì)列里保存的是IP字符串DHCP重租后打印機(jī)換地址隊(duì)列就變成一直離線用戶(hù)只會(huì)看到打印機(jī)不工作不會(huì)想到去查IP。固定IP這個(gè)動(dòng)作官方說(shuō)明文檔一般會(huì)放在網(wǎng)絡(luò)章節(jié)實(shí)際部署時(shí)應(yīng)該提前做。3.4 打印測(cè)試頁(yè)與響應(yīng)碼驗(yàn)證添加完隊(duì)列最后一步驗(yàn)證不能省略。很多人裝完驅(qū)動(dòng)看到列表里多了個(gè)打印機(jī)名字就以為成功了實(shí)際上隊(duì)列可能處于 disabled 狀態(tài)或者PPD匹配錯(cuò)誤。驗(yàn)證要分成三層來(lái)看。第一層看隊(duì)列狀態(tài)lpstat -p正常輸出是printer HP_Printer is idle. rendering或idle。如果看到disabled說(shuō)明隊(duì)列被CUPS暫停了需要sudo cupsenable HP_Printer恢復(fù)。第二層發(fā)真實(shí)打印任務(wù)lp -d HP_Printer /etc/hp/hplip.conf/etc/hp/hplip.conf是HPLIP安裝時(shí)生成的文本文件用它打測(cè)試頁(yè)既能確認(rèn)數(shù)據(jù)鏈路通又能順便驗(yàn)證HPLIP的文本過(guò)濾鏈。返回會(huì)顯示一個(gè)任務(wù)ID比如request id was 42。緊接著可以用lpstat -o HP_Printer看任務(wù)是否消費(fèi)掉如果任務(wù)一直卡在隊(duì)列里進(jìn)入下一層查日志。第三層查日志sudo tail -50 /var/log/cups/error_log這是打印問(wèn)題排查的第一現(xiàn)場(chǎng)。filter failed、Unable to open connection to hp、printer requires manual intervention這些關(guān)鍵詞都從這里看到。從第一層到第三層每層定位一塊范圍隊(duì)列狀態(tài)看CUPS是否接收任務(wù)日志看HPLIP過(guò)濾器為什么沒(méi)把數(shù)據(jù)送到打印機(jī)。文檔寫(xiě)到這里通常會(huì)轉(zhuǎn)到常見(jiàn)問(wèn)題章節(jié)因?yàn)樗睬宄蛴」收嫌肋h(yuǎn)比安裝故障多。4. HP專(zhuān)有插件與網(wǎng)絡(luò)打印機(jī)說(shuō)明文檔里講得最深的兩個(gè)擴(kuò)展點(diǎn)4.1 哪些機(jī)型必須裝專(zhuān)用插件hp-pluginHPLIP開(kāi)源包能覆蓋絕大多數(shù)打印功能但HP把一部分設(shè)備特定能力多為掃描、傳真、讀卡器、特定固件升級(jí)做成了二進(jìn)制插件安裝協(xié)議、許可、下載都在安裝界面里完成。官方說(shuō)明文檔里這類(lèi)情況通常以一句提示出現(xiàn)部分多功能一體機(jī)需要安裝專(zhuān)有插件運(yùn)行 hp-plugin 繼續(xù)。這句話省略了很多細(xì)節(jié)實(shí)際跑起來(lái)才是真正的血淚經(jīng)驗(yàn)。判斷自己的機(jī)器是否需要插件最準(zhǔn)確的方式是安裝完HPLIP后用hp-setup -i走一遍交互流程。流程走到設(shè)備識(shí)別時(shí)如果終端輸出plugin required或列出需要下載的插件名稱(chēng)就說(shuō)明這臺(tái)機(jī)器繞不開(kāi)插件。另一條路是到HPLIP官網(wǎng)查支持表但在UOS環(huán)境里打開(kāi)網(wǎng)頁(yè)不如直接在終端跑hp-plugin -ihp-plugin -i會(huì)啟動(dòng)一個(gè)圖形或文本向?qū)葯z查本機(jī)缺什么插件然后連接到HP服務(wù)器下載對(duì)應(yīng).run文件執(zhí)行時(shí)要求輸入root密碼。需要說(shuō)明的是這個(gè)命令必須在有圖形會(huì)話的終端里跑純SSH無(wú)圖形環(huán)境會(huì)出現(xiàn)界面起不來(lái)的問(wèn)題如果服務(wù)器在機(jī)房只能SSH可以加-p參數(shù)指定插件文件路徑但一般桌面運(yùn)維不需要走到這一步。插件安裝的典型失敗點(diǎn)是版本匹配UOS軟件源里的hplip版本和HP服務(wù)器維護(hù)的插件下載版本可能有一兩個(gè)小版本差異導(dǎo)致下載下來(lái)的插件無(wú)法識(shí)別。這時(shí)候不要手動(dòng)去網(wǎng)頁(yè)下載 .run 文件強(qiáng)裝先sudo apt update sudo apt upgrade hplip把本機(jī)hplip更新到源里最新再重新跑 hp-plugin。大多數(shù)版本矛盾靠這個(gè)順序就能解決。還有一類(lèi)玄學(xué)問(wèn)題hp-plugin 安裝完成打印也正常但掃描儀還是找不到。原因通常是插件與底層掃描后端sane沒(méi)有打通需要確認(rèn)系統(tǒng)里有沒(méi)有 sane-airscan 或 hpaio 的包。UOS默認(rèn)不一定帶安裝命令是sudo apt install -y sane-airscan。這塊經(jīng)常被說(shuō)明文檔一句話帶過(guò)但實(shí)際運(yùn)維中碰到掃描不識(shí)別一半以上是缺這個(gè)后端。4.2 網(wǎng)絡(luò)打印與AppSocket/IPP配置網(wǎng)絡(luò)打印機(jī)是辦公室最常見(jiàn)的形態(tài)HPLIP里面對(duì)應(yīng)hp-setup -i的選擇Network輸入打印機(jī)IP后會(huì)自動(dòng)探測(cè)端口并生成PPD。但自動(dòng)探測(cè)不是每次都能準(zhǔn)尤其打印機(jī)開(kāi)了多個(gè)服務(wù)9100、IPP、HTTPS時(shí)CUPS會(huì)優(yōu)先選IPP而部分HP舊固件的IPP實(shí)現(xiàn)不完整打印任務(wù)會(huì)表現(xiàn)為已在隊(duì)列消費(fèi)但打印機(jī)沒(méi)反應(yīng)。我在生產(chǎn)環(huán)境里更偏愛(ài)AppSocket協(xié)議也就是socket://打印機(jī)IP:9100。9100端口是HP打印機(jī)的傳統(tǒng)數(shù)據(jù)口協(xié)議簡(jiǎn)單CUPS只需要把打印數(shù)據(jù)流送過(guò)去不涉及復(fù)雜的IPP屬性協(xié)商。對(duì)于單功能打印它的穩(wěn)定性比IPP高。手動(dòng)添加時(shí)在打印管理器的URI欄直接填socket://192.168.1.100:9100如果打印機(jī)面板設(shè)置了固定IP這個(gè)URI可以一直用下去。而ipp://192.168.1.100/ipp/print只建議在需要雙面、安全打印等高級(jí)功能且確認(rèn)設(shè)備固件較新時(shí)使用。判斷新舊的直觀標(biāo)準(zhǔn)是打印機(jī)管理頁(yè)面里能不能看到IPP屬性配置項(xiàng)看不到就老老實(shí)實(shí)用socket。命令行方式添加網(wǎng)絡(luò)隊(duì)列是批量運(yùn)維的關(guān)鍵sudo lpadmin -p HP_LaserJet -v socket://192.168.1.100:9100 -E這條命令只建立了隊(duì)列和URI還沒(méi)掛PPD。不加PPD的隊(duì)列CUPS會(huì)用通用raw模式數(shù)據(jù)不做轉(zhuǎn)換直接發(fā)給打印機(jī)只有打印機(jī)內(nèi)置字體匹配時(shí)才能打出正確內(nèi)容不是可用狀態(tài)。要徹底可用需要配合sudo lpadmin -p HP_LaserJet -v socket://192.168.1.100:9100 -m 從lpinfo取到的PPD名 -E lpstat -p HP_LaserJet-m參數(shù)從lpinfo -m的輸出里取PPD名省略了寫(xiě)完整路徑的麻煩。lpstat -p最后做一次狀態(tài)確認(rèn)。這里補(bǔ)一句不要用sudo lpadmin -p xxx -m raw期望通用驅(qū)動(dòng)能解決問(wèn)題那只是把CUPS變成數(shù)據(jù)管道打印質(zhì)量、紙盒選擇全部失效。4.3 權(quán)限、udev與libusbUSB打印的隱藏門(mén)檻USB連接看似簡(jiǎn)單實(shí)際在UOS上的故障率不低于網(wǎng)絡(luò)打印。核心原因是HPLIP訪問(wèn)USB設(shè)備需要用戶(hù)對(duì)/dev/bus/usb下的設(shè)備節(jié)點(diǎn)有讀寫(xiě)權(quán)限而UOS默認(rèn)會(huì)把普通用戶(hù)加進(jìn)lp組但不一定會(huì)加lpadmin組導(dǎo)致普通用戶(hù)能看隊(duì)列、不能管理隊(duì)列。最直接的權(quán)限修法sudo usermod -aG lp,lpadmin $USER newgrp lpusermod -aG把當(dāng)前用戶(hù)追加到lp和lpadmin兩個(gè)組newgrp lp讓當(dāng)前會(huì)話立即應(yīng)用新組不用注銷(xiāo)。注意$USER是當(dāng)前登錄用戶(hù)如果是給其他用戶(hù)配置要寫(xiě)成實(shí)際用戶(hù)名。改完組后還需重啟CUPS否則服務(wù)端仍按舊組權(quán)限校驗(yàn)sudo systemctl restart cups除了用戶(hù)組HPLIP還會(huì)在安裝時(shí)寫(xiě)入udev規(guī)則文件通常位于/etc/udev/rules.d/55-hplip.rules。當(dāng)遇到插上USB打印機(jī)能被 lsusb 看到但CUPS添加打印機(jī)時(shí)找不到的場(chǎng)景可以重載規(guī)則sudo udevadm control --reload-rules sudo udevadm trigger這兩個(gè)命令讓內(nèi)核重新加載設(shè)備規(guī)則對(duì)插上USB打印機(jī)能被 lsusb 看到但CUPS添加打印機(jī)時(shí)找不到非常有效。規(guī)則文件的機(jī)制對(duì)普通用戶(hù)是黑匣子但記住一個(gè)操作習(xí)慣就夠了改過(guò)驅(qū)動(dòng)或系統(tǒng)升級(jí)后打印異常先重載udev規(guī)則再重啟CUPS可以省下大量排查時(shí)間。5. 驅(qū)動(dòng)裝完卻打不出來(lái)的排查手冊(cè)說(shuō)明文檔沒(méi)寫(xiě)透的坑這一章的每條坑都是我或者身邊同事在不同單位摸過(guò)的。按現(xiàn)象排列方便你在打印機(jī)現(xiàn)場(chǎng)直接對(duì)照。先強(qiáng)調(diào)一個(gè)原則任何打印故障先看隊(duì)列狀態(tài)再看CUPS日志最后才動(dòng)打印機(jī)面板。順序反了容易把硬件問(wèn)題誤判成驅(qū)動(dòng)問(wèn)題。5.1 現(xiàn)象隊(duì)列卡在pending日志里出現(xiàn)filter failed現(xiàn)象是打印任務(wù)在隊(duì)列里顯示 pending 或 processing打印機(jī)沒(méi)有任何反應(yīng)。打開(kāi)/var/log/cups/error_log通常能找到一條filter failed或PID xxx ... stopped with status。原因分成兩類(lèi)一類(lèi)是HPLIP過(guò)濾器運(yùn)行時(shí)報(bào)錯(cuò)多半是版本不匹配或插件缺失另一類(lèi)是PPD指定了打印語(yǔ)言但HPLIP后端不知道該往打印機(jī)發(fā)什么字節(jié)流。判斷方法很簡(jiǎn)單在終端里看lpstat -o任務(wù)一直存在且狀態(tài)是rendering說(shuō)明CUPS已經(jīng)拿到任務(wù)但沒(méi)有處理完。解決sudo tail -100 /var/log/cups/error_log | grep -i filter\|hp\|error sudo systemctl restart cups sudo lpadmin -p HP_Printer -m 從lpinfo取到的PPD名 -E lpstat -p HP_Printer把-m改成lpinfo -m里對(duì)應(yīng)的HP PPD而不是保留安裝時(shí)選的Generic。這個(gè)操作很多人不愿意做因?yàn)闀?huì)改變隊(duì)列配置但實(shí)際上它正是filter failed最常見(jiàn)的解藥。如果重選PPD后還報(bào)錯(cuò)再重裝HPLIPsudo apt install --reinstall -y hplip sudo hp-plugin -i重裝加插件兩條命令下來(lái)八成以上的過(guò)濾鏈路問(wèn)題都能恢復(fù)。日志關(guān)鍵行還有Unable to open IEEE-1284 device對(duì)應(yīng)USB端口異常Error - invalid device URI對(duì)應(yīng)URI寫(xiě)錯(cuò)。運(yùn)維可以建立一個(gè)習(xí)慣改完任何配置后都sudo systemctl restart cups再打一發(fā)測(cè)試頁(yè)至少能排除服務(wù)狀態(tài)因素的干擾。5.2 現(xiàn)象USB打印機(jī)識(shí)別不到lsusb無(wú)輸出現(xiàn)象是打印機(jī)USB線接好打印管理器掃描時(shí)什么都看不到回到終端lsusb也找不到任何HP設(shè)備。這不是HPLIP的問(wèn)題而是系統(tǒng)層面根本沒(méi)發(fā)現(xiàn)USB設(shè)備。原因有三個(gè)層面第一線材和接口前置USB口經(jīng)常供電不足打印機(jī)開(kāi)機(jī)后usb枚舉失敗第二內(nèi)核缺少 usblp 模塊這個(gè)模塊負(fù)責(zé)傳統(tǒng)打印機(jī)接口有些UOS內(nèi)核默認(rèn)不加載第三設(shè)備被其他進(jìn)程占用比如用戶(hù)在Windows虛擬機(jī)里映射了USB設(shè)備。解決按順序lsusb dmesg | tail -30 sudo modprobe usblp lpinfo -v | grep -i usbdmesg看內(nèi)核日志如果出現(xiàn)Device Descriptor Request Failed基本確定是線或供電問(wèn)題換一根短一點(diǎn)的數(shù)據(jù)線、插機(jī)箱后置USB口重試如果modprobe usblp執(zhí)行后lpinfo -v出現(xiàn)direct usb://說(shuō)明設(shè)備已經(jīng)可以被CUPS后端看到。注意modprobe只對(duì)當(dāng)前內(nèi)核生效重啟后會(huì)回到未加載狀態(tài)需要確認(rèn)udev規(guī)則里是否加載usblp查不到就寫(xiě)一個(gè)/etc/modules-load.d/usblp.conf內(nèi)容為usblp一行保證開(kāi)機(jī)自動(dòng)加載。另外注意如果lsusb能看到設(shè)備但是lpinfo -v無(wú)輸出多半是HPLIP后端沒(méi)有正確識(shí)別USB設(shè)備可以運(yùn)行sudo hp-check -t看問(wèn)題行。hp-check -t會(huì)列出包、依賴(lài)、運(yùn)行權(quán)限是連官方文檔都推薦的第一步診斷。5.3 現(xiàn)象網(wǎng)絡(luò)打印機(jī)顯示已連接卻打印空白頁(yè)現(xiàn)象是打印任務(wù)狀態(tài)變?yōu)?completed打印機(jī)也走紙但紙張上是空白或滿紙亂碼。這個(gè)現(xiàn)象很容易讓運(yùn)維懷疑打印機(jī)硬件壞了但實(shí)際是驅(qū)動(dòng)協(xié)議不匹配?？瞻醉?yè)通常是PPD選擇錯(cuò)誤打印機(jī)內(nèi)置的是PCL驅(qū)動(dòng)卻選了PostScriptCUPS把文檔轉(zhuǎn)成PS數(shù)據(jù)打印機(jī)解釋不了只能吐空白。亂碼則是URI協(xié)議問(wèn)題打印機(jī)雖然開(kāi)了IPP端口但固件IPP實(shí)現(xiàn)不完整數(shù)據(jù)被打印機(jī)以非預(yù)期方式解析。解決先確認(rèn)打印機(jī)面板菜單里當(dāng)前的打印語(yǔ)言設(shè)置改成與驅(qū)動(dòng)一致。把隊(duì)列URI從ipp://...改成socket://打印機(jī)IP:9100sudo lpadmin -p HP_Printer -v socket://192.168.1.100:9100 -m 匹配的PPD -E lp restart HP_Printer用一張只有簡(jiǎn)單文本的測(cè)試頁(yè)驗(yàn)證echo UOS print test /tmp/printtest.txt lp -d HP_Printer /tmp/printtest.txtlp restart是重啟隊(duì)列丟棄之前的卡死任務(wù)。如果亂碼仍然存在再用rastertohp或hplip后端強(qiáng)制走PCL模式。實(shí)際經(jīng)驗(yàn)里socket PCL 是整個(gè)組合里兼容性最穩(wěn)的一對(duì)。排查白頁(yè)時(shí)可以把測(cè)試任務(wù)發(fā)到文件而不是直發(fā)打印機(jī)快速判斷數(shù)據(jù)格式是否能在設(shè)備側(cè)解析。5.4 現(xiàn)象系統(tǒng)升級(jí)后驅(qū)動(dòng)被覆蓋已安裝變未安裝現(xiàn)象是UOS系統(tǒng)升級(jí)后打印管理器里打印機(jī)圖標(biāo)變灰終端跑hp-check顯示 hplip 缺失或版本過(guò)低。升級(jí)前的完美環(huán)境升級(jí)后一夜回到解放前。原因有兩類(lèi)一是系統(tǒng)升級(jí)時(shí)把 hplip 包卸載因?yàn)榕f包與新內(nèi)核版本沖突二是 hplip 升級(jí)到新版本后自帶的PPD文件名變化CUPS隊(duì)列里還保留舊PPD路徑導(dǎo)致隊(duì)列加載失敗。前者是包管理層面后者是配置層面。解決包管理的痛苦靠鎖版緩解sudo apt-mark hold hplip hplip-guiapt-mark hold讓apt在之后的系統(tǒng)升級(jí)中跳過(guò)這兩個(gè)包不被覆蓋。鎖版是一把雙刃劍鎖了可能錯(cuò)過(guò)安全補(bǔ)丁但打印專(zhuān)用機(jī)器為了業(yè)務(wù)穩(wěn)定鎖版值得。等新版本驗(yàn)證完再sudo apt-mark unhold hplip解鎖升級(jí)。配置層面的舊PPD問(wèn)題則簡(jiǎn)單很多刪除舊隊(duì)列重建不保留原配置。sudo lpadmin -x HP_Printer sudo hp-setup -ilpadmin -x刪除隊(duì)列hp-setup -i重新走一遍識(shí)別流程讓HP工具用新版本的PPD重新生成隊(duì)列。這里不建議通過(guò)修改PPD路徑來(lái)修因?yàn)樾屡fPPD的選項(xiàng)名大概率不對(duì)應(yīng)手動(dòng)改是給明天埋雷。升級(jí)后先檢查隊(duì)列PPD路徑是否仍然存在lpstat -l -p 隊(duì)列名 | grep PPD如果路徑指到舊版本文件重裝后路徑變了同樣會(huì)出現(xiàn)加載失敗。這和filter failed的表現(xiàn)很像但日志里沒(méi)有hp字樣只有 ppd 加載錯(cuò)誤。5.5 現(xiàn)象打印任務(wù)提示權(quán)限不足隊(duì)列卻在正常響應(yīng)現(xiàn)象是隊(duì)列狀態(tài)正常測(cè)試頁(yè)在root用戶(hù)下能打普通用戶(hù)打印時(shí)卻提示Permission denied或printer not allowed。這種問(wèn)題最容易被誤解為用戶(hù)不會(huì)操作實(shí)際是CUPS的權(quán)限控制列表沒(méi)有把用戶(hù)放進(jìn)去。原因通常是CUPS默認(rèn)只允許lpadmin組用戶(hù)管理打印機(jī)但普通業(yè)務(wù)賬號(hào)只加入了lp組同時(shí)有些UOS鏡像會(huì)把默認(rèn)策略改成僅允許管理用戶(hù)打印。解決方式是調(diào)整隊(duì)列的允許用戶(hù)列表lpstat -l -p HP_Printer sudo lpadmin -p HP_Printer -u allow:alllpstat -l -p先查看當(dāng)前隊(duì)列策略allow:all是CUPS里把隊(duì)列開(kāi)放給所有本地用戶(hù)的參數(shù)。如果是辦公網(wǎng)需要更細(xì)粒度可以寫(xiě)成-u allow:user1,user2。調(diào)整完不需要重啟CUPS隊(duì)列策略即時(shí)生效。這個(gè)坑在官方文檔里經(jīng)常只是安全配置附件里的一句提示但實(shí)際桌面交付中十個(gè)權(quán)限問(wèn)題有八個(gè)是它造成的。6. 把官方說(shuō)明文檔轉(zhuǎn)成可復(fù)用的安裝腳本從一次性操作到標(biāo)準(zhǔn)化既然是抱著官方文檔來(lái)做實(shí)施最該帶走的是一個(gè)能重復(fù)執(zhí)行的骨架。我的習(xí)慣是把文檔里的安裝順序壓成一個(gè)腳本批量裝機(jī)時(shí)跑一遍再人工兜底專(zhuān)有插件。下面這個(gè)腳本適用于最常見(jiàn)的amd64加網(wǎng)絡(luò)激光打印機(jī)場(chǎng)景#!/bin/bash # 用法: bash install_hp.sh [隊(duì)列名] [打印機(jī)IP] QUEUE${1:-HP_Printer} IP${2:-192.168.1.100} URIsocket://${IP}:9100 set -e echo 1/4 環(huán)境檢查 cat /etc/os-release | head -n 1 uname -m echo 2/4 安裝HPLIP sudo apt update -qq sudo apt install -y hplip echo 3/4 重建隊(duì)列 if lpstat -p $QUEUE 2/dev/null; then sudo lpadmin -x $QUEUE fi PPD$(lpinfo -m 2/dev/null | grep -i hplip | head -n 1 | awk {print $1}) sudo lpadmin -p $QUEUE -v $URI -m $PPD -E echo 4/4 驗(yàn)證 lpstat -p $QUEUE echo test from script /tmp/hp_test.txt lp -d $QUEUE /tmp/hp_test.txt腳本里的set -e保證任何一步失敗都停止避免帶病往下走lpinfo -m | grep -i hplip | head -n 1會(huì)自動(dòng)取第一個(gè)可用PPD但這不意味著完美對(duì)特殊機(jī)型仍然需要人工指定PPD路徑。專(zhuān)有插件跑不了自動(dòng)化所以腳本執(zhí)行完后我會(huì)手動(dòng)跑一次hp-plugin -i確認(rèn)提示消失。這個(gè)腳本能解決的問(wèn)題是新機(jī)器第一次交付和批量重裝后的恢復(fù)它把最容易漏的環(huán)境檢查、依賴(lài)安裝、隊(duì)列重建變成了一次命令。真正讓我覺(jué)得值的是第三段lpadmin -x先刪后建避免問(wèn)題隊(duì)列一直殘留舊配置。這是我做了多次打印機(jī)遷移后留下的習(xí)慣官方說(shuō)明文檔不會(huì)寫(xiě)這種細(xì)節(jié)但它決定了自動(dòng)化腳本在真實(shí)環(huán)境里能不能用。驗(yàn)證清單很簡(jiǎn)單隊(duì)列idle、任務(wù)無(wú)error、測(cè)試頁(yè)文字清晰、雙面配置正確。如果這四項(xiàng)都過(guò)這臺(tái)機(jī)器就可以交給業(yè)務(wù)方如果過(guò)不了按第五章的排查路徑走。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取