深入解析：如何在 WSL 2 中实现 USB 设备支持

前言

在开发环境中，我们经常需要在 Linux 子系统（WSL）中访问 USB 设备。然而，WSL 2 默认不支持 USB 设备连接。本文将详细介绍如何通过 USBIP 技术实现 WSL 2 对 USB 设备的支持，这是项目中一个非常实用的高级功能。

技术背景

WSL 2 采用虚拟化技术运行 Linux 内核，这种架构虽然性能优异，但也带来了与硬件设备交互的限制。USBIP（USB over IP）技术允许通过网络共享 USB 设备，这正是我们实现 WSL 2 USB 支持的关键。

准备工作

系统要求

• Windows 10 Build 19041 或更高版本
• 已启用 WSL 2 功能
• 管理员权限

工具准备

我们需要准备以下组件：

1. USBIP-Win：Windows 端的 USBIP 实现
2. 定制化 WSL 内核：包含 USB 支持模块

详细实现步骤

第一步：获取 USBIP-Win

方法一：手动编译（推荐最新版本）

1. 获取源代码

2. 安装编译环境：

   • Visual Studio
   • Windows SDK
   • Windows Driver Kit

   注意：必须按顺序安装，避免同时安装多个组件。

方法二：使用预编译版本

对于不想编译的用户，可以直接下载预编译版本，但可能不是最新版。

第二步：定制 WSL 内核

1. 安装编译依赖

在 WSL 中执行：

sudo apt install build-essential flex bison libssl-dev libelf-dev libncurses-dev autoconf libudev-dev libtool

2. 获取内核源码

确定当前内核版本：

uname -r

获取对应版本的内核源码：

sudo git clone <内核仓库地址> /usr/src/<内核版本>
cd /usr/src/<内核版本>
sudo git checkout <对应版本标签>

3. 配置内核选项

复制当前配置：

sudo cp /proc/config.gz config.gz
sudo gunzip config.gz
sudo mv config .config

启动配置界面：

sudo make menuconfig

关键配置选项包括：

• USB 核心支持
• USB 存储设备支持
• USB/IP 支持
• 虚拟主机控制器驱动
• 网络适配器支持

4. 编译内核

使用多核编译加速：

sudo make -j 12 && sudo make modules_install -j 12 && sudo make install -j 12

5. 编译 USBIP 工具

cd tools/usb/usbip
sudo ./autogen.sh
sudo ./configure
sudo make install -j 12
sudo cp libsrc/.libs/libusbip.so.0 /lib/libusbip.so.0

6. 创建启动脚本

创建 startusb.sh 脚本加载所有必要模块：

#!/bin/bash
sudo modprobe usbcore
sudo modprobe usb-common
# 其他模块加载命令...

第三步：使用 USBIP 连接设备

Windows 端操作

1. 列出可用设备：

usbip list -l

2. 绑定设备：

usbip bind --busid=<设备ID>

3. 启动守护进程：

usbipd --debug

WSL 端操作

1. 列出远程设备：

sudo usbip list --remote=<Windows IP>

2. 连接设备：

sudo usbip attach --remote=<Windows IP> --busid=<设备ID>

常见问题解决方案

组合设备连接问题

当遇到组合设备无法连接时：

1. 使用 Zadig 工具
2. 安装 libusbK 驱动
3. 重新尝试绑定

设备重新挂载到 Windows

如果需要将设备重新挂载回 Windows：

1. 通过设备管理器找到 USB/IP STUB 设备
2. 手动更新驱动程序
3. 选择原始设备驱动

设备无法识别

尝试：

1. 更换 USB 端口
2. 重新绑定设备
3. 检查内核模块是否加载完整

技术限制

当前方案存在以下限制：

1. 不支持直接绑定组合设备的子设备
2. 无法连接 USB Hub 设备
3. 某些特殊设备可能需要额外驱动支持

结语

通过本文介绍的方法，我们成功地在 WSL 2 环境中实现了对 USB 设备的支持。虽然过程略显复杂，但对于需要在 Linux 环境中使用 USB 设备的开发者来说，这无疑是一个非常有价值的解决方案。随着技术的不断发展，我们期待微软能够提供更原生的 USB 支持方案。

希望这篇教程能够帮助你顺利地在 WSL 2 中使用 USB 设备。如果在实施过程中遇到任何问题，可以参考文中的故障排除部分，或者查阅相关技术文档获取更多帮助。