扫描仪适配 - 麒麟桌面一本通

1. 适配方案的查找

1. 通过外部渠道获取驱动

驱动提供以下5个获取渠道，请按优先级顺序查询（注意选择与现场环境 CPU 架构匹配的驱动安装包）：

1. 外设厂家官网 常见外设厂家官网列表

2. 麒麟在线表格 点击访问

3. Excel 表格查询 点击访问

4. 在线表格查询 点击访问

5. 技术支持 关注"麒麟软件技术服务"公众号或拨打 400-089-1870

1.1 在银河麒麟本地驱动库中查找

麒麟操作系统已集成不少开源驱动。已支持的扫描仪通常不需要额外安装驱动，直接连接使用即可。

2.1

确定 SANE 版本

V10(SP1) 的 SANE 版本是 1.0.29，V10 的 SANE 版本是 1.0.27。SANE 版本越新，集成的驱动越多。

2.2

在 SANE 网站查询

访问 SANE 支持设备列表，在"Old SANE Versions"中选择对应版本。

图 1：SANE - Supported Devices

2.3

搜索扫描仪型号

使用 Ctrl+F 搜索扫描仪型号，以 HP ScanJet G4010 为例：

图 2：HP ScanJet G4010 搜索结果

信息说明：USB 接口，Vendor ID: 0x03f0，Product ID: 0x4505，支持状态：Good，驱动：genesys。

1.2 SANE 支持状态分类

状态	说明
Complete	完美支持，所有功能都可使用
Good	稳定工作，某些高阶功能可能不支持
Basic	支持基本扫描模式，质量一般
Minimal	至少一种扫描模式可用，质量较差
Untested	可能支持，未经测试验证
Unsupported	不支持

1.3 扫描仪识别问题排查

如果搜到扫描仪型号但 scanimage -L 识别不到，请检查：

4.1

检查 dll.conf

进入 /etc/sane.d ，查看 dll.conf 是否包含对应驱动（如 genesys）且未被注释。

4.2

检查驱动配置文件

查看对应驱动的配置文件（如 genesys.conf ），确认是否包含该扫描仪型号信息。

4.3

检查驱动库文件

进入 /usr/lib/x86_64-linux-gnu/sane （x86_64 架构），查看是否有对应 so 库文件。

$ ls -l | grep genesys

图 3：扫描驱动信息

2. 适配解决方案的实施

1

安装 DEB 驱动包

绝大多数情况下，驱动以单个 DEB 软件包形式提供。可通过 apt、dpkg 或麒麟安装器（双击）安装。

如果驱动包自带扫描软件，直接使用该软件即可；否则可选择使用麒麟扫描、文档扫描仪或 XSane。

2

多 DEB 包安装

如果驱动是多个 DEB 包，通常会有安装脚本。如果没有，将包放到同一文件夹后执行：

$ sudo dpkg -i *

3. 常见适配问题解答

无法识别扫描仪

检查并尝试更换 USB 线缆、电脑的 USB 接口
终端输入 lsusb 查看是否识别到硬件设备
检查是否安装驱动，安装过程中是否报错
检查 /etc/sane.d/dll.conf 确认驱动是否被注释
驱动安装后重启电脑和扫描仪
root 权限下执行 scanimage -L 确认是否能识别
松下扫描仪需安装 libusb-0.1-4 库： sudo apt install libusb-0.1-4

自带扫描软件双击打不开

右键解压，找到 desktop 文件的 exec 字段，使用终端运行。根据报错判断问题，如提示缺少依赖库，使用 apt search 和 apt install 安装。

扫描图片颜色或格式不正确

这是扫描仪驱动问题，请联系生态适配人员确认后反馈给扫描仪厂商修复。

XSane 提示"开启装置失败"

尝试多启动几次，如果多次尝试仍报错，则驱动与该扫描仪不匹配。

麒麟扫描功能缺失或识别问题

麒麟扫描与驱动兼容性问题，建议使用 XSane。

4. 获取扫描仪日志

结合日志分析是排查问题最有效的方法。

1

使用 scanimage

# 查看扫描仪支持的功能和参数
$ sudo
                                                                        scanimage -h -d xxx

# 输出 debug 日志信息
$
                                                                        SANE_DEBUG_DLL=255 scanimage -d xxx > a.pnm
                                                                

图 4：扫描仪支持功能

提示： 输出信息通常较多，可修改终端设置将回滚改成"不限制"。

各扫描软件日志路径

软件	日志获取方式
扫描易/文档扫描仪	`sudo simple-scan -d` 日志： `~/.cache/simple-scan/simple-scan.log`
麒麟扫描	日志： `/tmp/scanner/kylin-scanner.log`
XSane	`XSANE_DEBUG=255 xsane` ，手动保存输出

5. 扫描仪共享指南

安全警告：

请确认您已知本操作可能带来的安全风险（计算机病毒、中间人攻击、ARP攻击、DDoS攻击等），并有技术手段规避。

如果只有一台扫描仪需要让多人共享使用，可以通过配置网络扫描来实现。

服务器端配置

1

安装 xinetd

$ sudo apt install xinetd

2

创建 saned 配置

创建文件 /etc/xinetd.d/saned ：

service sane-port
{

                                                                        socket_type = stream
 server =
                                                                        /usr/sbin/saned
 protocol = tcp
 user =
                                                                        saned
 group = saned
 wait = no

                                                                        disable = no
}

3