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