必须先确认金税盘被内核识别，再依次启用pcscd服务、安装官方.deb驱动、导入ca根证书并加载pkcs#11模块；执行lsusb验证设备枚举，sudo systemctl enable --now pcscd启动服务，dpkg -i安装驱动，火狐中导入htrootca.crt并载入libhtukeypkcs11.so。
在银河麒麟系统中安装中税或航天金税盘驱动，需绕过Windows惯性操作路径，直接对接UKey设备底层通信协议与CUPS/PCSC服务栈，否则插入金税盘后桌面无响应、开票软件提示“未检测到税务设备”或“证书加载失败”将无法避免。
确认金税盘已被内核识别
这一步跳过会导致后续所有安装动作无效——若lsusb不显示设备，说明USB协议层已拒绝握手，图形界面必然无法发现金税盘。
使用原装USB线连接金税盘并开机，确保盘体指示灯常亮或呼吸闪烁。按Ctrl+Alt+T打开终端，执行：lsusb | grep -i -E "(tax|shu|jin|hangtian|zhongshui)"。
正常应返回类似 Bus 002 Device 005: ID 096e:0821 Alcor Micro, Corp. AU9540 Smart Card Reader 的行，其中ID后为VID:PID编码；若无输出，立即更换USB端口、禁用USB3.0（BIOS中设为USB2.0模式）或尝试另一台物理主机复现。
【注意】桌面右上角若弹出“新USB设备接入”但标注“未授权”，必须点击“允许”，否则内核会丢弃该设备的urb请求。
启用PCSC智能卡服务
金税盘本质是符合PKCS#11标准的国密USB Key，依赖pcscd守护进程提供底层读卡器抽象接口，该服务未运行时，任何税务软件都无法调用设备功能。
执行命令检查状态：sudo systemctl status pcscd。
若返回 inactive (dead) 或 failed，依次执行：
sudo systemctl start pcscd →
sudo systemctl enable pcscd →
sudo systemctl restart pcscd
验证是否就绪：执行 pcsc_scan，插入金税盘后应实时打印“Using reader: Alcor Micro AU9540”及ATR响应码；若提示“No readers found”，说明USB设备虽被枚举，但ccid驱动未加载，需进入下一步。
手动安装航天/中税官方Linux驱动包
航天信息与百旺中税均提供适配银河麒麟V10/V11的.deb驱动包，内含libusb通信库、国密SM2/SM4算法模块、PCSC插件及udev规则，不可用Windows版exe或通用USB转串口驱动替代。
方法一：从官网下载安装
① 访问航天信息官网「服务支持→下载中心→税务UKey→Linux驱动」，下载名称含 kylin 或 v10 的.deb包（如 htukey-driver-kylin-v10-amd64-2.1.0.deb）；
② 终端进入下载目录，执行：sudo dpkg -i htukey-driver-kylin-v10-amd64-2.1.0.deb；
③ 若报依赖错误（如 libpcsclite1 版本低），立即补全：sudo apt-get install -f。
方法二：离线部署（适用于政务内网）
若无法联网，将驱动包拷贝至目标机，在终端执行：sudo dpkg -i /path/to/htukey-driver-kylin-v10-arm64-2.1.0.deb（注意CPU架构匹配x86_64或arm64）；
安装后手动触发udev重载：sudo udevadm trigger --subsystem-match=usb。
安装完成后，执行 lsmod | grep -i usbkey，应返回非空结果；再运行 sudo service pcscd restart 确保新模块被pcscd识别。
配置火狐ESR浏览器信任环境
开票软件（如增值税发票开票软件V3.0）底层调用火狐ESR的NSS证书库进行签名验签，若根证书缺失或PKCS#11模块未注册，将卡在“选择证书”弹窗或提示“证书不可信”。
第一步：导入航天/中税CA根证书
打开火狐ESR → 右上角三横线 → 首选项 → 隐私与安全 → 证书 → 查看证书 → “证书颁发机构”页签 → 点击“导入”；
定位到驱动包安装路径下的证书文件，典型路径为：/opt/htukey/certs/HTRootCA.crt 或 /usr/local/zhongshui/cert/ZSRootCA.pem；
导入时务必勾选全部三项信任选项（网站标识、电子邮件标识、软件标识）。
第二步：加载PKCS#11安全模块
同一页面 → 安全设备 → 载入 → 浏览 → 进入 /opt/htukey/lib/ 或 /usr/lib/zhongshui/ 目录 → 选中 libhtukeypkcs11.so 或 libzskeypkcs11.so → 打开；
确认设备列表中出现“HTUKey PKCS#11”或“ZSKey PKCS#11”且状态为“已启用”。
关闭所有火狐窗口，重新启动生效。此时在开票软件中点击“登录”或“数字签名”，应能正常弹出证书选择框并完成身份认证。
