絡(luò)打印協(xié)議解析：從驅(qū)動(dòng)less打印到ipptool調(diào)試與配置實(shí)戰(zhàn))
簡(jiǎn)介這是一份面向網(wǎng)絡(luò)開(kāi)發(fā)者的 IPP 網(wǎng)絡(luò)打印協(xié)議源碼包完整呈現(xiàn)基于 HTTP/1.1 的打印作業(yè)提交、打印機(jī)狀態(tài)查詢、作業(yè)控制及屬性擴(kuò)展等標(biāo)準(zhǔn)實(shí)現(xiàn)強(qiáng)調(diào)跨平臺(tái)設(shè)備間的互操作性適合需要開(kāi)發(fā)打印客戶端、研究協(xié)議解析或進(jìn)行系統(tǒng)集成的人員參考。包內(nèi)共 32 個(gè)文件以 C 語(yǔ)言源文件.c/.h為主體配合 Makefile 與 format 配置文件構(gòu)成可構(gòu)建的協(xié)議框架另含 svn-base 版本元數(shù)據(jù)與 README 說(shuō)明整體僅 35KB結(jié)構(gòu)緊湊便于快速閱讀。當(dāng)前已有 3860 人學(xué)習(xí)下載源碼重點(diǎn)覆蓋請(qǐng)求/響應(yīng)解析、狀態(tài)機(jī)流轉(zhuǎn)、IPP 數(shù)據(jù)編碼、錯(cuò)誤處理以及基于 HTTPS 的安全通信等模塊讀者可從底層報(bào)文開(kāi)始理解協(xié)議工作流程。對(duì)于希望自定義打印方案或排查跨平臺(tái)打印問(wèn)題的開(kāi)發(fā)者這份代碼提供了可直接研讀的實(shí)例與擴(kuò)展基礎(chǔ)。1. IPP網(wǎng)絡(luò)打印協(xié)議為什么現(xiàn)在驅(qū)動(dòng)less打印都在喊它打印機(jī)驅(qū)動(dòng)裝不上設(shè)備明明連著局域網(wǎng)系統(tǒng)里卻只給你一堆 LPR 或 Raw Queue 端口——這是做網(wǎng)絡(luò)打印集成最常見(jiàn)的開(kāi)局。IPP網(wǎng)絡(luò)打印協(xié)議Internet Printing Protocol就是為了結(jié)束這種黑匣子狀態(tài)它把打印動(dòng)作變成基于 HTTP 的標(biāo)準(zhǔn)請(qǐng)求作業(yè)提交、狀態(tài)查詢、能力協(xié)商都能用明文請(qǐng)求和響應(yīng)去驗(yàn)證。它能解決的是驅(qū)動(dòng)缺失、跨平臺(tái)支持、移動(dòng)端免驅(qū)打印這類問(wèn)題適合設(shè)備集成、運(yùn)維工程師以及準(zhǔn)備在自研系統(tǒng)里接入打印能力的人。接下來(lái)我不背協(xié)議編號(hào)而是把 IPP 當(dāng)服務(wù)去拆先認(rèn)屬性再用手頭工具摸清設(shè)備最后配進(jìn)打印服務(wù)組件并處理那些翻車點(diǎn)。2. 先看懂IPP它與LPR/SMB的差別和你要記住的三個(gè)屬性在動(dòng)手敲命令前我得先把一個(gè)常見(jiàn)誤解糾正過(guò)來(lái)IPP 不是像 LPR 那樣“提交完就進(jìn)隊(duì)列、狀態(tài)全靠猜”它是一套自帶屬性查詢的 RPC 式協(xié)議。新手最容易把 IPP 和打印驅(qū)動(dòng)混在一起實(shí)際上 IPP 關(guān)心的不是光柵怎么拼而是“能不能打、打成什么樣、當(dāng)前什么狀態(tài)”。下面從協(xié)議骨架說(shuō)起順便把選型邏輯講清楚。2.1 IPP是“帶屬性的HTTP”端口631、二進(jìn)制請(qǐng)求、operationIPP 的傳輸層是 HTTP/1.1默認(rèn)端口 631數(shù)據(jù)體是二進(jìn)制編碼的請(qǐng)求和響應(yīng)。它把一次打印動(dòng)作包裝成一個(gè) operation request打印機(jī)或者打印服務(wù)器處理后返回 operation response?？蛻舳瞬恢惶峤蛔鳂I(yè)還可以先問(wèn)能力。這與 LPR/SMB 的差別很大LPR 只有簡(jiǎn)單的控制文件和數(shù)據(jù)文件沒(méi)有標(biāo)準(zhǔn)的狀態(tài)碼集合SMB 打印即便能共享隊(duì)列對(duì)網(wǎng)絡(luò)發(fā)現(xiàn)、TLS 和跨平臺(tái)屬性表達(dá)都很吃力。一次 IPP 調(diào)用的目標(biāo)叫 Printer URI形如ipp://192.168.1.50/ipp/print。客戶端 POST 一個(gè)二進(jìn)制請(qǐng)求到這個(gè) URI請(qǐng)求里必須有 Operation ID 和 Request ID。常見(jiàn)的 operation 如下表后面所有調(diào)試都繞不開(kāi)這幾個(gè)。Operation數(shù)值作用Print-Job0x0002提交打印作業(yè)文件內(nèi)容放在請(qǐng)求體內(nèi)Validate-Job0x0004只驗(yàn)證作業(yè)可不可打印不真正提交Get-Printer-Attributes0x000B獲取打印機(jī)的能力與當(dāng)前狀態(tài)Get-Jobs0x000A查詢排隊(duì)中的作業(yè)列表Cancel-Job0x0008取消指定作業(yè)如果你習(xí)慣的是 JSON 接口第一次看 IPP 會(huì)覺(jué)得它像黑匣子因?yàn)椴皇俏谋?。你無(wú)法用 curl 直接看懂響應(yīng)必須用專門的ipptool或者抓包看 631 端口。這也是為什么第 3 章全部以ipptool為主它能幫你把 IPP 的二進(jìn)制信封拆開(kāi)讓你看到屬性名和值。選型層面現(xiàn)代驅(qū)動(dòng)less打印之所以都選 IPP就是因?yàn)樗选安樵兡芰Α焙汀疤峤蛔鳂I(yè)”放進(jìn)同一個(gè)協(xié)議而不是像 LPR 那樣只能單向投遞。2.2 屬性樹(shù)Printer / Job / Document 三層別把三者搞混屬性是 IPP 的“參數(shù)數(shù)據(jù)庫(kù)”?？蛻舳撕头?wù)端交互時(shí)所有條件、能力、狀態(tài)都用名為“屬性”的鍵值對(duì)表達(dá)。值類型有很多keyword、boolean、integer、enum、resolution、rangeOfInteger 等每個(gè)屬性屬于一個(gè)“屬性組”在二進(jìn)制報(bào)文里以 tag 區(qū)分比如 operation-attributes-tag、printer-attributes-tag、job-attributes-tag。打印機(jī)端最重要的三層對(duì)象是 Printer、Job、Document。Printer 對(duì)象描述這臺(tái)設(shè)備能干什么printer-name、printer-stateidle/processing/stopped、printer-is-accepting-jobs、printer-up-time、document-format-supported都是這一層。Job 對(duì)象是你提交一次打印后產(chǎn)生的工作單job-id、job-state、job-state-reasons能告訴你作業(yè)是被處理、暫停還是卡紙。Document 對(duì)象描述文檔本身的屬性像document-format、document-natural-language很多場(chǎng)景下它不僅依附在 Job 上在提交請(qǐng)求里還要單獨(dú)用屬性組聲明。理解這個(gè)分層有助于排錯(cuò)例如你提交作業(yè)后打印機(jī)沒(méi)有任何反應(yīng)應(yīng)先查 Printer 層的printer-is-accepting-jobs與 Job 層的job-state-reasons而不是先去重裝驅(qū)動(dòng)。后面第 5 章就會(huì)遇到這類問(wèn)題。另外請(qǐng)求能力時(shí)用requested-attributes指定你想要的屬性名列表這個(gè)參數(shù)經(jīng)常被寫(xiě)錯(cuò)所以單獨(dú)強(qiáng)調(diào)一下它寫(xiě)在操作屬性組里值是 keyword 類型可以用all也可以傳多個(gè)屬性名。2.3 ipp:// 與 ipps://URI結(jié)構(gòu)、端口與“你看到的631未必是IPP”URI 是 IPP 的地址入口。標(biāo)準(zhǔn)格式是ipp://[用戶]主機(jī)[:端口]/路徑帶 TLS 時(shí)寫(xiě)ipps://默認(rèn)端口同樣習(xí)慣用 631不是常見(jiàn)的 443。路徑常見(jiàn)的是/ipp/print、/ipp、/printers/xxx廠商可以自行注冊(cè)路徑所以碰到具體設(shè)備時(shí)不要想當(dāng)然。這里最容易踩坑一臺(tái)打印機(jī)的 631 端口上可能同時(shí)站著 HTTP 管理服務(wù)和 IPP 服務(wù)根路徑是 HTML/ipp/print才是 IPP 端點(diǎn)。你用curl http://host:631/能得到 HTML不代表設(shè)備支持 IPP只能說(shuō)明它開(kāi)了 HTTP。正確的探測(cè)方式是用ipptool或設(shè)備廣播出來(lái)的服務(wù)發(fā)現(xiàn)結(jié)果不是瀏覽器。這個(gè)習(xí)慣能省掉后面一半時(shí)間。加密方面ipps://在同一個(gè) URI 上用 TLS 封裝 IPP證書(shū)常常是出廠自簽名第一次連接時(shí)打印服務(wù)組件會(huì)因?yàn)椤白C書(shū)未信任”把打印機(jī)標(biāo)記為認(rèn)證失敗這又是另一個(gè)獨(dú)立的坑。所以把“端口 631”和“協(xié)議是 IPP”分開(kāi)記憶比硬記端口安全得多。這一章最后補(bǔ)一個(gè)選型結(jié)論LPR 和 SMB 也不是不能用但在“無(wú)驅(qū)動(dòng)”“跨平臺(tái)”“作業(yè)狀態(tài)可查”這三個(gè)需求面前都要打折扣。IPP 的請(qǐng)求-響應(yīng)模型讓客戶端可以先問(wèn)能力再提交作業(yè)這正是當(dāng)前移動(dòng)端免驅(qū)打印方案的核心機(jī)制。所以標(biāo)題里說(shuō)的 IPP 網(wǎng)絡(luò)打印協(xié)議不是一個(gè)需要背的 RFC 編號(hào)而是一套能直接拿來(lái)測(cè)、拿來(lái)配、拿來(lái)寫(xiě)網(wǎng)關(guān)的和 HTTP 同源的協(xié)議。3. 用ipptool在本地把一臺(tái)IPP打印機(jī)摸清楚ipptool是能直接和打印機(jī)對(duì)話的命令行工具在多數(shù)帶打印服務(wù)的 Linux 發(fā)行版和桌面系統(tǒng)上都可以直接用它。它的好處是幫你把二進(jìn)制請(qǐng)求封裝好你只要寫(xiě)一個(gè)“測(cè)試文件”描述要發(fā)什么 operation、帶哪些屬性即可。下面三步是從“確認(rèn)支持”到“提交真實(shí)作業(yè)”的最小路徑。3.1 確認(rèn)設(shè)備支持IPP的最小命令一條ipptool加heredocipptool -tv ipp://192.168.1.50:631/ipp/print EOF { OPERATION Get-Printer-Attributes GROUP operation-attributes-tag ATTR charset attributes-charset utf-8 ATTR naturalLanguage attributes-natural-language en ATTR uri printer-uri $uri } EOF這里的-tv表示 verbose 輸出工具會(huì)把響應(yīng)的操作狀態(tài)碼和屬性值都打印出來(lái)$uri是 ipptool 自動(dòng)把命令行傳入的 Printer URI 當(dāng)作printer-uri屬性值所以你不用再重復(fù)寫(xiě) IP。請(qǐng)求里的 operation-attributes-tag 是必須的頭部屬性組attributes-charset、attributes-natural-language是 IPP 的兩個(gè)通用屬性每次都要帶。如果設(shè)備返回successful-ok說(shuō)明它確實(shí)支持 IPP如果返回client-error-not-found多半是路徑不對(duì)換/ipp或去設(shè)備 Web 管理端查真實(shí)路徑。這一條命令驗(yàn)證的事情比翻說(shuō)明書(shū)有價(jià)值它直接證明設(shè)備在 631 端口上響應(yīng) IPP 請(qǐng)求。后續(xù)所有配置都以這條命令返回successful-ok為前提。如果失敗先不要怪驅(qū)動(dòng)第一步就要懷疑 URI 路徑、端口、防火墻三層。3.2 讓打印機(jī)自己“報(bào)”能力requested-attributes 與 document-format-supported一旦確認(rèn)能通接下來(lái)就要問(wèn)打印機(jī)到底支持什么。很多同事在配置網(wǎng)絡(luò)打印時(shí)喜歡先在驅(qū)動(dòng)列表里找型號(hào)其實(shí) IPP 的正確姿勢(shì)是讓打印機(jī)自己告訴你它能吃哪些 document-format。下面請(qǐng)求只拉三個(gè)關(guān)鍵屬性。ipptool -tv ipp://192.168.1.50:631/ipp/print EOF { OPERATION Get-Printer-Attributes GROUP operation-attributes-tag ATTR charset attributes-charset utf-8 ATTR naturalLanguage attributes-natural-language en ATTR uri printer-uri $uri ATTR keyword requested-attributes printer-state ATTR keyword requested-attributes printer-is-accepting-jobs ATTR keyword requested-attributes document-format-supported } EOFrequested-attributes可以重復(fù)聲明每個(gè)屬性名是 keyword 類型。常見(jiàn)的響應(yīng)里printer-state是數(shù)字枚舉3 表示 idle4 表示 processing5 表示 stoppedprinter-is-accepting-jobs是 booleandocument-format-supported會(huì)列出類似application/pdf、image/pwg-raster、image/jpeg這樣的 MIME 類型。這就是之后提交作業(yè)要用的依據(jù)打印機(jī)聲明支持什么我們就提什么而不是想當(dāng)然發(fā) PDF 或 PS。有一個(gè)常見(jiàn)誤用以為支持application/pdf就代表支持高分辨率 / 光柵格式這完全兩回事。有些設(shè)備 PDF 解析能力有限但image/pwg-raster是它的原生格式有些兼容設(shè)備反而對(duì) PWG 支持不完整。所以在接入新設(shè)備時(shí)我一般會(huì)把document-format-supported完整列表存下來(lái)當(dāng)作后續(xù)提交參數(shù)的“白名單”。這一步做扎實(shí)后面作業(yè)被拒的概率會(huì)低很多。3.3 提交一個(gè)真實(shí)作業(yè)Print-Job、document-format 與 FILE/DATA 的區(qū)別驗(yàn)證能力之后就到了真正提交作業(yè)的環(huán)節(jié)。用Print-Job并帶上一個(gè)本地文件是最直接的端到端測(cè)試。ipptool -tv ipp://192.168.1.50:631/ipp/print EOF { OPERATION Print-Job GROUP operation-attributes-tag ATTR charset attributes-charset utf-8 ATTR naturalLanguage attributes-natural-language en ATTR uri printer-uri $uri GROUP job-attributes-tag ATTR mimeMediaType document-format application/pdf ATTR name job-name test-ipp-job FILE /tmp/test.pdf } EOFFILE /tmp/test.pdf會(huì)把文件內(nèi)容作為請(qǐng)求體發(fā)給打印機(jī)和 HTTP POST 的 body 概念一樣。document-format必須放在 job-attributes-tag 屬性組里告訴打印機(jī)這份數(shù)據(jù)是什么格式。如果打印機(jī)不認(rèn)這個(gè)格式響應(yīng)里會(huì)出現(xiàn)client-error-document-format-not-supported如果提交成功響應(yīng)里會(huì)帶job-id和job-uri這兩個(gè)值需要記下來(lái)后面查詢和取消作業(yè)都用得上。FILE和DATA的區(qū)別是FILE引用磁盤上的二進(jìn)制文件適合 PDF、PWG 光柵DATA直接把后面的字符串當(dāng)作文檔內(nèi)容適合快速測(cè)試純文本。測(cè)試純文本輸出時(shí)把document-format改成text/plain然后寫(xiě)DATA hello world就可以。提交之后如果想確認(rèn)作業(yè)是否真的進(jìn)入隊(duì)列再補(bǔ)一個(gè) Get-Jobs看返回的job-id是否在列表里。這樣一個(gè)完整的 IPP 客戶端驗(yàn)證流程就閉環(huán)了。4. 在打印服務(wù)組件里接一個(gè)IPP打印機(jī)URI、驅(qū)動(dòng)與端口的參數(shù)怎么設(shè)上一章證明了設(shè)備能通接下來(lái)要把它納入系統(tǒng)打印服務(wù)。這里以最常見(jiàn)的打印服務(wù)組件命令行工具為例。配置的關(guān)鍵點(diǎn)不是“選驅(qū)動(dòng)”而是“URI 對(duì)不對(duì)”和“用什么模式讓它自動(dòng)取能力”。4.1 用 lpadmin 配置 IPP 打印機(jī)的最小命令lpadmin -p office-printer -E -v ipp://192.168.1.50:631/ipp/print -m everywhere lpstat -p office-printer lpoptions -p office-printer -o mediaiso_a4_210x297mm第一條命令里-p office-printer是給本機(jī)起的隊(duì)列名-E表示同時(shí)啟用該隊(duì)列-v指定設(shè)備 URI-m everywhere表示使用驅(qū)動(dòng)less模式不指定廠商 PPD而是讓打印服務(wù)組件啟動(dòng)時(shí)去打印機(jī)上動(dòng)態(tài)抓取能力。之后用lpstat -p office-printer查看隊(duì)列狀態(tài)如果顯示idle并且沒(méi)有disabled說(shuō)明隊(duì)列已經(jīng)可用lpoptions設(shè)置默認(rèn)紙張為 A4這一步在跨區(qū)域使用設(shè)備時(shí)特別重要。-m everywhere是目前最推薦的做法前提是設(shè)備支持 IPP Everywhere。換句話說(shuō)第 3 章看到的document-format-supported就是它后續(xù)協(xié)商的基礎(chǔ)服務(wù)組件會(huì)直接生成一個(gè)臨時(shí) PPD這個(gè) PPD 里寫(xiě)著設(shè)備支持的紙型、解析度、色彩能力而不是從廠商安裝盤里找。如果設(shè)備不支持動(dòng)態(tài)能力發(fā)現(xiàn)-m everywhere可能會(huì)失敗此時(shí)退回到-m raw可以先把隊(duì)列建起來(lái)但 raw 模式下系統(tǒng)不控制頁(yè)面尺寸和格式只把數(shù)據(jù)直接透?jìng)鹘o打印機(jī)。所以raw只適合應(yīng)急不能當(dāng)長(zhǎng)期方案。4.2 driverless: URI 與 IPP Everywhere從自動(dòng)發(fā)現(xiàn)到接入在打印服務(wù)組件的語(yǔ)境里driverless是能力和 PPD 之間的橋梁。你不需要自己找驅(qū)動(dòng)只要確認(rèn)設(shè)備支持 IPP系統(tǒng)就能通過(guò)Get-Printer-Attributes拿到media-supported、resolution-supported、print-color-mode-supported再把這些屬性翻譯成打印選項(xiàng)。這也是為什么很多人配好的ipp://隊(duì)列在安裝界面里看不到廠家驅(qū)動(dòng)但打出來(lái)的效果反而比老驅(qū)動(dòng)正常。接入時(shí)還要注意 URI 的路徑差異。同樣是支持 IPP 的設(shè)備有的路徑是/ipp/print有的是/ipp/printers/myprinter有的只在ipps://上開(kāi)放。我一般會(huì)在配置前先執(zhí)行一次lpinfo -v | grep -i ipp讓打印服務(wù)組件掃描局域網(wǎng)網(wǎng)絡(luò)服務(wù)看它發(fā)現(xiàn)的實(shí)際 URI。這個(gè)命令會(huì)列出類似ipp://192.168.1.50:631/ipp/print的地址比手填更可靠。手動(dòng)填寫(xiě)時(shí)最怕把廠商 Web 管理頁(yè)的地址當(dāng)成打印機(jī) URI那樣隊(duì)列會(huì)一直處于“無(wú)法連接”狀態(tài)。如果你接的是帶加密的ipps://第一件事不是想著關(guān) TLS而是把打印機(jī)的根證書(shū)導(dǎo)入系統(tǒng)信任庫(kù)。自簽名證書(shū)的常見(jiàn)問(wèn)題會(huì)在第 5 章展開(kāi)這里先記住IPP over TLS 的默認(rèn)端口仍然可能是 631不要一見(jiàn) 443 就以為肯定是 IPPS也不要把 80 端口的 Web 管理頁(yè)當(dāng)成 IPP。4.3 移動(dòng)端和AirPrint的落地原來(lái)是同一套移動(dòng)端免驅(qū)打印能“自動(dòng)發(fā)現(xiàn)打印機(jī)、不用裝驅(qū)動(dòng)”是因?yàn)槭謾C(jī)系統(tǒng)在局域網(wǎng)里通過(guò) DNS-SD 找到了_ipp._tcp服務(wù)拿到 Printer URI 后用和ipptool一樣的 IPP 請(qǐng)求去拿打印機(jī)能力再把文檔轉(zhuǎn)成打印機(jī)接受的光柵格式提交。也就是說(shuō)你在服務(wù)組件里配好的ipp://隊(duì)列天然可以被移動(dòng)端發(fā)現(xiàn)前提是這臺(tái)機(jī)器開(kāi)啟了服務(wù)發(fā)現(xiàn)廣播。對(duì)做設(shè)備集成的工程師來(lái)說(shuō)這里有一個(gè)值得記下來(lái)的點(diǎn)如果自研設(shè)備想讓手機(jī)直接打印不需要去適配各家私有協(xié)議只需要對(duì)外暴露一個(gè)符合 IPP 的端點(diǎn)比如/ipp/print同時(shí)廣播_ipp._tcp服務(wù)即可。設(shè)備端要自己實(shí)現(xiàn)至少Get-Printer-Attributes和Print-Job兩個(gè)操作返回document-format-supported時(shí)列出的格式就是移動(dòng)端會(huì)嘗試使用的格式。如果它發(fā)現(xiàn)支持image/pwg-raster就會(huì)把頁(yè)面渲染成該格式再打。所以前面那些ipptool命令不是玩具它們與手機(jī)實(shí)際的握手流程基本相同。唯一區(qū)別是手機(jī)更多用服務(wù)發(fā)現(xiàn)自動(dòng)填充 URI而手工配置時(shí) URI 要靠人填。理解這一點(diǎn)后你在排手機(jī)打印失靈的問(wèn)題時(shí)思路會(huì)從“是不是系統(tǒng)問(wèn)題”變成“這個(gè)端點(diǎn)的 IPP 請(qǐng)求到底返回了什么”排查維度完全不同。5. IPP調(diào)試與避坑我踩過(guò)的5個(gè)常見(jiàn)問(wèn)題這一章完全是一線踩坑的記錄。IPP 本身不算復(fù)雜但因?yàn)樗?HTTP、端口、Web 管理頁(yè)、加密這些東西混在一起配置時(shí)總會(huì)有幾個(gè)“怎么想都不對(duì)”的時(shí)刻。以下五條按從網(wǎng)絡(luò)到應(yīng)用的順序?qū)懨織l都是真實(shí)翻過(guò)車的。5.1 端口631連不上但打印機(jī)明明通著現(xiàn)象用nc -vz 192.168.1.50 631測(cè)試超時(shí)但打印機(jī)面板能進(jìn)廠商 Web 管理端也能打開(kāi)。原因這臺(tái)設(shè)備的 IPP 服務(wù)不在 631 端口或者 631 端口被安全策略關(guān)掉了只保留 Web 管理端口。解決不要硬猜優(yōu)先用設(shè)備廣播的服務(wù)發(fā)現(xiàn)結(jié)果?？梢栽谠O(shè)備 Web 管理端里找“網(wǎng)絡(luò)打印 / IPP / 協(xié)議設(shè)置”這類入口把 IPP 打印服務(wù)打開(kāi)記下它提示的 URL。我遇到過(guò)一個(gè)型號(hào)它的 IPP 端點(diǎn)端口是 8080路徑是/ipp/print而 631 留給了一個(gè)早就淘汰的 LPR 服務(wù)。后來(lái)靠設(shè)備說(shuō)明書(shū)里的打印服務(wù)器配置頁(yè)才找到真實(shí) URI。所以第 2 章強(qiáng)調(diào)“端口 631 不等于 IPP”這里是血淚印證。碰到nc不通第一反應(yīng)不該是“不支持 IPP”而是“我們猜的端口和路徑不對(duì)”。5.2 作業(yè)已接受但打印機(jī)長(zhǎng)時(shí)間不打印現(xiàn)象ipptool返回successful-ok響應(yīng)里也有job-id但打印機(jī)面板上一直沒(méi)有作業(yè)。原因設(shè)備把作業(yè)放進(jìn)了 Hold 隊(duì)列等待面板確認(rèn)或者 PDF 格式被接收但 RIP 解析失敗作業(yè)停在 pending / held 狀態(tài)。解決提交完成后立刻用Get-Jobs或Get-Job-Attributes查job-state-reasons這個(gè)屬性會(huì)告訴你為什么停著。常見(jiàn)值里job-hold-until-specified表示設(shè)備被設(shè)置成“先暫存再打印”compression-error表示數(shù)據(jù)解壓失敗document-format-error表示格式內(nèi)容損壞?？吹?held 后去設(shè)備面板上釋放作業(yè)或者通過(guò)Set-Job-Attributes把job-hold-until改成no-hold。不要因?yàn)榈谝话l(fā)沒(méi)出來(lái)就反復(fù)提交否則隊(duì)列會(huì)被撐滿最后連狀態(tài)查詢都變慢。5.3 用curl查631端口看到HTML誤以為設(shè)備支持IPP現(xiàn)象curl http://192.168.1.50:631/返回一個(gè) HTML 管理頁(yè)于是判斷“這家打印機(jī)走 IPP”配置后隊(duì)列卻一直報(bào)無(wú)法連接。原因631 端口上同時(shí)有 HTTP 管理服務(wù)瀏覽器訪問(wèn)根路徑拿到的是 HTML 頁(yè)面IPP 的二進(jìn)制請(qǐng)求必須 POST 到具體路徑比如/ipp/print而且請(qǐng)求體不是普通表單。解決用ipptool而不是 curl 去驗(yàn)證。curl 能拿到 HTML 只能說(shuō)明該端口有 HTTP 服務(wù)不能說(shuō)明它是 IPP。這個(gè)誤區(qū)之所以常見(jiàn)是因?yàn)楹芏啻蛴》?wù)器把自己的狀態(tài)頁(yè)也放在 631 上根路徑和 IPP 端點(diǎn)共存。正確習(xí)慣是寫(xiě)一個(gè)小測(cè)試文件用ipptool -tv ipp://host/ipp/print getattrs.test跑一次看返回狀態(tài)。如果路徑不對(duì)就把/ipp/print換成/ipp再看。翻車幾次后你會(huì)發(fā)現(xiàn)路徑調(diào)試比端口調(diào)試花的時(shí)間多得多。5.4 認(rèn)證/TLS導(dǎo)致無(wú)論是ipptool還是打印服務(wù)組件都無(wú)法協(xié)商現(xiàn)象ipptool請(qǐng)求返回client-error-not-authenticated或者日志里出現(xiàn) SSL/TLS 握手失敗同一個(gè) URI 換了網(wǎng)絡(luò)環(huán)境又好了。原因打印機(jī)只允許認(rèn)證用戶訪問(wèn) IPP或者只開(kāi)放ipps://并要求 TLS且證書(shū)不受本機(jī)信任。解決優(yōu)先改用ipps://把打印機(jī)根證書(shū)導(dǎo)入系統(tǒng)信任庫(kù)如果只是臨時(shí)測(cè)試且設(shè)備允許關(guān)閉加密可以明確配置成局域網(wǎng)ipp://但不要在生產(chǎn)環(huán)境關(guān)掉。這里要特別提醒自簽名證書(shū)的主機(jī)名不匹配也會(huì)導(dǎo)致握手失敗明明打印機(jī) IP 是對(duì)的證書(shū)里寫(xiě)的卻是出廠序列號(hào)。這在打印服務(wù)組件里會(huì)被記成“認(rèn)證失敗”誤導(dǎo)很多人去查賬號(hào)密碼。如果你用的是帶證書(shū)的設(shè)備先檢查證書(shū)里的 Common Name 是否與訪問(wèn) IP 一致再檢查系統(tǒng)信任庫(kù)。證書(shū)問(wèn)題不解決后面所有屬性請(qǐng)求都不會(huì)成功。5.5 設(shè)置屬性后打印機(jī)“選擇忽略”Finishings與media現(xiàn)象提交作業(yè)時(shí)帶上finishings4表示裝訂和mediaiso_a4_210x297mm打印機(jī)打出來(lái)卻沒(méi)有裝訂紙張也不是標(biāo)準(zhǔn) A4。原因沒(méi)有先看打印機(jī)的finishings-supported、media-supported或者設(shè)備要求用finishings-col、media-col這類集合屬性而不是簡(jiǎn)單屬性。解決先用Get-Printer-Attributes把支持列表拉出來(lái)再按支持列表提交。不同廠商對(duì)裝訂、折頁(yè)這類能力的定義差異很大同一臺(tái)機(jī)器的固件升級(jí)前后也可能改屬性結(jié)構(gòu)。有的設(shè)備只認(rèn)media-col里的media結(jié)構(gòu)體你只傳media字符串時(shí)它會(huì)靜默忽略。遇到這類情況不要盲目加大參數(shù)先用ipptool發(fā)一個(gè)只帶requested-attributes finishings-supported的請(qǐng)求把枚舉值記下來(lái)。屬性協(xié)商本來(lái)就是 IPP 的強(qiáng)項(xiàng)我們卻經(jīng)常把它當(dāng)普通 HTTP 表單處理這大概是這個(gè)協(xié)議最大的“人文陷阱”。6. 進(jìn)階把IPP當(dāng)服務(wù)來(lái)調(diào)試學(xué)會(huì)這三個(gè)技能少翻車6.1 用 tcpdump 只抓 631 端口比看驅(qū)動(dòng)日志快驅(qū)動(dòng)日志往往只告訴你“作業(yè)錯(cuò)誤”不告訴你打印機(jī)到底回了什么。遇到奇怪問(wèn)題時(shí)我習(xí)慣先抓包tcpdump -i eth0 -s 0 -w /tmp/ipp.pcap port 631把文件留給抓包工具去解析重點(diǎn)看 IPP 響應(yīng)里的狀態(tài)碼和job-state-reasons。抓包的好處是能看到客戶端實(shí)際發(fā)出的屬性很多“打印機(jī)不聽(tīng)話”其實(shí)是客戶端傳錯(cuò)屬性名。6.2 把 ipptool 請(qǐng)求存成測(cè)試文件回歸驗(yàn)證不再靠手敲我一般會(huì)把Get-Printer-Attributes和Print-Job寫(xiě)進(jìn)兩個(gè)獨(dú)立文件存成/tmp/getattrs.test和/tmp/printjob.test。調(diào)試設(shè)備時(shí)每次只需ipptool -tv ipp://$DEVICE_IP/ipp/print /tmp/getattrs.test這樣變量只出現(xiàn)在命令行里測(cè)試文件作為資產(chǎn)留檔同一臺(tái)設(shè)備升級(jí)固件后可以用它快速驗(yàn)證能力有沒(méi)有變。沒(méi)有測(cè)試文件每次手敲 heredoc很容易漏掉attributes-charset或printer-uri。6.3 驗(yàn)證端到端能力、提交、隊(duì)列三連查我的驗(yàn)證順序固定是先看printer-state再看document-format-supported提交后查Get-Jobs。任何一步不通過(guò)直接看對(duì)應(yīng)屬性不猜原因。這套流程在接入新設(shè)備時(shí)最多十分鐘跑完。這幾次踩坑后我養(yǎng)成了一個(gè)習(xí)慣凡是路由器和打印設(shè)備過(guò)來(lái)第一件事先跑一遍Get-Printer-Attributes留檔很多配置問(wèn)題在第一步就能看出來(lái)。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取 IPP網(wǎng)絡(luò)打印協(xié)議解析：從驅(qū)動(dòng)less打印到ipptool調(diào)試與配置實(shí)戰(zhàn)
簡(jiǎn)介這是一份面向網(wǎng)絡(luò)開(kāi)發(fā)者的 IPP 網(wǎng)絡(luò)打印協(xié)議源碼包完整呈現(xiàn)基于 HTTP/1.1 的打印作業(yè)提交、打印機(jī)狀態(tài)查詢、作業(yè)控制及屬性擴(kuò)展等標(biāo)準(zhǔn)實(shí)現(xiàn)強(qiáng)調(diào)跨平臺(tái)設(shè)備間的互操作性適合需要開(kāi)發(fā)打印客戶端、研究協(xié)議解析或進(jìn)行系統(tǒng)集成的人員參考。包內(nèi)共 32 個(gè)文件以 C 語(yǔ)言源文件.c/.h為主體配合 Makefile 與 format 配置文件構(gòu)成可構(gòu)建的協(xié)議框架另含 svn-base 版本元數(shù)據(jù)與 README 說(shuō)明整體僅 35KB結(jié)構(gòu)緊湊便于快速閱讀。當(dāng)前已有 3860 人學(xué)習(xí)下載源碼重點(diǎn)覆蓋請(qǐng)求/響應(yīng)解析、狀態(tài)機(jī)流轉(zhuǎn)、IPP 數(shù)據(jù)編碼、錯(cuò)誤處理以及基于 HTTPS 的安全通信等模塊讀者可從底層報(bào)文開(kāi)始理解協(xié)議工作流程。對(duì)于希望自定義打印方案或排查跨平臺(tái)打印問(wèn)題的開(kāi)發(fā)者這份代碼提供了可直接研讀的實(shí)例與擴(kuò)展基礎(chǔ)。1. IPP網(wǎng)絡(luò)打印協(xié)議為什么現(xiàn)在驅(qū)動(dòng)less打印都在喊它打印機(jī)驅(qū)動(dòng)裝不上設(shè)備明明連著局域網(wǎng)系統(tǒng)里卻只給你一堆 LPR 或 Raw Queue 端口——這是做網(wǎng)絡(luò)打印集成最常見(jiàn)的開(kāi)局。IPP網(wǎng)絡(luò)打印協(xié)議Internet Printing Protocol就是為了結(jié)束這種黑匣子狀態(tài)它把打印動(dòng)作變成基于 HTTP 的標(biāo)準(zhǔn)請(qǐng)求作業(yè)提交、狀態(tài)查詢、能力協(xié)商都能用明文請(qǐng)求和響應(yīng)去驗(yàn)證。它能解決的是驅(qū)動(dòng)缺失、跨平臺(tái)支持、移動(dòng)端免驅(qū)打印這類問(wèn)題適合設(shè)備集成、運(yùn)維工程師以及準(zhǔn)備在自研系統(tǒng)里接入打印能力的人。接下來(lái)我不背協(xié)議編號(hào)而是把 IPP 當(dāng)服務(wù)去拆先認(rèn)屬性再用手頭工具摸清設(shè)備最后配進(jìn)打印服務(wù)組件并處理那些翻車點(diǎn)。2. 先看懂IPP它與LPR/SMB的差別和你要記住的三個(gè)屬性在動(dòng)手敲命令前我得先把一個(gè)常見(jiàn)誤解糾正過(guò)來(lái)IPP 不是像 LPR 那樣“提交完就進(jìn)隊(duì)列、狀態(tài)全靠猜”它是一套自帶屬性查詢的 RPC 式協(xié)議。新手最容易把 IPP 和打印驅(qū)動(dòng)混在一起實(shí)際上 IPP 關(guān)心的不是光柵怎么拼而是“能不能打、打成什么樣、當(dāng)前什么狀態(tài)”。下面從協(xié)議骨架說(shuō)起順便把選型邏輯講清楚。2.1 IPP是“帶屬性的HTTP”端口631、二進(jìn)制請(qǐng)求、operationIPP 的傳輸層是 HTTP/1.1默認(rèn)端口 631數(shù)據(jù)體是二進(jìn)制編碼的請(qǐng)求和響應(yīng)。它把一次打印動(dòng)作包裝成一個(gè) operation request打印機(jī)或者打印服務(wù)器處理后返回 operation response?？蛻舳瞬恢惶峤蛔鳂I(yè)還可以先問(wèn)能力。這與 LPR/SMB 的差別很大LPR 只有簡(jiǎn)單的控制文件和數(shù)據(jù)文件沒(méi)有標(biāo)準(zhǔn)的狀態(tài)碼集合SMB 打印即便能共享隊(duì)列對(duì)網(wǎng)絡(luò)發(fā)現(xiàn)、TLS 和跨平臺(tái)屬性表達(dá)都很吃力。一次 IPP 調(diào)用的目標(biāo)叫 Printer URI形如ipp://192.168.1.50/ipp/print。客戶端 POST 一個(gè)二進(jìn)制請(qǐng)求到這個(gè) URI請(qǐng)求里必須有 Operation ID 和 Request ID。常見(jiàn)的 operation 如下表后面所有調(diào)試都繞不開(kāi)這幾個(gè)。Operation數(shù)值作用Print-Job0x0002提交打印作業(yè)文件內(nèi)容放在請(qǐng)求體內(nèi)Validate-Job0x0004只驗(yàn)證作業(yè)可不可打印不真正提交Get-Printer-Attributes0x000B獲取打印機(jī)的能力與當(dāng)前狀態(tài)Get-Jobs0x000A查詢排隊(duì)中的作業(yè)列表Cancel-Job0x0008取消指定作業(yè)如果你習(xí)慣的是 JSON 接口第一次看 IPP 會(huì)覺(jué)得它像黑匣子因?yàn)椴皇俏谋?。你無(wú)法用 curl 直接看懂響應(yīng)必須用專門的ipptool或者抓包看 631 端口。這也是為什么第 3 章全部以ipptool為主它能幫你把 IPP 的二進(jìn)制信封拆開(kāi)讓你看到屬性名和值。選型層面現(xiàn)代驅(qū)動(dòng)less打印之所以都選 IPP就是因?yàn)樗选安樵兡芰Α焙汀疤峤蛔鳂I(yè)”放進(jìn)同一個(gè)協(xié)議而不是像 LPR 那樣只能單向投遞。2.2 屬性樹(shù)Printer / Job / Document 三層別把三者搞混屬性是 IPP 的“參數(shù)數(shù)據(jù)庫(kù)”?？蛻舳撕头?wù)端交互時(shí)所有條件、能力、狀態(tài)都用名為“屬性”的鍵值對(duì)表達(dá)。值類型有很多keyword、boolean、integer、enum、resolution、rangeOfInteger 等每個(gè)屬性屬于一個(gè)“屬性組”在二進(jìn)制報(bào)文里以 tag 區(qū)分比如 operation-attributes-tag、printer-attributes-tag、job-attributes-tag。打印機(jī)端最重要的三層對(duì)象是 Printer、Job、Document。Printer 對(duì)象描述這臺(tái)設(shè)備能干什么printer-name、printer-stateidle/processing/stopped、printer-is-accepting-jobs、printer-up-time、document-format-supported都是這一層。Job 對(duì)象是你提交一次打印后產(chǎn)生的工作單job-id、job-state、job-state-reasons能告訴你作業(yè)是被處理、暫停還是卡紙。Document 對(duì)象描述文檔本身的屬性像document-format、document-natural-language很多場(chǎng)景下它不僅依附在 Job 上在提交請(qǐng)求里還要單獨(dú)用屬性組聲明。理解這個(gè)分層有助于排錯(cuò)例如你提交作業(yè)后打印機(jī)沒(méi)有任何反應(yīng)應(yīng)先查 Printer 層的printer-is-accepting-jobs與 Job 層的job-state-reasons而不是先去重裝驅(qū)動(dòng)。后面第 5 章就會(huì)遇到這類問(wèn)題。另外請(qǐng)求能力時(shí)用requested-attributes指定你想要的屬性名列表這個(gè)參數(shù)經(jīng)常被寫(xiě)錯(cuò)所以單獨(dú)強(qiáng)調(diào)一下它寫(xiě)在操作屬性組里值是 keyword 類型可以用all也可以傳多個(gè)屬性名。2.3 ipp:// 與 ipps://URI結(jié)構(gòu)、端口與“你看到的631未必是IPP”URI 是 IPP 的地址入口。標(biāo)準(zhǔn)格式是ipp://[用戶]主機(jī)[:端口]/路徑帶 TLS 時(shí)寫(xiě)ipps://默認(rèn)端口同樣習(xí)慣用 631不是常見(jiàn)的 443。路徑常見(jiàn)的是/ipp/print、/ipp、/printers/xxx廠商可以自行注冊(cè)路徑所以碰到具體設(shè)備時(shí)不要想當(dāng)然。這里最容易踩坑一臺(tái)打印機(jī)的 631 端口上可能同時(shí)站著 HTTP 管理服務(wù)和 IPP 服務(wù)根路徑是 HTML/ipp/print才是 IPP 端點(diǎn)。你用curl http://host:631/能得到 HTML不代表設(shè)備支持 IPP只能說(shuō)明它開(kāi)了 HTTP。正確的探測(cè)方式是用ipptool或設(shè)備廣播出來(lái)的服務(wù)發(fā)現(xiàn)結(jié)果不是瀏覽器。這個(gè)習(xí)慣能省掉后面一半時(shí)間。加密方面ipps://在同一個(gè) URI 上用 TLS 封裝 IPP證書(shū)常常是出廠自簽名第一次連接時(shí)打印服務(wù)組件會(huì)因?yàn)椤白C書(shū)未信任”把打印機(jī)標(biāo)記為認(rèn)證失敗這又是另一個(gè)獨(dú)立的坑。所以把“端口 631”和“協(xié)議是 IPP”分開(kāi)記憶比硬記端口安全得多。這一章最后補(bǔ)一個(gè)選型結(jié)論LPR 和 SMB 也不是不能用但在“無(wú)驅(qū)動(dòng)”“跨平臺(tái)”“作業(yè)狀態(tài)可查”這三個(gè)需求面前都要打折扣。IPP 的請(qǐng)求-響應(yīng)模型讓客戶端可以先問(wèn)能力再提交作業(yè)這正是當(dāng)前移動(dòng)端免驅(qū)打印方案的核心機(jī)制。所以標(biāo)題里說(shuō)的 IPP 網(wǎng)絡(luò)打印協(xié)議不是一個(gè)需要背的 RFC 編號(hào)而是一套能直接拿來(lái)測(cè)、拿來(lái)配、拿來(lái)寫(xiě)網(wǎng)關(guān)的和 HTTP 同源的協(xié)議。3. 用ipptool在本地把一臺(tái)IPP打印機(jī)摸清楚ipptool是能直接和打印機(jī)對(duì)話的命令行工具在多數(shù)帶打印服務(wù)的 Linux 發(fā)行版和桌面系統(tǒng)上都可以直接用它。它的好處是幫你把二進(jìn)制請(qǐng)求封裝好你只要寫(xiě)一個(gè)“測(cè)試文件”描述要發(fā)什么 operation、帶哪些屬性即可。下面三步是從“確認(rèn)支持”到“提交真實(shí)作業(yè)”的最小路徑。3.1 確認(rèn)設(shè)備支持IPP的最小命令一條ipptool加heredocipptool -tv ipp://192.168.1.50:631/ipp/print EOF { OPERATION Get-Printer-Attributes GROUP operation-attributes-tag ATTR charset attributes-charset utf-8 ATTR naturalLanguage attributes-natural-language en ATTR uri printer-uri $uri } EOF這里的-tv表示 verbose 輸出工具會(huì)把響應(yīng)的操作狀態(tài)碼和屬性值都打印出來(lái)$uri是 ipptool 自動(dòng)把命令行傳入的 Printer URI 當(dāng)作printer-uri屬性值所以你不用再重復(fù)寫(xiě) IP。請(qǐng)求里的 operation-attributes-tag 是必須的頭部屬性組attributes-charset、attributes-natural-language是 IPP 的兩個(gè)通用屬性每次都要帶。如果設(shè)備返回successful-ok說(shuō)明它確實(shí)支持 IPP如果返回client-error-not-found多半是路徑不對(duì)換/ipp或去設(shè)備 Web 管理端查真實(shí)路徑。這一條命令驗(yàn)證的事情比翻說(shuō)明書(shū)有價(jià)值它直接證明設(shè)備在 631 端口上響應(yīng) IPP 請(qǐng)求。后續(xù)所有配置都以這條命令返回successful-ok為前提。如果失敗先不要怪驅(qū)動(dòng)第一步就要懷疑 URI 路徑、端口、防火墻三層。3.2 讓打印機(jī)自己“報(bào)”能力requested-attributes 與 document-format-supported一旦確認(rèn)能通接下來(lái)就要問(wèn)打印機(jī)到底支持什么。很多同事在配置網(wǎng)絡(luò)打印時(shí)喜歡先在驅(qū)動(dòng)列表里找型號(hào)其實(shí) IPP 的正確姿勢(shì)是讓打印機(jī)自己告訴你它能吃哪些 document-format。下面請(qǐng)求只拉三個(gè)關(guān)鍵屬性。ipptool -tv ipp://192.168.1.50:631/ipp/print EOF { OPERATION Get-Printer-Attributes GROUP operation-attributes-tag ATTR charset attributes-charset utf-8 ATTR naturalLanguage attributes-natural-language en ATTR uri printer-uri $uri ATTR keyword requested-attributes printer-state ATTR keyword requested-attributes printer-is-accepting-jobs ATTR keyword requested-attributes document-format-supported } EOFrequested-attributes可以重復(fù)聲明每個(gè)屬性名是 keyword 類型。常見(jiàn)的響應(yīng)里printer-state是數(shù)字枚舉3 表示 idle4 表示 processing5 表示 stoppedprinter-is-accepting-jobs是 booleandocument-format-supported會(huì)列出類似application/pdf、image/pwg-raster、image/jpeg這樣的 MIME 類型。這就是之后提交作業(yè)要用的依據(jù)打印機(jī)聲明支持什么我們就提什么而不是想當(dāng)然發(fā) PDF 或 PS。有一個(gè)常見(jiàn)誤用以為支持application/pdf就代表支持高分辨率 / 光柵格式這完全兩回事。有些設(shè)備 PDF 解析能力有限但image/pwg-raster是它的原生格式有些兼容設(shè)備反而對(duì) PWG 支持不完整。所以在接入新設(shè)備時(shí)我一般會(huì)把document-format-supported完整列表存下來(lái)當(dāng)作后續(xù)提交參數(shù)的“白名單”。這一步做扎實(shí)后面作業(yè)被拒的概率會(huì)低很多。3.3 提交一個(gè)真實(shí)作業(yè)Print-Job、document-format 與 FILE/DATA 的區(qū)別驗(yàn)證能力之后就到了真正提交作業(yè)的環(huán)節(jié)。用Print-Job并帶上一個(gè)本地文件是最直接的端到端測(cè)試。ipptool -tv ipp://192.168.1.50:631/ipp/print EOF { OPERATION Print-Job GROUP operation-attributes-tag ATTR charset attributes-charset utf-8 ATTR naturalLanguage attributes-natural-language en ATTR uri printer-uri $uri GROUP job-attributes-tag ATTR mimeMediaType document-format application/pdf ATTR name job-name test-ipp-job FILE /tmp/test.pdf } EOFFILE /tmp/test.pdf會(huì)把文件內(nèi)容作為請(qǐng)求體發(fā)給打印機(jī)和 HTTP POST 的 body 概念一樣。document-format必須放在 job-attributes-tag 屬性組里告訴打印機(jī)這份數(shù)據(jù)是什么格式。如果打印機(jī)不認(rèn)這個(gè)格式響應(yīng)里會(huì)出現(xiàn)client-error-document-format-not-supported如果提交成功響應(yīng)里會(huì)帶job-id和job-uri這兩個(gè)值需要記下來(lái)后面查詢和取消作業(yè)都用得上。FILE和DATA的區(qū)別是FILE引用磁盤上的二進(jìn)制文件適合 PDF、PWG 光柵DATA直接把后面的字符串當(dāng)作文檔內(nèi)容適合快速測(cè)試純文本。測(cè)試純文本輸出時(shí)把document-format改成text/plain然后寫(xiě)DATA hello world就可以。提交之后如果想確認(rèn)作業(yè)是否真的進(jìn)入隊(duì)列再補(bǔ)一個(gè) Get-Jobs看返回的job-id是否在列表里。這樣一個(gè)完整的 IPP 客戶端驗(yàn)證流程就閉環(huán)了。4. 在打印服務(wù)組件里接一個(gè)IPP打印機(jī)URI、驅(qū)動(dòng)與端口的參數(shù)怎么設(shè)上一章證明了設(shè)備能通接下來(lái)要把它納入系統(tǒng)打印服務(wù)。這里以最常見(jiàn)的打印服務(wù)組件命令行工具為例。配置的關(guān)鍵點(diǎn)不是“選驅(qū)動(dòng)”而是“URI 對(duì)不對(duì)”和“用什么模式讓它自動(dòng)取能力”。4.1 用 lpadmin 配置 IPP 打印機(jī)的最小命令lpadmin -p office-printer -E -v ipp://192.168.1.50:631/ipp/print -m everywhere lpstat -p office-printer lpoptions -p office-printer -o mediaiso_a4_210x297mm第一條命令里-p office-printer是給本機(jī)起的隊(duì)列名-E表示同時(shí)啟用該隊(duì)列-v指定設(shè)備 URI-m everywhere表示使用驅(qū)動(dòng)less模式不指定廠商 PPD而是讓打印服務(wù)組件啟動(dòng)時(shí)去打印機(jī)上動(dòng)態(tài)抓取能力。之后用lpstat -p office-printer查看隊(duì)列狀態(tài)如果顯示idle并且沒(méi)有disabled說(shuō)明隊(duì)列已經(jīng)可用lpoptions設(shè)置默認(rèn)紙張為 A4這一步在跨區(qū)域使用設(shè)備時(shí)特別重要。-m everywhere是目前最推薦的做法前提是設(shè)備支持 IPP Everywhere。換句話說(shuō)第 3 章看到的document-format-supported就是它后續(xù)協(xié)商的基礎(chǔ)服務(wù)組件會(huì)直接生成一個(gè)臨時(shí) PPD這個(gè) PPD 里寫(xiě)著設(shè)備支持的紙型、解析度、色彩能力而不是從廠商安裝盤里找。如果設(shè)備不支持動(dòng)態(tài)能力發(fā)現(xiàn)-m everywhere可能會(huì)失敗此時(shí)退回到-m raw可以先把隊(duì)列建起來(lái)但 raw 模式下系統(tǒng)不控制頁(yè)面尺寸和格式只把數(shù)據(jù)直接透?jìng)鹘o打印機(jī)。所以raw只適合應(yīng)急不能當(dāng)長(zhǎng)期方案。4.2 driverless: URI 與 IPP Everywhere從自動(dòng)發(fā)現(xiàn)到接入在打印服務(wù)組件的語(yǔ)境里driverless是能力和 PPD 之間的橋梁。你不需要自己找驅(qū)動(dòng)只要確認(rèn)設(shè)備支持 IPP系統(tǒng)就能通過(guò)Get-Printer-Attributes拿到media-supported、resolution-supported、print-color-mode-supported再把這些屬性翻譯成打印選項(xiàng)。這也是為什么很多人配好的ipp://隊(duì)列在安裝界面里看不到廠家驅(qū)動(dòng)但打出來(lái)的效果反而比老驅(qū)動(dòng)正常。接入時(shí)還要注意 URI 的路徑差異。同樣是支持 IPP 的設(shè)備有的路徑是/ipp/print有的是/ipp/printers/myprinter有的只在ipps://上開(kāi)放。我一般會(huì)在配置前先執(zhí)行一次lpinfo -v | grep -i ipp讓打印服務(wù)組件掃描局域網(wǎng)網(wǎng)絡(luò)服務(wù)看它發(fā)現(xiàn)的實(shí)際 URI。這個(gè)命令會(huì)列出類似ipp://192.168.1.50:631/ipp/print的地址比手填更可靠。手動(dòng)填寫(xiě)時(shí)最怕把廠商 Web 管理頁(yè)的地址當(dāng)成打印機(jī) URI那樣隊(duì)列會(huì)一直處于“無(wú)法連接”狀態(tài)。如果你接的是帶加密的ipps://第一件事不是想著關(guān) TLS而是把打印機(jī)的根證書(shū)導(dǎo)入系統(tǒng)信任庫(kù)。自簽名證書(shū)的常見(jiàn)問(wèn)題會(huì)在第 5 章展開(kāi)這里先記住IPP over TLS 的默認(rèn)端口仍然可能是 631不要一見(jiàn) 443 就以為肯定是 IPPS也不要把 80 端口的 Web 管理頁(yè)當(dāng)成 IPP。4.3 移動(dòng)端和AirPrint的落地原來(lái)是同一套移動(dòng)端免驅(qū)打印能“自動(dòng)發(fā)現(xiàn)打印機(jī)、不用裝驅(qū)動(dòng)”是因?yàn)槭謾C(jī)系統(tǒng)在局域網(wǎng)里通過(guò) DNS-SD 找到了_ipp._tcp服務(wù)拿到 Printer URI 后用和ipptool一樣的 IPP 請(qǐng)求去拿打印機(jī)能力再把文檔轉(zhuǎn)成打印機(jī)接受的光柵格式提交。也就是說(shuō)你在服務(wù)組件里配好的ipp://隊(duì)列天然可以被移動(dòng)端發(fā)現(xiàn)前提是這臺(tái)機(jī)器開(kāi)啟了服務(wù)發(fā)現(xiàn)廣播。對(duì)做設(shè)備集成的工程師來(lái)說(shuō)這里有一個(gè)值得記下來(lái)的點(diǎn)如果自研設(shè)備想讓手機(jī)直接打印不需要去適配各家私有協(xié)議只需要對(duì)外暴露一個(gè)符合 IPP 的端點(diǎn)比如/ipp/print同時(shí)廣播_ipp._tcp服務(wù)即可。設(shè)備端要自己實(shí)現(xiàn)至少Get-Printer-Attributes和Print-Job兩個(gè)操作返回document-format-supported時(shí)列出的格式就是移動(dòng)端會(huì)嘗試使用的格式。如果它發(fā)現(xiàn)支持image/pwg-raster就會(huì)把頁(yè)面渲染成該格式再打。所以前面那些ipptool命令不是玩具它們與手機(jī)實(shí)際的握手流程基本相同。唯一區(qū)別是手機(jī)更多用服務(wù)發(fā)現(xiàn)自動(dòng)填充 URI而手工配置時(shí) URI 要靠人填。理解這一點(diǎn)后你在排手機(jī)打印失靈的問(wèn)題時(shí)思路會(huì)從“是不是系統(tǒng)問(wèn)題”變成“這個(gè)端點(diǎn)的 IPP 請(qǐng)求到底返回了什么”排查維度完全不同。5. IPP調(diào)試與避坑我踩過(guò)的5個(gè)常見(jiàn)問(wèn)題這一章完全是一線踩坑的記錄。IPP 本身不算復(fù)雜但因?yàn)樗?HTTP、端口、Web 管理頁(yè)、加密這些東西混在一起配置時(shí)總會(huì)有幾個(gè)“怎么想都不對(duì)”的時(shí)刻。以下五條按從網(wǎng)絡(luò)到應(yīng)用的順序?qū)懨織l都是真實(shí)翻過(guò)車的。5.1 端口631連不上但打印機(jī)明明通著現(xiàn)象用nc -vz 192.168.1.50 631測(cè)試超時(shí)但打印機(jī)面板能進(jìn)廠商 Web 管理端也能打開(kāi)。原因這臺(tái)設(shè)備的 IPP 服務(wù)不在 631 端口或者 631 端口被安全策略關(guān)掉了只保留 Web 管理端口。解決不要硬猜優(yōu)先用設(shè)備廣播的服務(wù)發(fā)現(xiàn)結(jié)果?？梢栽谠O(shè)備 Web 管理端里找“網(wǎng)絡(luò)打印 / IPP / 協(xié)議設(shè)置”這類入口把 IPP 打印服務(wù)打開(kāi)記下它提示的 URL。我遇到過(guò)一個(gè)型號(hào)它的 IPP 端點(diǎn)端口是 8080路徑是/ipp/print而 631 留給了一個(gè)早就淘汰的 LPR 服務(wù)。后來(lái)靠設(shè)備說(shuō)明書(shū)里的打印服務(wù)器配置頁(yè)才找到真實(shí) URI。所以第 2 章強(qiáng)調(diào)“端口 631 不等于 IPP”這里是血淚印證。碰到nc不通第一反應(yīng)不該是“不支持 IPP”而是“我們猜的端口和路徑不對(duì)”。5.2 作業(yè)已接受但打印機(jī)長(zhǎng)時(shí)間不打印現(xiàn)象ipptool返回successful-ok響應(yīng)里也有job-id但打印機(jī)面板上一直沒(méi)有作業(yè)。原因設(shè)備把作業(yè)放進(jìn)了 Hold 隊(duì)列等待面板確認(rèn)或者 PDF 格式被接收但 RIP 解析失敗作業(yè)停在 pending / held 狀態(tài)。解決提交完成后立刻用Get-Jobs或Get-Job-Attributes查job-state-reasons這個(gè)屬性會(huì)告訴你為什么停著。常見(jiàn)值里job-hold-until-specified表示設(shè)備被設(shè)置成“先暫存再打印”compression-error表示數(shù)據(jù)解壓失敗document-format-error表示格式內(nèi)容損壞?？吹?held 后去設(shè)備面板上釋放作業(yè)或者通過(guò)Set-Job-Attributes把job-hold-until改成no-hold。不要因?yàn)榈谝话l(fā)沒(méi)出來(lái)就反復(fù)提交否則隊(duì)列會(huì)被撐滿最后連狀態(tài)查詢都變慢。5.3 用curl查631端口看到HTML誤以為設(shè)備支持IPP現(xiàn)象curl http://192.168.1.50:631/返回一個(gè) HTML 管理頁(yè)于是判斷“這家打印機(jī)走 IPP”配置后隊(duì)列卻一直報(bào)無(wú)法連接。原因631 端口上同時(shí)有 HTTP 管理服務(wù)瀏覽器訪問(wèn)根路徑拿到的是 HTML 頁(yè)面IPP 的二進(jìn)制請(qǐng)求必須 POST 到具體路徑比如/ipp/print而且請(qǐng)求體不是普通表單。解決用ipptool而不是 curl 去驗(yàn)證。curl 能拿到 HTML 只能說(shuō)明該端口有 HTTP 服務(wù)不能說(shuō)明它是 IPP。這個(gè)誤區(qū)之所以常見(jiàn)是因?yàn)楹芏啻蛴》?wù)器把自己的狀態(tài)頁(yè)也放在 631 上根路徑和 IPP 端點(diǎn)共存。正確習(xí)慣是寫(xiě)一個(gè)小測(cè)試文件用ipptool -tv ipp://host/ipp/print getattrs.test跑一次看返回狀態(tài)。如果路徑不對(duì)就把/ipp/print換成/ipp再看。翻車幾次后你會(huì)發(fā)現(xiàn)路徑調(diào)試比端口調(diào)試花的時(shí)間多得多。5.4 認(rèn)證/TLS導(dǎo)致無(wú)論是ipptool還是打印服務(wù)組件都無(wú)法協(xié)商現(xiàn)象ipptool請(qǐng)求返回client-error-not-authenticated或者日志里出現(xiàn) SSL/TLS 握手失敗同一個(gè) URI 換了網(wǎng)絡(luò)環(huán)境又好了。原因打印機(jī)只允許認(rèn)證用戶訪問(wèn) IPP或者只開(kāi)放ipps://并要求 TLS且證書(shū)不受本機(jī)信任。解決優(yōu)先改用ipps://把打印機(jī)根證書(shū)導(dǎo)入系統(tǒng)信任庫(kù)如果只是臨時(shí)測(cè)試且設(shè)備允許關(guān)閉加密可以明確配置成局域網(wǎng)ipp://但不要在生產(chǎn)環(huán)境關(guān)掉。這里要特別提醒自簽名證書(shū)的主機(jī)名不匹配也會(huì)導(dǎo)致握手失敗明明打印機(jī) IP 是對(duì)的證書(shū)里寫(xiě)的卻是出廠序列號(hào)。這在打印服務(wù)組件里會(huì)被記成“認(rèn)證失敗”誤導(dǎo)很多人去查賬號(hào)密碼。如果你用的是帶證書(shū)的設(shè)備先檢查證書(shū)里的 Common Name 是否與訪問(wèn) IP 一致再檢查系統(tǒng)信任庫(kù)。證書(shū)問(wèn)題不解決后面所有屬性請(qǐng)求都不會(huì)成功。5.5 設(shè)置屬性后打印機(jī)“選擇忽略”Finishings與media現(xiàn)象提交作業(yè)時(shí)帶上finishings4表示裝訂和mediaiso_a4_210x297mm打印機(jī)打出來(lái)卻沒(méi)有裝訂紙張也不是標(biāo)準(zhǔn) A4。原因沒(méi)有先看打印機(jī)的finishings-supported、media-supported或者設(shè)備要求用finishings-col、media-col這類集合屬性而不是簡(jiǎn)單屬性。解決先用Get-Printer-Attributes把支持列表拉出來(lái)再按支持列表提交。不同廠商對(duì)裝訂、折頁(yè)這類能力的定義差異很大同一臺(tái)機(jī)器的固件升級(jí)前后也可能改屬性結(jié)構(gòu)。有的設(shè)備只認(rèn)media-col里的media結(jié)構(gòu)體你只傳media字符串時(shí)它會(huì)靜默忽略。遇到這類情況不要盲目加大參數(shù)先用ipptool發(fā)一個(gè)只帶requested-attributes finishings-supported的請(qǐng)求把枚舉值記下來(lái)。屬性協(xié)商本來(lái)就是 IPP 的強(qiáng)項(xiàng)我們卻經(jīng)常把它當(dāng)普通 HTTP 表單處理這大概是這個(gè)協(xié)議最大的“人文陷阱”。6. 進(jìn)階把IPP當(dāng)服務(wù)來(lái)調(diào)試學(xué)會(huì)這三個(gè)技能少翻車6.1 用 tcpdump 只抓 631 端口比看驅(qū)動(dòng)日志快驅(qū)動(dòng)日志往往只告訴你“作業(yè)錯(cuò)誤”不告訴你打印機(jī)到底回了什么。遇到奇怪問(wèn)題時(shí)我習(xí)慣先抓包tcpdump -i eth0 -s 0 -w /tmp/ipp.pcap port 631把文件留給抓包工具去解析重點(diǎn)看 IPP 響應(yīng)里的狀態(tài)碼和job-state-reasons。抓包的好處是能看到客戶端實(shí)際發(fā)出的屬性很多“打印機(jī)不聽(tīng)話”其實(shí)是客戶端傳錯(cuò)屬性名。6.2 把 ipptool 請(qǐng)求存成測(cè)試文件回歸驗(yàn)證不再靠手敲我一般會(huì)把Get-Printer-Attributes和Print-Job寫(xiě)進(jìn)兩個(gè)獨(dú)立文件存成/tmp/getattrs.test和/tmp/printjob.test。調(diào)試設(shè)備時(shí)每次只需ipptool -tv ipp://$DEVICE_IP/ipp/print /tmp/getattrs.test這樣變量只出現(xiàn)在命令行里測(cè)試文件作為資產(chǎn)留檔同一臺(tái)設(shè)備升級(jí)固件后可以用它快速驗(yàn)證能力有沒(méi)有變。沒(méi)有測(cè)試文件每次手敲 heredoc很容易漏掉attributes-charset或printer-uri。6.3 驗(yàn)證端到端能力、提交、隊(duì)列三連查我的驗(yàn)證順序固定是先看printer-state再看document-format-supported提交后查Get-Jobs。任何一步不通過(guò)直接看對(duì)應(yīng)屬性不猜原因。這套流程在接入新設(shè)備時(shí)最多十分鐘跑完。這幾次踩坑后我養(yǎng)成了一個(gè)習(xí)慣凡是路由器和打印設(shè)備過(guò)來(lái)第一件事先跑一遍Get-Printer-Attributes留檔很多配置問(wèn)題在第一步就能看出來(lái)。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取