银河麒麟V10打印机配置实战：USB直连、网络IPP与共享排障全链路

简介：本资源是面向银河麒麟桌面操作系统V10用户（尤其是政企信创环境运维人员、国产化办公终端管理员及Linux初学者）的官方级打印机配置与共享实操指南，系统解决国产系统下外设兼容、本地/网络打印机部署及跨平台打印协同等核心问题。手册由麒麟软件有限公司于2021年2月正式发布，内容覆盖直连USB/串口打印机安装、网络打印机发现与添加、麒麟系统间双向共享、麒麟与Windows 7/10双向共享四大场景，并专设“常见问题”章节详解测试页失败等典型排错路径。资源为单文件Word文档（.docx），共1个文件，大小4.93MB，结构清晰、图文结合、步骤详尽，便于快速查阅与现场执行。目前已有5620人学习下载，是信创环境下打印机适配落地不可或缺的实用型技术文档。

1. 银河麒麟桌面V10打印机配置：别被“自动识别”骗了，USB直连失败率超60%的真相

你刚把惠普M1132插进银河麒麟桌面V10的USB口，桌面右下角弹出“发现新打印机”，心里一喜——结果点开控制面板一看，设备列表里空空如也；或者更玄学的是：测试页能打出来，但Word文档一按打印就卡在“正在连接打印机”十分钟不动。这不是个例，而是我帮某高校实验室部署23台终端时踩出的共性坑：V10默认CUPS服务未启用、USB设备权限未释放、驱动匹配逻辑对国产固件兼容性差，导致直连失败率实际高达60%以上（非官方数据，实测23台中14台需手动干预）。这份手册不是照搬PDF里的点击流程，而是把“添加打印机”背后真正起作用的三层机制——内核设备识别（usbcore）、CUPS守护进程（cupsd）、GTK前端图形界面（system-config-printer）——全拆开给你看参数、改配置、验状态。适合所有正在麒麟V10上配打印机却卡在“找不到设备”“连不上IPP”“共享后Windows提示拒绝访问”的运维、信创项目实施工程师和高校IT支持人员。你不需要懂CUPS源码，但得知道/etc/cups/cupsd.conf里哪三行改错会导致整个打印服务瘫痪。

2. 直连与网络打印机安装：从设备识别到驱动加载的完整链路

2.1 USB直连打印机：绕过图形界面，用命令行确认硬件层是否“看见”

图形界面的“添加打印机”按钮本质是调用system-config-printer，它依赖底层udev规则和cups-browsed服务。很多失败根本卡在第一步：系统压根没把打印机当合法USB设备挂载。先验证物理层：

# 查看USB设备树，确认打印机是否被内核识别（注意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口供电不足） # 检查内核是否加载对应驱动模块（以惠普P1566为例） lsmod | grep usblp # ✅ 应看到 usblp 模块；若无，手动加载： sudo modprobe usblp # 并写入开机加载（避免重启后失效）： echo "usblp" | sudo tee -a /etc/modules

提示：usblp是Linux通用USB打印机驱动，但部分新型号（如HP LaserJet Pro MFP M428fdw）需hplip专用驱动。V10默认未预装hplip，需单独处理（见2.3节）。

2.2 网络打印机添加：不靠“自动发现”，手动构造IPP URI才是稳解

手册里写的“点击查找网络打印机”在真实局域网中成功率极低——因为cups-browsed默认只监听IPv4广播，而很多企业网络禁用UDP广播或启用了IPv6优先。直接跳过GUI，用IP+端口构造URI：

# 获取打印机真实IP（勿信路由器后台显示，用arp扫描更准） sudo arp-scan --local | grep -i "hp\|epson\|brother" # 示例输出：192.168.1.102 00:1e:8c:xx:xx:xx Hewlett-Packard # 手动添加IPP打印机（关键：端口必须是631，协议必须是ipp://） sudo lpadmin -p "HP_P1566_Net" -E -v "ipp://192.168.1.102:631/ipp/print" -m everywhere # 参数说明： # -p 指定打印机队列名（后续用此名管理） # -E 启用加密连接（即使本地网络也建议开启） # -v 指定设备URI（⚠️注意：不是http://，不是https://，必须是ipp://） # -m everywhere 表示使用CUPS内置的"通用PostScript驱动"，兼容90%激光打印机

验证是否注册成功：

lpstat -p # 应看到：printer HP_P1566_Net is idle. enabled since ...

2.3 驱动缺失场景：当“自动匹配”失败时，手动安装HPLIP或Gutenprint

V10自带驱动库（/usr/share/cups/model/）覆盖主流型号，但遇到以下情况必须手动装驱动：

• 打印机型号较新（如2020年后发布的HP Tango系列）
• 需要双面/装订等高级功能
• 扫描功能需联动（hplip含hp-scan工具）

安装HPLIP（以HP为例）：

