3步打通WSL 2与USB设备：usbipd-win实现外设共享全攻略

Windows Subsystem for Linux 2（WSL 2）凭借其出色的性能和兼容性，已成为开发者在Windows环境下运行Linux工具链的首选方案。然而，WSL 2的虚拟化架构导致物理设备访问长期受限，特别是USB设备连接一直是困扰用户的主要痛点。本文将系统介绍如何通过usbipd-win工具，让WSL 2无缝访问各类USB设备，从存储设备到开发板，全面扩展你的开发环境能力。

一、核心方案：USB/IP技术破解设备隔离

1.1 技术原理速览

USB/IP协议是实现跨系统设备共享的关键技术，它通过网络层封装USB协议，将物理USB设备转化为可网络访问的资源。usbipd-win作为Windows平台的实现，构建了WSL 2与主机USB控制器之间的桥梁，其工作原理包含三个核心步骤：设备绑定（将USB设备注册为共享资源）、网络传输（通过虚拟网络接口转发USB数据）、Linux端驱动（WSL内核的usbip客户端模块）。

图1：WSL 2与Windows主机之间的网络通信架构，展示了USB/IP数据传输路径

1.2 系统环境准备

确保你的系统满足以下条件：

• Windows系统：Windows 11 22000+或Windows 10 19045+
• WSL版本：WSL 2（通过wsl --list --verbose确认）
• Linux内核：5.10.60.1以上（执行uname -r检查）
• 架构支持：x64处理器（暂不支持ARM架构）

💡 快速升级技巧：在PowerShell中执行wsl --update可一键升级WSL内核至最新版本。

二、场景化部署：从新手到专家的实现路径

2.1 新手入门：图形化安装与基础配置

2.1.1 安装usbipd-win

通过Windows应用商店获取：

1. 打开Microsoft Store搜索"usbipd-win"
2. 点击"获取"完成安装
3. 验证安装：在PowerShell中执行usbipd --version

2.1.2 设备连接三步法

1. 列出设备（管理员PowerShell）：

   usbipd list  # 显示所有USB设备及BUSID
   

   示例输出：

   BUSID  VID:PID    DEVICE
   1-3    0483:5750  USB Serial Device
   2-1    0781:5583  SanDisk Cruzer Glide
   

2. 绑定设备（选择要共享的BUSID）：

   usbipd bind --busid 2-1  # 绑定U盘设备
   

3. 附加到WSL：

   usbipd attach --wsl --busid 2-1  # 自动连接到默认WSL发行版
   

在WSL终端验证：

lsusb  # 应显示类似"Bus 001 Device 002: ID 0781:5583 SanDisk Corp."的设备信息

⚠️ 注意事项：绑定后设备将暂时从Windows系统中消失，解除绑定前无法在主机上使用。

2.2 进阶配置：命令行部署与自动化脚本

2.2.1 使用winget快速安装

winget install dorssel.usbipd-win --silent  # 静默安装最新版本

2.2.2 多设备管理脚本

创建PowerShell脚本usb-share.ps1：

# 列出所有可共享设备
usbipd list

# 交互式选择设备
$busid = Read-Host "请输入要共享的BUSID"

# 绑定并附加到指定WSL发行版
usbipd bind --busid $busid
usbipd attach --wsl --busid $busid --distribution Ubuntu-22.04

2.2.3 WSL自动挂载配置

在WSL中创建udev规则：

sudo nano /etc/udev/rules.d/99-usbip.rules

添加规则：

SUBSYSTEM=="usb", ATTRS{idVendor}=="0781", ATTRS{idProduct}=="5583", MODE="0666"

使规则生效：

sudo udevadm control --reload-rules && sudo udevadm trigger

常见误区：很多用户尝试直接修改/dev/ttyUSB*权限，但正确做法是通过udev规则实现永久权限配置，避免重启后权限丢失。

三、设备应用实战：三大典型场景解决方案

3.1 存储设备：U盘与移动硬盘

1. 附加设备后查找设备路径：

   sudo fdisk -l  # 找到类似/dev/sdb1的设备路径
   

2. 创建挂载点并挂载：

   sudo mkdir -p /mnt/usb
   sudo mount /dev/sdb1 /mnt/usb -o uid=$USER,gid=$USER  # 挂载为当前用户可读写
   

3. 使用完成后安全卸载：

   sudo umount /mnt/usb
   

3.2 开发板连接：Arduino与树莓派Pico

1. 附加设备后确认串口设备：

   ls -l /dev/ttyUSB*  # 通常显示为/dev/ttyUSB0
   

2. 安装必要工具：

   sudo apt install arduino-mk avrdude  # Arduino开发工具链
   

3. 测试连接：

   screen /dev/ttyUSB0 115200  # 连接到串口设备
   

💡 调试技巧：若出现权限问题，执行sudo usermod -aG dialout $USER将用户添加到dialout组，注销后生效。

3.3 专业设备：USB转串口与数据采集卡

以Modbus RTU设备为例：

1. 安装通信库：

   sudo apt install libmodbus-dev  # Modbus协议库
   

2. 测试设备通信：

   modbusrtu -a 1 -b 9600 -p none /dev/ttyUSB0  # 读取设备数据
   

常见误区：USB转串口设备常因驱动问题导致通信不稳定，建议使用dmesg | grep tty命令检查驱动加载情况。

四、进阶拓展：性能优化与高级配置

4.1 性能调优参数

修改WSL配置文件.wslconfig：

[wsl2]
networkingMode=mirrored  # 镜像网络模式，降低USB/IP延迟
memory=4GB  # 分配足够内存避免数据传输中断

4.2 自动连接与热插拔

创建Windows任务计划程序：

1. 触发器："当USB设备连接时"
2. 操作：执行PowerShell脚本

   usbipd bind --busid 2-1 && usbipd attach --wsl --busid 2-1
   

4.3 跨网络设备共享

在局域网内共享USB设备：

# 在主机端设置
usbipd bind --busid 2-1
usbipd listen --address 0.0.0.0 --port 3240

# 在另一台WSL中连接
sudo usbip attach -r 192.168.1.100 -p 3240 -b 2-1

⚠️ 安全警告：网络共享功能仅在可信局域网中使用，避免暴露公网接口。

五、问题诊断与解决方案

5.1 设备附加失败

• 症状：usbipd attach命令提示"无法找到WSL发行版"
• 解决：指定发行版名称usbipd attach --wsl --distribution Ubuntu --busid 2-1

5.2 WSL中设备消失

• 症状：lsusb突然无法找到设备
• 解决：

  usbipd detach --busid 2-1
  usbipd bind --busid 2-1
  usbipd attach --wsl --busid 2-1
  

5.3 传输速度缓慢

• 症状：文件传输速度远低于USB 2.0标准
• 解决：切换网络模式为mirrored（WSL 2支持）并关闭Windows防火墙对WSL的限制

六、总结与最佳实践

通过usbipd-win工具，WSL 2用户终于能够突破设备访问限制，实现从简单存储设备到专业工业设备的全面支持。最佳实践建议：

1. 定期更新：保持usbipd-win和WSL内核为最新版本
2. 权限管理：通过udev规则而非手动chmod配置设备权限
3. 场景脚本：为不同设备类型创建专用连接脚本
4. 安全规范：不使用时及时解除设备绑定

图2：Windows Terminal中同时运行多个WSL发行版，展示了USB设备连接后的开发环境

无论是嵌入式开发、数据采集还是移动设备测试，USB设备共享都将显著扩展WSL 2的应用边界，为开发者打造更完整的跨平台工作流。