USB 设备管理

WSL Dashboard 通过集成 usbipd-win，让您能够在 GUI 界面中轻松地将本地 USB 设备连接到 WSL 实例中。

前置准备

在使用此功能前，请确保：

1. 您已在 Windows 上安装了 usbipd-win。
2. 您的 WSL 内核支持 USB（现代的 WSL 2 默认内核通常已支持）。

使用步骤

1. 扫描设备

进入“USB”标签页，应用会自动列出当前连接到 Windows 的所有 USB 设备（包括集线器、鼠标、存储设备等）。

2. 绑定设备 (Bind)

在连接设备到特定 WSL 实例之前，需要先对该设备进行“绑定”。绑定操作需要管理员权限，WSL Dashboard 会自动处理提权请求。

绑定后，该设备将准备好被共享给 WSL。

3. 连接到实例 (Attach)

选择一个正在运行的 WSL 实例，点击“连接 (Attach)”。

• 连接成功后，该 USB 设备将从 Windows 中消失，并出现在选定的 WSL 实例中。
• 您可以在 WSL 中使用 lsusb 命令来验证。

4. 断开连接 (Detach)

完成操作后，点击“断开 (Detach)”，设备将重新返回 Windows 的控制。

常见问题

• 找不到设备？: 尝试刷新列表，或检查设备是否已正确插入宿主机。
• 连接失败？: 确保目标 WSL 实例正在运行，且您拥有足够的权限。
• usbipd 命令未找到？: 请确认 usbipd-win 已安装并已添加至系统的 PATH 环境变量中。