# 下载适配V10的HPLIP包（注意：必须用arm64或amd64对应架构，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 # 安装过程关键选择： # → 是否安装推荐依赖？选 N（V10已自带cups、sane等） # → 是否启用网络发现？选 Y（否则无法添加网络HP打印机） # → 是否启用扫描功能？选 Y（需额外装libsane-dev） # 安装后重启CUPS服务 sudo systemctl restart cups

验证HPLIP是否生效：

hp-check -t # 关注输出中： # "error: HPLIP is not installed properly" → 失败 # "OK, all dependencies check out" → 成功 # "warning: ... missing firmware" → 需下载固件（见2.4节）

2.4 固件加载：解决“打印空白页”“卡纸提示误报”的底层原因

很多用户反馈：测试页能打，但正式文档打印出来是空白，或频繁报“卡纸”实则无纸。根源常是打印机固件未加载。以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，不可与驱动包混淆。V10的/usr/share/hplip/firmware/目录是固件默认存放位置。

3. 麒麟V10共享打印机：服务端配置的三个致命参数

3.1 CUPS服务端配置：cupsd.conf里决定共享成败的三行

图形界面的“共享打印机”开关只是修改/etc/cups/cupsd.conf的快捷方式。但V10默认配置存在两处硬伤：
①Listen localhost:631仅监听本地回环，外部设备无法访问；
②<Location />段缺少Allow from all，拒绝所有远程请求；
③Browsing On虽默认开启，但BrowseLocalProtocols未包含dnssd（mDNS），导致Mac/Linux客户端无法发现。

正确配置步骤：

# 备份原配置（后悔药！） sudo cp /etc/cups/cupsd.conf /etc/cups/cupsd.conf.bak # 编辑主配置 sudo nano /etc/cups/cupsd.conf

在文件中定位并修改以下三处（必须严格按顺序）：

# 第1处：监听地址（取消注释并改为0.0.0.0） Listen 0.0.0.0:631 # 第2处：全局访问控制（在<Location />段内添加） <Location /> Order allow,deny Allow from all # ← 新增此行（关键！） </Location> # 第3处：启用mDNS广播（在"Browsing"相关段） Browsing On BrowseLocalProtocols dnssd # ← 确保包含dnssd（支持苹果和现代Linux）

保存后重启服务：

sudo systemctl restart cups # 验证监听状态： sudo ss -tlnp | grep :631 # 应看到：LISTEN 0 128 *:631 *:* users:(("cupsd",pid=1234,fd=8))

3.2 Samba共享配置：让Windows客户端“看见”麒麟打印机

仅开CUPS共享，Windows仍可能提示“无法连接打印机”，因为Windows默认走SMB协议而非IPP。需启用Samba服务并映射打印机：

# 安装Samba（V10默认未装） 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 # ← 允许匿名访问（内网安全前提下） printable = yes create mask = 0700 use client driver = yes # ← 让Windows自行选择驱动

创建Samba打印队列目录并赋权：

sudo mkdir -p /var/spool/samba sudo chown root:lp /var/spool/samba sudo chmod 1777 /var/spool/samba

重启Samba：

sudo systemctl restart smbd nmbd

重要：此时需在麒麟防火墙开放Samba端口（137-139, 445），操作见4.1节。

3.3 防火墙放行：安全中心里“勾选Samba服务”不等于放行

手册说“在安全中心勾选Samba服务即可”，但实测发现：V10安全中心的“自定义配置”界面勾选Samba，仅开放TCP 445，遗漏了UDP 137-138（NetBIOS名称解析必需），导致Windows客户端能ping通IP，却始终找不到打印机。

手动补全防火墙规则：

# 查看当前firewalld规则（V10默认用firewalld） sudo firewall-cmd --list-all # 开放Samba全套端口（UDP+TCP） sudo firewall-cmd --permanent --add-port=137/udp sudo firewall-cmd --permanent --add-port=138/udp sudo firewall-cmd --permanent --add-port=139/tcp sudo firewall-cmd --permanent --add-port=445/tcp # 重载防火墙 sudo firewall-cmd --reload

验证端口状态：

# 从Windows机器执行（需安装telnet客户端）： telnet 192.168.1.100 445 # 应连接成功 # UDP端口用nc检测（Linux/Mac）： nc -zuv 192.168.1.100 137

4. 常见问题排查：血泪经验总结的5类高频翻车现场

4.1 现象：添加打印机后“打印测试页”成功，但Word/Chrome打印时卡死在“正在连接”

原因：CUPS队列被阻塞，常见于驱动冲突或PPD文件损坏。V10的system-config-printer有时会生成错误PPD路径。

解决：

# 清空CUPS队列（强制取消所有作业） sudo cancel -a # 删除问题打印机并重建 sudo lpadmin -x "HP_P1566_Net" # 重新添加，指定PPD文件（避免GUI自动生成错误路径） sudo lpadmin -p "HP_P1566_Net" -E -v "usb://HP/P1566?serial=XXXX" -P "/usr/share/cups/model/HP/hp-laserjet-p1566.ppd"

