1. 安装 usbipd-win#

使用 winget 安装官方推荐的 USBIP 守护进程。

1
# 在 PowerShell 或 CMD 中运行 (需管理员权限)
2
winget install dorssel.usbipd-win

安装完成后，建议重启终端以确保 usbipd 命令可用。

2. 查找并绑定 USB 设备#

查看已连接的 USB 设备列表，找到目标设备的 BUSID（例如 2-1）。

1
# 列出所有 USB 设备
2
usbipd list
3

4
# 绑定目标设备 (将 <BUSID> 替换为你实际的 ID，如 2-1)
5
# 注意：此命令通常需要管理员权限
6
sudo usbipd bind --busid <BUSID>

提示：如果不确定哪个是串口设备，可以拔掉设备前后对比 list 的结果，或者查看 DESCRIPTION 列中包含 “Serial”、“FTDI”、“CP210x” 等关键词的设备。 注：bind 操作只需执行一次，除非重启了 usbipd 服务或解绑了设备。

1. 安装必要工具#

根据你的发行版安装 usbutils 和 linux-tools. 注：你之前的命令使用了 pacman，以下以 Arch Linux 为例，同时也提供了 Ubuntu/Debian 的命令。

对于 Arch Linux / Manjaro:

1
sudo pacman -Sy usbutils linux-tools

对于 Ubuntu / Debian:

1
sudo apt update
2
sudo apt install usbutils linux-tools-generic linux-tools-$(uname -r)

2. 配置内核模块自动加载 (关键步骤)#

为了让 WSL2 每次启动时自动加载虚拟主机控制器驱动 (vhci_hcd)，无需手动执行 modprobe，请执行以下操作：

1
# 将 vhci_hcd 添加到 modules 加载列表中
2
echo "vhci_hcd" | sudo tee /etc/modules-load.d/vhci_hcd.conf

执行完上述命令后，你可以立即手动加载一次以生效（无需重启 WSL）：

1
sudo modprobe vhci_hcd

验证：重启 WSL (wsl --shutdown 然后重新进入) 后，运行 lsmod | grep vhci，如果有输出则说明自动加载成功。

3. 附加 USB 设备 从宿主机拉取设备。你需要知道宿主机的 IP 地址。 技巧：使用 ip r 命令查看默认路由，其 gateway 即为宿主机 IP。

1
ip r | grep default | awk '{print $3}'
2

3
# 附加设备 (将 <BUSID> 替换为你的实际 ID)
4
sudo usbip attach -r <HOST_IP> -b <BUSID>

执行成功后，终端通常会显示 Attach Device 成功的信息。

4. 验证设备 检查设备是否识别为串口设备。

1
ls -l /dev/ttyUSB*
2
# 或者查看内核日志
3
dmesg | tail

此时应该能看到 /dev/ttyUSB0 (或其他编号)。

常见问题与优化建议#

1
# 将当前用户加入 dialout 组
2
sudo usermod -aG dialout $USER

1
# 列出已附加的设备
2
usbip list -l
3

4
# 分离设备 (需要知道端口号，通常是 0)
5
sudo usbip detach -p 0