背景介绍
在 WSL2 环境中使用 USB 无线网卡，主要有以下几个驱动因素：
- 资源效率与便捷性：相较于完整的虚拟机方案，WSL2 更为轻巧，避免了额外虚拟化层的开销。对于希望在 Linux 环境下进行无线网络操作，又不愿负担完整虚拟机资源占用的用户而言，这是一个理想的选择。
- 特定应用场景需求：尤其对于网络安全研究人员或开发者，他们可能需要在 WSL2 内运行的 Kali Linux 等发行版中直接访问和控制无线网卡，以进行 WiFi 渗透测试、网络嗅探、数据包注入或开发基于 WiFi 的应用。原生驱动的 USB 网卡能提供更底层的硬件访问能力和更佳的性能。
- 利用现有 Linux 生态：许多 USB 无线网卡（如本文中的 MT7921U）在 Linux 内核中已经拥有成熟的驱动支持。通过内核编译，可以将这些驱动集成到 WSL2 的 Linux 环境中，充分利用 Linux 强大的网络功能和丰富的工具链。
尽管 WSL2 提供了强大的 Linux 兼容性，但对于 USB 无线网卡的直接支持并非开箱即用，主要面临以下挑战：
- 内核版本与驱动限制：WSL2 默认提供的 Linux 内核版本可能较旧（例如，在某些时期稳定版内核为 5.15.x 系列）。对于一些较新的无线网卡芯片组（如 MediaTek MT7921 系列），其驱动可能需要更新的内核版本（如 5.18 或更高版本）才包含或完善支持。因此，直接在旧版内核上使用这些新网卡可能会遇到驱动缺失或不兼容的问题。
- USB 设备转发机制：虽然 Windows 提供了
usbipd-win工具，可以将物理 USB 设备从 Windows 主机转发到 WSL2 虚拟机中，但这仅仅解决了设备连接的问题。WSL2 内的 Linux 系统仍然需要相应的驱动程序才能识别和使用该 USB 设备。如果内核中没有包含特定无线网卡的驱动模块，即使设备成功转发，也无法正常工作。
因此，为了在 WSL2 中成功使用像 MT7921U 这样的 USB 无线网卡，通常需要用户手动编译包含相应驱动模块的 WSL2 内核，并进行正确的配置。本文将以 MT7921U 无线网卡为例，详细介绍这一过程。
过程
安装固件
由于某些原因系统无法识别固件文件
[ 10.101267] mt7921u 2-1:1.0: Direct firmware load for mediatek/WIFI_RAM_CODE_MT7961_1.bin failed with error -2
[ 10.421071] mt7921u 2-1:1.0: Direct firmware load for mediatek/WIFI_MT7961_patch_mcu_1_2_hdr.bin failed with error -2
因此内核编译过程中需要将固件编译进内核，需要先安装 mt7921 的固件
sudo apt install firmware-mediatek
- mediatek/WIFI_RAM_CODE_MT7961_1.bin
- mediatek/WIFI_MT7961_patch_mcu_1_2_hdr.bin
也可以去linux存储库上下载上述的驱动程序并放置在 /lib/firmware/mediatek/ 目录下
内核编译
参考资料 https://github.com/microsoft/WSL2-Linux-Kernel、 https://gist.github.com/fOmey/33b0e8b2b492bacd1a0839e929ecffea
依赖项
sudo apt update && sudo apt upgrade
sudo apt install flex bison libssl-dev libelf-dev git dwarves bc make libncurses-dev python3
拉取内核源码并解压
确保你不在一个 /mnt/c 路径中（读写速度会非常慢）
cd ~
从https://github.com/microsoft/WSL2-Linux-Kernel/releases/获取最新支持的内核版本
export WSL_KERNEL_VERSION=6.6.87.1
wget https://github.com/microsoft/WSL2-Linux-Kernel/archive/refs/tags/linux-msft-wsl-$WSL_KERNEL_VERSION.tar.gz
tar -xvf linux-msft-wsl-$WSL_KERNEL_VERSION.tar.gz
更换目录到内核源码
cd WSL{TAB}
修改 WSL2 内核配置
make menuconfig KCONFIG_CONFIG=Microsoft/config-wsl
进行以下修改
1. 将固件编译进内核
- Device Drivers
- Generic Driver Options
- Firmware loader
- Build named firmware blobs into the kernel binary
- Firmware loader
- Generic Driver Options
输入
mediatek/WIFI_RAM_CODE_MT7961_1.bin mediatek/WIFI_MT7961_patch_mcu_1_2_hdr.bin
并按回车
确认 Firmware blobs root directory 的值为 /lib/firmware
2. 启用驱动支持
- Device Drivers
- Network device support
- Wireless LAN
- MediaTek devices
<M>MediaTek MT7921U (USB) support
- MediaTek devices
- Wireless LAN
- Network device support
M表示编译为模块，后续我们会进行配置以加载
3. 将 cfg80211 和 mac80211 编译进内核
- Networking support
- Wireless
<*>cfg80211 - wireless configuration API<*>Generic IEEE 802.11 Networking Stack (mac80211)
- Wireless
* 表示编译进内核，默认为 M
附：恢复旧版本的一些功能
microsoft/WSL2-Linux-Kernel 新版的内核减少了一些功能（本来是内核内置的改为模块编译），会导致一些功能异常，比如无法运行 Docker Desktop
因此我写了一个脚本将内核编译配置恢复成旧版配置
准备好稳定版（5.15）和当前版本的配置文件，运行以下脚本可以将稳定版中为y当前版本为m/n的改为y
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
import re
def parse_config_file(filepath):
"""
解析内核配置文件，提取 CONFIG_ 选项及其值。
返回一个字典，键是选项名，值是选项值。
忽略注释掉的选项，例如 '# CONFIG_FOO is not set'。
"""
config_options = {}
# 正则表达式匹配有效的 CONFIG_XXX=y 或 CONFIG_XXX=m 行
# 它会捕获选项名 (CONFIG_FOO) 和值 (y, m, "string", 123 等)
config_line_regex = re.compile(r"^(CONFIG_[A-Za-z0-9_]+)=(.*)$")
try:
with open(filepath, 'r', encoding='utf-8') as f:
for line in f:
line = line.strip()
match = config_line_regex.match(line)
if match:
option_name = match.group(1)
option_value = match.group(2)
# 对于字符串值，它们通常被引号包围，我们去掉引号
if option_value.startswith('"') and option_value.endswith('"'):
option_value = option_value[1:-1]
config_options[option_name] = option_value
except FileNotFoundError:
print(f"错误：文件 '{filepath}' 未找到。")
return None
except Exception as e:
print(f"解析文件 '{filepath}' 时发生错误：{e}")
return None
return config_options
def find_specific_options(config_path_6_6, config_path_5_15):
"""
找出在 config_path_6_6 中为 'm' 或 'n'，且在 config_path_5_15 中为 'y' 的选项。
然后修改 config_path_6_6 文件，将这些选项的值更改为 'y'。
"""
print(f"正在解析文件: {config_path_6_6}")
options_6_6 = parse_config_file(config_path_6_6)
if options_6_6 is None:
return
print(f"正在解析文件: {config_path_5_15}")
options_5_15 = parse_config_file(config_path_5_15)
if options_5_15 is None:
return
options_to_modify_in_6_6 = [] # 用于存储需要修改的选项名
for option, value_6_6 in options_6_6.items():
if value_6_6 == 'm' or value_6_6 == 'n':
if option in options_5_15 and options_5_15[option] == 'y':
options_to_modify_in_6_6.append(option)
if not options_to_modify_in_6_6:
print("\n未找到符合条件需要修改的选项。")
return
print(f"\n在 {config_path_6_6} 中以下选项将被修改为 'y':")
# 按字母顺序排序输出
for opt_name in sorted(options_to_modify_in_6_6):
print(f"{opt_name}=y (原值: {options_6_6[opt_name]})")
try:
with open(config_path_6_6, 'r', encoding='utf-8') as f:
lines = f.readlines()
modified_lines = []
config_line_regex = re.compile(r"^(CONFIG_[A-Za-z0-9_]+)=(.*)$")
for line in lines:
match = config_line_regex.match(line.strip())
if match:
option_name = match.group(1)
if option_name in options_to_modify_in_6_6:
modified_lines.append(f"{option_name}=y\n")
options_6_6[option_name] = 'y' # 更新内存中的值，以防万一
else:
modified_lines.append(line)
else:
modified_lines.append(line)
with open(config_path_6_6, 'w', encoding='utf-8') as f:
f.writelines(modified_lines)
print(f"\n文件 '{config_path_6_6}' 已成功更新。")
except FileNotFoundError:
print(f"错误：文件 '{config_path_6_6}' 在尝试写入时未找到。")
except Exception as e:
print(f"写入文件 '{config_path_6_6}' 时发生错误：{e}")
if __name__ == "__main__":
# --- 请在这里修改你的文件路径 ---
file_config_wsl_6_6 = "config-wsl-6.6" # WSL 6.6 内核配置文件路径
file_config_wsl_5_15 = "config-wsl-5.15" # WSL 5.15（稳定版） 内核配置文件路径
find_specific_options(file_config_wsl_6_6, file_config_wsl_5_15)
4. 保存并退出
向右移动到<Save>进行保存，然后退出
编译
make KCONFIG_CONFIG=Microsoft/config-wsl -j$(nproc)
-j$(nproc)表示调用所有CPU核心进行编译
导出内核
替换 USERNAME 为你的自己的用户名
mv arch/x86/boot/bzImage /mnt/c/Users/USERNAME
配置 WSL
启用 systemd，用于模块自动启动 & 其他有用的服务
sudo vim /etc/wsl.conf
内容：
[boot]
systemd = true
启用 WiFi 网卡驱动模块
写入 /etc/modules-load.d 以进行开机自动加载
echo "mt7921u" | sudo tee -a /etc/modules-load.d/mt7921u.conf
手动加载模块的命令：
sudo modprobe mt7921u
关机
在 Windows 上
wsl --shutdown
在 %UserProfile% 创建/修改 .wslconfig 文件
[wsl2]
kernel=C:\\Users\\USERNAME\\bzImage
其他配置可参考：https://learn.microsoft.com/en-us/windows/wsl/wsl-config#configure-global-options-with-wslconfig
重启并安装内核模块
在 Windows 上
wsl
进入Linux后安装内核模块
cd ~/WSL{TAB}
make INSTALL_MOD_PATH="$PWD/modules" modules_install
验证内核模块是否加载
lsmod
输出：
Module Size Used by
mt7921u 16384 0
mt7921_common 73728 1 mt7921u
mt792x_lib 61440 2 mt7921_common,mt7921u
mt76_connac_lib 86016 3 mt792x_lib,mt7921_common,mt7921u
mt792x_usb 12288 1 mt7921u
mt76_usb 40960 2 mt792x_usb,mt7921u
mt76 118784 6 mt792x_lib,mt792x_usb,mt76_usb,mt7921_common,mt76_connac_lib,mt7921u
连接 USB
参考：https://learn.microsoft.com/zh-cn/windows/wsl/connect-usb，官方文档写的很详细，此处不再赘述
lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 002 Device 003: ID 0e8d:7961 MediaTek Inc. Wireless_Device
lsusb -t
/: Bus 001.Port 001: Dev 001, Class=root_hub, Driver=vhci_hcd/8p, 480M
/: Bus 002.Port 001: Dev 001, Class=root_hub, Driver=vhci_hcd/8p, 5000M
|__ Port 001: Dev 003, If 0, Class=Vendor Specific Class, Driver=mt7921u, 5000M
显示 Driver=mt7921u 则说明驱动正确加载并识别设备
dmesg | grep mt7921u
[ 1.564651] usbcore: registered new interface driver mt7921u
[ 122.874131] mt7921u 2-1:1.0: HW/SW Version: 0x8a108a10, Build Time: 20241106151007a
[ 122.889820] mt7921u 2-1:1.0: WM Firmware Version: ____010000, Build Time: 20241106151045
获得如上输出则说明固件正常写入设备，可以正常运行
iwconfig
wlan0 IEEE 802.11 ESSID:off/any
Mode:Managed Access Point: Not-Associated
Retry short limit:7 RTS thr:off Fragment thr:off
Power Management:on
成功！