4.2 现象：网络打印机添加后lpstat -p显示“disabled”，日志报“Unable to open device”

原因：网络打印机IP变更（DHCP分配），但CUPS缓存旧IP；或打印机休眠未唤醒。

解决：

# 强制刷新CUPS设备缓存 sudo cupsctl --remote-admin --remote-any --share-printers # 检查设备URI是否更新（对比实际IP） sudo lpoptions -p "HP_P1566_Net" -l | grep device-uri # 若IP不符，重新设置URI sudo lpadmin -p "HP_P1566_Net" -v "ipp://192.168.1.102:631/ipp/print"

4.3 现象：麒麟共享给Windows，Windows添加时提示“操作无法完成。拒绝访问”

原因：Windows SMB客户端版本过高（Win10 1809+默认禁用SMBv1），而V10 Samba默认仅支持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

重启Samba：sudo systemctl restart smbd nmbd

注意：Windows端无需降级SMB，保持默认即可。

4.4 现象：双面打印选项灰色不可选，或打印后单面输出

原因：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 cups

4.5 现象：扫描功能无法使用，hp-scan报错“Failed to open device”

原因：SANE后端未启用，或用户未加入saned组。

解决：

# 将当前用户加入saned组 sudo usermod -a -G saned $USER # 启用SANE服务 sudo systemctl enable saned sudo systemctl start saned # 验证扫描仪识别 scanimage -L # 应输出类似：device `hpaio:/usb/HP_LaserJet_P1566?serial=XXXX' is a Hewlett-Packard HP_LaserJet_P1566 all-in-one

5. 验证与巡检：一套命令跑完，确认打印机环境真正可用

5.1 五层验证法：从硬件到应用的逐级穿透测试

不能只信“测试页成功”，必须分层验证。我给自己定的铁律是：每次部署完必跑这5条命令，缺一不可。

执行全部验证的脚本（可保存为check-print.sh）：

#!/bin/bash echo "=== L1 物理层检查 ===" lsusb | grep -i "hp\|epson" || echo "⚠️ USB设备未识别" ping -c 1 192.168.1.102 &>/dev/null && echo "✅ 网络打印机可达" || echo "⚠️ 网络打印机不可达" echo -e "\n=== L2 内核层检查 ===" lsmod | grep -E "(usblp|hplip|sane)" | grep -v "grep" || echo "⚠️ 关键驱动未加载" echo -e "\n=== L3 服务层检查 ===" sudo systemctl is-active cups &>/dev/null && echo "✅ CUPS服务运行中" || echo "⚠️ CUPS服务未运行" sudo systemctl is-active smbd &>/dev/null && echo "✅ Samba服务运行中" || echo "⚠️ Samba服务未运行" echo -e "\n=== L4 队列层检查 ===" lpstat -p | grep "is idle" | head -1 || echo "⚠️ 无空闲打印机队列" echo -e "\n=== L5 应用层检查 ===" JOB_ID=$(echo "verify_$(date +%s)" | lp -d "HP_P1566_Net" 2>&1 | grep -o "[0-9]*") if [ -n "$JOB_ID" ]; then echo "✅ 文档提交成功，作业ID: $JOB_ID" # 等待3秒后检查作业状态 sleep 3 lpstat -o "HP_P1566_Net-$JOB_ID" &>/dev/null && echo "⚠️ 作业仍在队列中（可能卡住）" || echo "✅ 作业已处理完成" else echo "⚠️ 文档提交失败" fi

赋予执行权限并运行：

chmod +x check-print.sh ./check-print.sh

5.2 日志分析技巧：快速定位CUPS报错的黄金三步

CUPS日志是黑匣子，但90%问题藏在/var/log/cups/error_log。我总结出最高效的排查路径：

第一步：过滤时间戳（定位最近操作）

# 查看最近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)"

第二步：抓取关键错误模式（抄作业）

# 常见错误关键词速查表（复制粘贴即用） 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... # → 直接跳转到第1234行：sudo nano +1234 /var/log/cups/error_log

第三步：关联进程ID（PID）追根溯源

# 找到报错行的PID（如cupsd[1234]） # 然后查看该PID的完整上下文（前后10行） sudo sed -n '1224,1244p' /var/log/cups/error_log

血泪经验：filter failed几乎100%是PPD文件路径错误或驱动缺失；stopped多因内存不足（V10虚拟机需保证≥2GB内存）；permission denied必查/var/spool/cups/目录权限（应为root:lp且drwxrwx--T）。

5.3 生产环境巡检清单：每月一次的防翻车 checklist

在某公司信创替代项目中，我们曾因忽略一项配置导致整栋楼打印中断2小时。从此我坚持每月执行此清单：

执行脚本（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🔧 当前用户组：" groups $USER

从那以后我每次交付新终端，都强制走一遍check-print.sh+monthly-check.sh，再让客户自己点一次测试页——不是信不过GUI，是信不过没被验证过的每一行配置。希望帮到你。

本文还有配套的精品资源，点击获取