Skip to main content

概述

在 Windows + WSL 上,USB 设备不会自动在 Linux 子系统内可见。usbipd-win 工具通过回环 IP 隧道将 USB 总线从 Windows 主机转发到 WSL,从而弥补这一差距。
usbipd-win 必须已经安装。如果尚未安装,请在 Windows 管理员终端中运行 winget install usbipd-win

分步操作

1

终止 Windows 上正在运行的 ADB 服务器

打开 PowerShell(管理员模式) 并运行:
如果 ADB 未在运行,此命令可能会报告错误 — 可以安全地忽略。
2

列出可用的 USB 设备

记下您的 Qualcomm 设备的 BUSID
3

绑定设备(持久性,一次性操作)

绑定在重启后仍然保持。如果您的设备暴露多个 USB 模式(例如 ADB + EDL),请对每个 BUSID 各绑定一次。
在某些企业机器上,usbipd bind 或后续的挂载步骤可能会因防火墙策略而失败。如果您看到明确的防火墙错误,请按照下面的企业防火墙解决方法操作。
4

将设备挂载到 WSL 并启用自动重新挂载

  • 保持此 PowerShell 窗口打开 — 关闭它会停止自动挂载循环。
  • 每次重启 WSL 后,您都必须重新运行此命令。
  • 如果更换了物理 USB 端口,请从头重新运行所有 usbipd 命令。
下图展示了完整的绑定和挂载流程:usbipd — 绑定和挂载命令
5

在 WSL 内验证设备

在您的 WSL 终端中:
您应该能看到列出的 Qualcomm 设备。

企业防火墙解决方法

  1. 关闭所有打开的 WSL 终端。
  2. 在 PowerShell 中关闭 WSL:
  1. 编辑 %UserProfile%\.wslconfig 并添加:
  1. 重启 WSL:
  1. 重试 usbipd bindusbipd attach 步骤。

完成后分离 / 解绑