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