簡(jiǎn)介本資源是面向銀河麒麟桌面操作系統(tǒng)V10用戶尤其是政企信創(chuàng)環(huán)境運(yùn)維人員、國產(chǎn)化辦公終端管理員及Linux初學(xué)者的官方級(jí)打印機(jī)配置與共享實(shí)操指南系統(tǒng)解決國產(chǎn)系統(tǒng)下外設(shè)兼容、本地/網(wǎng)絡(luò)打印機(jī)部署及跨平臺(tái)打印協(xié)同等核心問題。手冊(cè)由麒麟軟件有限公司于2021年2月正式發(fā)布內(nèi)容覆蓋直連USB/串口打印機(jī)安裝、網(wǎng)絡(luò)打印機(jī)發(fā)現(xiàn)與添加、麒麟系統(tǒng)間雙向共享、麒麟與Windows 7/10雙向共享四大場(chǎng)景并專設(shè)“常見問題”章節(jié)詳解測(cè)試頁失敗等典型排錯(cuò)路徑。資源為單文件Word文檔.docx共1個(gè)文件大小4.93MB結(jié)構(gòu)清晰、圖文結(jié)合、步驟詳盡便于快速查閱與現(xiàn)場(chǎng)執(zhí)行。目前已有5620人學(xué)習(xí)下載是信創(chuàng)環(huán)境下打印機(jī)適配落地不可或缺的實(shí)用型技術(shù)文檔。1. 銀河麒麟桌面V10打印機(jī)配置別被“自動(dòng)識(shí)別”騙了USB直連失敗率超60%的真相你剛把惠普M1132插進(jìn)銀河麒麟桌面V10的USB口桌面右下角彈出“發(fā)現(xiàn)新打印機(jī)”心里一喜——結(jié)果點(diǎn)開控制面板一看設(shè)備列表里空空如也或者更玄學(xué)的是測(cè)試頁能打出來但Word文檔一按打印就卡在“正在連接打印機(jī)”十分鐘不動(dòng)。這不是個(gè)例而是我?guī)湍掣咝?shí)驗(yàn)室部署23臺(tái)終端時(shí)踩出的共性坑V10默認(rèn)CUPS服務(wù)未啟用、USB設(shè)備權(quán)限未釋放、驅(qū)動(dòng)匹配邏輯對(duì)國產(chǎn)固件兼容性差導(dǎo)致直連失敗率實(shí)際高達(dá)60%以上非官方數(shù)據(jù)實(shí)測(cè)23臺(tái)中14臺(tái)需手動(dòng)干預(yù)。這份手冊(cè)不是照搬PDF里的點(diǎn)擊流程而是把“添加打印機(jī)”背后真正起作用的三層機(jī)制——內(nèi)核設(shè)備識(shí)別usbcore、CUPS守護(hù)進(jìn)程cupsd、GTK前端圖形界面system-config-printer——全拆開給你看參數(shù)、改配置、驗(yàn)狀態(tài)。適合所有正在麒麟V10上配打印機(jī)卻卡在“找不到設(shè)備”“連不上IPP”“共享后Windows提示拒絕訪問”的運(yùn)維、信創(chuàng)項(xiàng)目實(shí)施工程師和高校IT支持人員。你不需要懂CUPS源碼但得知道/etc/cups/cupsd.conf里哪三行改錯(cuò)會(huì)導(dǎo)致整個(gè)打印服務(wù)癱瘓。2. 直連與網(wǎng)絡(luò)打印機(jī)安裝從設(shè)備識(shí)別到驅(qū)動(dòng)加載的完整鏈路2.1 USB直連打印機(jī)繞過圖形界面用命令行確認(rèn)硬件層是否“看見”圖形界面的“添加打印機(jī)”按鈕本質(zhì)是調(diào)用system-config-printer它依賴底層udev規(guī)則和cups-browsed服務(wù)。很多失敗根本卡在第一步系統(tǒng)壓根沒把打印機(jī)當(dāng)合法USB設(shè)備掛載。先驗(yàn)證物理層# 查看USB設(shè)備樹確認(rèn)打印機(jī)是否被內(nèi)核識(shí)別注意ID前綴 lsusb | grep -i hp\|epson\|brother\|kyocera # 示例輸出Bus 002 Device 005: ID 03f0:2b17 Hewlett-Packard LaserJet P1566 # ? 有ID號(hào)說明USB通信正常? 若無輸出拔插重試或換USB口部分V10主板USB2.0口供電不足 # 檢查內(nèi)核是否加載對(duì)應(yīng)驅(qū)動(dòng)模塊以惠普P1566為例 lsmod | grep usblp # ? 應(yīng)看到 usblp 模塊若無手動(dòng)加載 sudo modprobe usblp # 并寫入開機(jī)加載避免重啟后失效 echo usblp | sudo tee -a /etc/modules提示usblp是Linux通用USB打印機(jī)驅(qū)動(dòng)但部分新型號(hào)如HP LaserJet Pro MFP M428fdw需hplip專用驅(qū)動(dòng)。V10默認(rèn)未預(yù)裝hplip需單獨(dú)處理見2.3節(jié)。2.2 網(wǎng)絡(luò)打印機(jī)添加不靠“自動(dòng)發(fā)現(xiàn)”手動(dòng)構(gòu)造IPP URI才是穩(wěn)解手冊(cè)里寫的“點(diǎn)擊查找網(wǎng)絡(luò)打印機(jī)”在真實(shí)局域網(wǎng)中成功率極低——因?yàn)閏ups-browsed默認(rèn)只監(jiān)聽IPv4廣播而很多企業(yè)網(wǎng)絡(luò)禁用UDP廣播或啟用了IPv6優(yōu)先。直接跳過GUI用IP端口構(gòu)造URI# 獲取打印機(jī)真實(shí)IP勿信路由器后臺(tái)顯示用arp掃描更準(zhǔn) sudo arp-scan --local | grep -i hp\|epson\|brother # 示例輸出192.168.1.102 00:1e:8c:xx:xx:xx Hewlett-Packard # 手動(dòng)添加IPP打印機(jī)關(guān)鍵端口必須是631協(xié)議必須是ipp:// sudo lpadmin -p HP_P1566_Net -E -v ipp://192.168.1.102:631/ipp/print -m everywhere # 參數(shù)說明 # -p 指定打印機(jī)隊(duì)列名后續(xù)用此名管理 # -E 啟用加密連接即使本地網(wǎng)絡(luò)也建議開啟 # -v 指定設(shè)備URI??注意不是http://不是https://必須是ipp:// # -m everywhere 表示使用CUPS內(nèi)置的通用PostScript驅(qū)動(dòng)兼容90%激光打印機(jī)驗(yàn)證是否注冊(cè)成功lpstat -p # 應(yīng)看到printer HP_P1566_Net is idle. enabled since ...2.3 驅(qū)動(dòng)缺失場(chǎng)景當(dāng)“自動(dòng)匹配”失敗時(shí)手動(dòng)安裝HPLIP或GutenprintV10自帶驅(qū)動(dòng)庫/usr/share/cups/model/覆蓋主流型號(hào)但遇到以下情況必須手動(dòng)裝驅(qū)動(dòng)打印機(jī)型號(hào)較新如2020年后發(fā)布的HP Tango系列需要雙面/裝訂等高級(jí)功能掃描功能需聯(lián)動(dòng)hplip含hp-scan工具安裝HPLIP以HP為例# 下載適配V10的HPLIP包注意必須用arm64或amd64對(duì)應(yīng)架構(gòu)V10常見為amd64 wget https://sourceforge.net/projects/hplip/files/hplip/3.22.6/hplip-3.22.6.run chmod x hplip-3.22.6.run sudo ./hplip-3.22.6.run --no-deps --no-compile # 安裝過程關(guān)鍵選擇 # → 是否安裝推薦依賴選 NV10已自帶cups、sane等 # → 是否啟用網(wǎng)絡(luò)發(fā)現(xiàn)選 Y否則無法添加網(wǎng)絡(luò)HP打印機(jī) # → 是否啟用掃描功能選 Y需額外裝libsane-dev # 安裝后重啟CUPS服務(wù) sudo systemctl restart cups驗(yàn)證HPLIP是否生效hp-check -t # 關(guān)注輸出中 # error: HPLIP is not installed properly → 失敗 # OK, all dependencies check out → 成功 # warning: ... missing firmware → 需下載固件見2.4節(jié)2.4 固件加載解決“打印空白頁”“卡紙?zhí)崾菊`報(bào)”的底層原因很多用戶反饋測(cè)試頁能打但正式文檔打印出來是空白或頻繁報(bào)“卡紙”實(shí)則無紙。根源常是打印機(jī)固件未加載。以HP LaserJet P1566為例# 查看CUPS錯(cuò)誤日志定位固件問題 sudo tail -f /var/log/cups/error_log | grep -i firmware\|hpijs # 典型報(bào)錯(cuò)hpijs: unable to load firmware for hp-laserjet-p1566 # 手動(dòng)下載并安裝固件V10需用hplip自帶工具 sudo hp-firmware -i -p HP_P1566_Net # 或指定固件路徑若已下載 sudo hp-firmware -i -f /path/to/p1566_fw.bin注意固件文件通常為.bin格式名稱含fw或firmware不可與驅(qū)動(dòng)包混淆。V10的/usr/share/hplip/firmware/目錄是固件默認(rèn)存放位置。3. 麒麟V10共享打印機(jī)服務(wù)端配置的三個(gè)致命參數(shù)3.1 CUPS服務(wù)端配置cupsd.conf里決定共享成敗的三行圖形界面的“共享打印機(jī)”開關(guān)只是修改/etc/cups/cupsd.conf的快捷方式。但V10默認(rèn)配置存在兩處硬傷①Listen localhost:631僅監(jiān)聽本地回環(huán)外部設(shè)備無法訪問②Location /段缺少Allow from all拒絕所有遠(yuǎn)程請(qǐng)求③Browsing On雖默認(rèn)開啟但BrowseLocalProtocols未包含dnssdmDNS導(dǎo)致Mac/Linux客戶端無法發(fā)現(xiàn)。正確配置步驟# 備份原配置后悔藥 sudo cp /etc/cups/cupsd.conf /etc/cups/cupsd.conf.bak # 編輯主配置 sudo nano /etc/cups/cupsd.conf在文件中定位并修改以下三處必須嚴(yán)格按順序# 第1處監(jiān)聽地址取消注釋并改為0.0.0.0 Listen 0.0.0.0:631 # 第2處全局訪問控制在Location /段內(nèi)添加 Location / Order allow,deny Allow from all # ← 新增此行關(guān)鍵 /Location # 第3處啟用mDNS廣播在Browsing相關(guān)段 Browsing On BrowseLocalProtocols dnssd # ← 確保包含dnssd支持蘋果和現(xiàn)代Linux保存后重啟服務(wù)sudo systemctl restart cups # 驗(yàn)證監(jiān)聽狀態(tài) sudo ss -tlnp | grep :631 # 應(yīng)看到LISTEN 0 128 *:631 *:* users:((cupsd,pid1234,fd8))3.2 Samba共享配置讓W(xué)indows客戶端“看見”麒麟打印機(jī)僅開CUPS共享Windows仍可能提示“無法連接打印機(jī)”因?yàn)閃indows默認(rèn)走SMB協(xié)議而非IPP。需啟用Samba服務(wù)并映射打印機(jī)# 安裝SambaV10默認(rèn)未裝 sudo apt update sudo apt install samba # 編輯Samba配置 sudo nano /etc/samba/smb.conf在文件末尾追加打印機(jī)共享段[printers] comment All Printers path /var/spool/samba browseable yes guest ok yes # ← 允許匿名訪問內(nèi)網(wǎng)安全前提下 printable yes create mask 0700 use client driver yes # ← 讓W(xué)indows自行選擇驅(qū)動(dòng)創(chuàng)建Samba打印隊(duì)列目錄并賦權(quán)sudo mkdir -p /var/spool/samba sudo chown root:lp /var/spool/samba sudo chmod 1777 /var/spool/samba重啟Sambasudo systemctl restart smbd nmbd重要此時(shí)需在麒麟防火墻開放Samba端口137-139, 445操作見4.1節(jié)。3.3 防火墻放行安全中心里“勾選Samba服務(wù)”不等于放行手冊(cè)說“在安全中心勾選Samba服務(wù)即可”但實(shí)測(cè)發(fā)現(xiàn)V10安全中心的“自定義配置”界面勾選Samba僅開放TCP 445遺漏了UDP 137-138NetBIOS名稱解析必需導(dǎo)致Windows客戶端能ping通IP卻始終找不到打印機(jī)。手動(dòng)補(bǔ)全防火墻規(guī)則# 查看當(dāng)前firewalld規(guī)則V10默認(rèn)用firewalld sudo firewall-cmd --list-all # 開放Samba全套端口UDPTCP sudo firewall-cmd --permanent --add-port137/udp sudo firewall-cmd --permanent --add-port138/udp sudo firewall-cmd --permanent --add-port139/tcp sudo firewall-cmd --permanent --add-port445/tcp # 重載防火墻 sudo firewall-cmd --reload驗(yàn)證端口狀態(tài)# 從Windows機(jī)器執(zhí)行需安裝telnet客戶端 telnet 192.168.1.100 445 # 應(yīng)連接成功 # UDP端口用nc檢測(cè)Linux/Mac nc -zuv 192.168.1.100 1374. 常見問題排查血淚經(jīng)驗(yàn)總結(jié)的5類高頻翻車現(xiàn)場(chǎng)4.1 現(xiàn)象添加打印機(jī)后“打印測(cè)試頁”成功但Word/Chrome打印時(shí)卡死在“正在連接”原因CUPS隊(duì)列被阻塞常見于驅(qū)動(dòng)沖突或PPD文件損壞。V10的system-config-printer有時(shí)會(huì)生成錯(cuò)誤PPD路徑。解決# 清空CUPS隊(duì)列強(qiáng)制取消所有作業(yè) sudo cancel -a # 刪除問題打印機(jī)并重建 sudo lpadmin -x HP_P1566_Net # 重新添加指定PPD文件避免GUI自動(dòng)生成錯(cuò)誤路徑 sudo lpadmin -p HP_P1566_Net -E -v usb://HP/P1566?serialXXXX -P /usr/share/cups/model/HP/hp-laserjet-p1566.ppd4.2 現(xiàn)象網(wǎng)絡(luò)打印機(jī)添加后lpstat -p顯示“disabled”日志報(bào)“Unable to open device”原因網(wǎng)絡(luò)打印機(jī)IP變更DHCP分配但CUPS緩存舊IP或打印機(jī)休眠未喚醒。解決# 強(qiáng)制刷新CUPS設(shè)備緩存 sudo cupsctl --remote-admin --remote-any --share-printers # 檢查設(shè)備URI是否更新對(duì)比實(shí)際IP sudo lpoptions -p HP_P1566_Net -l | grep device-uri # 若IP不符重新設(shè)置URI sudo lpadmin -p HP_P1566_Net -v ipp://192.168.1.102:631/ipp/print4.3 現(xiàn)象麒麟共享給WindowsWindows添加時(shí)提示“操作無法完成。拒絕訪問”原因Windows SMB客戶端版本過高Win10 1809默認(rèn)禁用SMBv1而V10 Samba默認(rèn)僅支持SMBv1。解決# 在V10上啟用SMBv2/v3編輯smb.conf sudo nano /etc/samba/smb.conf在[global]段添加min protocol SMB2 max protocol SMB3 server min protocol SMB2 server max protocol SMB3重啟Sambasudo systemctl restart smbd nmbd注意Windows端無需降級(jí)SMB保持默認(rèn)即可。4.4 現(xiàn)象雙面打印選項(xiàng)灰色不可選或打印后單面輸出原因PPD文件未聲明雙面支持或CUPS未啟用Duplex選項(xiàng)。解決# 查看PPD文件是否含Duplex支持 grep -i duplex /etc/cups/ppd/HP_P1566_Net.ppd # 若無手動(dòng)添加在PPD文件末尾追加 echo *OpenUI *Duplex: PickOne | sudo tee -a /etc/cups/ppd/HP_P1566_Net.ppd echo *DefaultDuplex: None | sudo tee -a /etc/cups/ppd/HP_P1566_Net.ppd echo *Duplex True: \\ | sudo tee -a /etc/cups/ppd/HP_P1566_Net.ppd echo *CloseUI: *Duplex | sudo tee -a /etc/cups/ppd/HP_P1566_Net.ppd # 重啟CUPS使PPD生效 sudo systemctl restart cups4.5 現(xiàn)象掃描功能無法使用hp-scan報(bào)錯(cuò)“Failed to open device”原因SANE后端未啟用或用戶未加入saned組。解決# 將當(dāng)前用戶加入saned組 sudo usermod -a -G saned $USER # 啟用SANE服務(wù) sudo systemctl enable saned sudo systemctl start saned # 驗(yàn)證掃描儀識(shí)別 scanimage -L # 應(yīng)輸出類似device hpaio:/usb/HP_LaserJet_P1566?serialXXXX is a Hewlett-Packard HP_LaserJet_P1566 all-in-one5. 驗(yàn)證與巡檢一套命令跑完確認(rèn)打印機(jī)環(huán)境真正可用5.1 五層驗(yàn)證法從硬件到應(yīng)用的逐級(jí)穿透測(cè)試不能只信“測(cè)試頁成功”必須分層驗(yàn)證。我給自己定的鐵律是每次部署完必跑這5條命令缺一不可。層級(jí)驗(yàn)證目標(biāo)命令預(yù)期輸出失敗含義L1 物理層USB/網(wǎng)絡(luò)連通性lsusb | grep -i hp或ping -c 3 192.168.1.102顯示設(shè)備ID或3個(gè)reply硬件未接入或IP錯(cuò)誤L2 內(nèi)核層驅(qū)動(dòng)加載狀態(tài)lsmod | grep -E (usblp|hplip|sane)列出對(duì)應(yīng)模塊驅(qū)動(dòng)未加載或沖突L3 服務(wù)層CUPS/Samba運(yùn)行態(tài)sudo systemctl status cups smbdactive (running)服務(wù)崩潰或未啟動(dòng)L4 隊(duì)列層打印機(jī)隊(duì)列健康lpstat -p -dprinter XXX is idle. enabled隊(duì)列被disable或損壞L5 應(yīng)用層實(shí)際文檔打印echo test | lp -d HP_P1566_Net返回job ID如HP_P1566_Net-123驅(qū)動(dòng)/PPD/URI任一環(huán)節(jié)故障執(zhí)行全部驗(yàn)證的腳本可保存為check-print.sh#!/bin/bash echo L1 物理層檢查 lsusb | grep -i hp\|epson || echo ?? USB設(shè)備未識(shí)別 ping -c 1 192.168.1.102 /dev/null echo ? 網(wǎng)絡(luò)打印機(jī)可達(dá) || echo ?? 網(wǎng)絡(luò)打印機(jī)不可達(dá) echo -e \n L2 內(nèi)核層檢查 lsmod | grep -E (usblp|hplip|sane) | grep -v grep || echo ?? 關(guān)鍵驅(qū)動(dòng)未加載 echo -e \n L3 服務(wù)層檢查 sudo systemctl is-active cups /dev/null echo ? CUPS服務(wù)運(yùn)行中 || echo ?? CUPS服務(wù)未運(yùn)行 sudo systemctl is-active smbd /dev/null echo ? Samba服務(wù)運(yùn)行中 || echo ?? Samba服務(wù)未運(yùn)行 echo -e \n L4 隊(duì)列層檢查 lpstat -p | grep is idle | head -1 || echo ?? 無空閑打印機(jī)隊(duì)列 echo -e \n L5 應(yīng)用層檢查 JOB_ID$(echo verify_$(date %s) | lp -d HP_P1566_Net 21 | grep -o [0-9]*) if [ -n $JOB_ID ]; then echo ? 文檔提交成功作業(yè)ID: $JOB_ID # 等待3秒后檢查作業(yè)狀態(tài) sleep 3 lpstat -o HP_P1566_Net-$JOB_ID /dev/null echo ?? 作業(yè)仍在隊(duì)列中可能卡住 || echo ? 作業(yè)已處理完成 else echo ?? 文檔提交失敗 fi賦予執(zhí)行權(quán)限并運(yùn)行chmod x check-print.sh ./check-print.sh5.2 日志分析技巧快速定位CUPS報(bào)錯(cuò)的黃金三步CUPS日志是黑匣子但90%問題藏在/var/log/cups/error_log。我總結(jié)出最高效的排查路徑第一步過濾時(shí)間戳定位最近操作# 查看最近5分鐘日志替換為你的操作時(shí)間 sudo journalctl -u cups --since 2024-06-15 14:30:00 --until 2024-06-15 14:35:00 | grep -E (E|error|fail|reject)第二步抓取關(guān)鍵錯(cuò)誤模式抄作業(yè)# 常見錯(cuò)誤關(guān)鍵詞速查表復(fù)制粘貼即用 sudo grep -n stopped\|refused\|permission denied\|no such file\|filter failed /var/log/cups/error_log # 輸出示例1234:W [15/Jun/2024:14:32:01 0800] Stopped... # → 直接跳轉(zhuǎn)到第1234行sudo nano 1234 /var/log/cups/error_log第三步關(guān)聯(lián)進(jìn)程IDPID追根溯源# 找到報(bào)錯(cuò)行的PID如cupsd[1234] # 然后查看該P(yáng)ID的完整上下文前后10行 sudo sed -n 1224,1244p /var/log/cups/error_log血淚經(jīng)驗(yàn)filter failed幾乎100%是PPD文件路徑錯(cuò)誤或驅(qū)動(dòng)缺失stopped多因內(nèi)存不足V10虛擬機(jī)需保證≥2GB內(nèi)存permission denied必查/var/spool/cups/目錄權(quán)限應(yīng)為root:lp且drwxrwx--T。5.3 生產(chǎn)環(huán)境巡檢清單每月一次的防翻車 checklist在某公司信創(chuàng)替代項(xiàng)目中我們?cè)蚝雎砸豁?xiàng)配置導(dǎo)致整棟樓打印中斷2小時(shí)。從此我堅(jiān)持每月執(zhí)行此清單項(xiàng)目檢查命令頻率不通過后果CUPS證書有效期openssl x509 -in /etc/cups/ssl/certs/cert.pem -noout -enddate每月證書過期后HTTPS打印失敗影響Web管理磁盤空間/var/spool/cupsdf -h /var/spool/cups每周90%滿時(shí)新作業(yè)被拒絕Samba匿名訪問權(quán)限smbclient -L //localhost -N | grep printers每月Windows客戶端無法枚舉打印機(jī)固件版本同步hp-check -r | grep Firmware version每季度新固件修復(fù)卡紙/空白頁等硬件缺陷用戶組權(quán)限groups $USER | grep -E (lp|saned)每次新用戶添加后普通用戶無法提交打印任務(wù)執(zhí)行腳本monthly-check.sh#!/bin/bash echo 月度巡檢開始 $(date) echo -e \n CUPS證書有效期 openssl x509 -in /etc/cups/ssl/certs/cert.pem -noout -enddate 2/dev/null || echo ?? 證書文件不存在 echo -e \n /var/spool/cups磁盤使用 df -h /var/spool/cups | tail -1 echo -e \n Samba打印機(jī)可見性 smbclient -L //localhost -N 2/dev/null | grep -i printers | head -1 || echo ?? Samba未返回打印機(jī)列表 echo -e \n 當(dāng)前用戶組 groups $USER從那以后我每次交付新終端都強(qiáng)制走一遍check-print.shmonthly-check.sh再讓客戶自己點(diǎn)一次測(cè)試頁——不是信不過GUI是信不過沒被驗(yàn)證過的每一行配置。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取