UIS增加USB设备系统内识别不到

UIS增加USB设备后系统内识别不到，这通常和配置流程、兼容性或重启顺序有关。建议你按照下面的步骤，由浅入深地来排查。

 第一步：定位问题根源

首先，需要确定USB设备是在UIS/CAS物理主机层面就没被识别，还是物理主机已经识别，问题出在连接到虚拟机这一步。

1. 检查物理主机：将USB设备插入运行着目标虚拟机的UIS/CAS物理主机。

2. 登录主机后台：通过SSH登录到该物理主机的后台命令行界面。

3. 运行检测命令：在命令行中输入 lsusb 并回车。

   • 如果列表中没有你的USB设备：说明物理主机层面就无法识别。

   • 如果列表中显示了你的USB设备：说明问题出在将设备“传递给”虚拟机的这个环节。

 第二步：根据排查结果，进行针对性修复

根据上一步定位到的问题所在，选择对应的方案解决。

场景一：物理主机无法识别（lsusb 无设备）

如果 lsusb 没有显示设备，请尝试：

• 物理插拔：将USB设备拔下，等待几秒后重新插入，再运行 lsusb 确认。可以在设备管理器或 lsusb 中观察设备列表的变化。

• 更换接口：换一个USB接口尝试，如果是台式机，优先使用后置USB口。

• 重启主机：若以上方法无效，可能需要重启物理主机。

• 兼容性确认：H3C UIS/CAS环境对某些USB设备，特别是较老的USB 1.1设备，或使用非标准协议的加密狗（UKey）兼容性有限。如果可能，尝试更换USB设备型号或使用USB Server设备进行网络映射。

场景二：物理主机已识别，但虚拟机内看不到

如果 lsusb 能列出设备，说明问题出在设备和虚拟机的连接上。请严格遵循以下操作流程：

1. 务必关机添加：对于USB透传（直通），强烈建议在虚拟机关机状态下进行添加操作，避免出现各种异常问题。

2. 尝试不同控制器：在UIS管理界面向虚拟机添加USB硬件时，可以尝试选择不同类型的控制器，特别是对于一些老旧的加密狗，USB 1.1或2.0的兼容性往往更好。

3. 检查驱动与软件：确保虚拟机操作系统内部已安装了该USB设备所需的官方驱动和配套软件。

4. 检查独占性：确保该USB设备没有被其他虚拟机占用，一个USB设备同一时间只能分配给一台虚拟机。

 第三步：特别提醒（重要）

• 重启顺序：如果虚拟机使用了USB直通功能，在需要重启虚拟机时，建议遵循“先关闭虚拟机 → 删除USB设备 → 启动虚拟机 → 关机 → 重新添加USB设备”的顺序，以避免因CVK（虚拟化内核）挂载信息残留导致的问题。

• 删除后无法找回：如果在UIS界面上删除了一个USB设备后，想重新添加时找不到它，通常需要在物理主机上重新插拔该设备，UIS界面才能再次识别到。

一、先判断：是物理机没识别，还是虚拟机没识别？
1. 登录 UIS 后台（SSH 到 CVK 主机）
bash
运行
lsusb
dmesg | grep -i usb
有设备信息 → 物理机识别正常，问题在 UIS 平台配置 / 虚拟机透传（看第二步）
无设备信息 → 物理层没识别，直接看 第一步（硬件 + 接口 + BIOS）
二、物理层排查（lsusb 看不到）
1）接口与供电（最常见）
必须插 服务器后置原生 USB2.0 口（不要前置、不要 USB3.0、不要延长线 / Hub）
换 2～3 个不同后置口测试
重启 CVK 主机再试
2）BIOS 设置（关键）
开机按 Del/F2 进 BIOS：
开启 USB Legacy Support / USB2.0 Controller
关闭 USB3.0 Mode / XHCI Hand-off（强制兼容 USB2.0）
保存退出，重启
3）兼容性与硬件
查 UIS 官方兼容性矩阵，确认该 USB 设备（尤其加密狗）在支持列表里
把 USB 插普通 PC 测试：PC 也不认 → 设备坏；PC 认 → 继续下面
三、UIS 平台 + 虚拟化层排查（lsusb 能看到，但虚拟机看不到）
1）UIS 管理平台检查
登录 UIS → 主机 → 对应 CVK → 配置 → USB 设备
看设备是否存在：
已存在：检查是否被其他虚拟机绑定（USB 独占，只能给一个 VM）
解决：先在旧 VM 里移除 USB，再给新 VM 添加
不存在：点 刷新，仍无 → 回到物理机 lsusb 确认
2）给虚拟机添加 USB 透传（重点）
虚拟机 → 硬件 → 添加 → USB 设备
选择对应设备，务必勾选「USB 持久化」（加密狗 / U 盾必选，否则重启失效）
控制器类型选 USB2.0（EHCI），不要选 USB3.0
确定，重启虚拟机
四、虚拟机系统内排查（添加后仍看不到）
Windows 虚拟机
设备管理器 → 查看「显示隐藏的设备」
看是否有 未知 USB 设备：
有：右键 → 更新驱动，装厂商专属驱动（如加密狗）
无：重启虚拟机，重新插拔 USB
Linux 虚拟机
bash
运行
lsusb
usb-devices
有设备：安装对应驱动
无设备：重新透传，勾选持久化
五、常见坑（必看）
USB3.0 兼容性差：加密狗 / 老设备必须用 USB2.0 口 + USB2.0 控制器
供电不足：前置口 / Hub 经常掉设备，只用后置原生口
独占绑定：一个 USB 只能给一个 VM，先解绑再绑定
持久化：加密狗不勾这个，重启就丢