如何在WSL2的Docker化Flask应用中访问Windows蓝牙(BLE)设备？

问题背景 #

我正尝试将一个与蓝牙低功耗（BLE）设备交互的Flask应用容器化，运行在Windows 11的WSL2（Ubuntu）环境中。

已完成操作 #

• 搭建WSL2与Docker Desktop：
  • 在WSL2中安装Ubuntu系统
  • 安装带WSL2集成的Docker Desktop
• 安装usbipd-win以挂载USB蓝牙适配器：
  • 执行usbipd list找到USB蓝牙适配器（BUSID 2-1）
  • 执行命令挂载到WSL2：usbipd attach --busid 2-1 --wsl Ubuntu
• 在WSL2中验证设备：
  • lsusb命令显示蓝牙适配器：Bus 002 Device 002: ID 0a12:0001 Cambridge Silicon Radio, Ltd Bluetooth Dongle (HCI mode)
• 启用Systemd并安装蓝牙相关包：
  • 修改/etc/wsl.conf以启用systemd
  • 安装bluetooth、bluez等包
• 尝试启动蓝牙服务：
  执行命令：sudo systemctl start bluetooth
  报错：Bluetooth service was skipped because of an unmet condition check (ConditionPathIsDirectory=/sys/class/bluetooth).
• 检查蓝牙目录：
  执行命令：ls /sys/class/bluetooth
  结果：No such file or directory
• 尝试使用bluetoothctl与hciconfig：
  • 两者均报错提示未找到蓝牙硬件

遇到的问题 #

• 无法让WSL2中的蓝牙服务识别USB蓝牙适配器
• 导致Docker化的Flask应用无法访问BLE设备

咨询问题 #

1. 如何在Windows的WSL2环境中，为Docker化的Flask应用启用BLE访问权限？
2. 有没有办法让蓝牙服务识别该适配器？
3. 在此环境下，有没有其他方式让Docker应用访问BLE设备？

解决方案 #

1. 为Docker化Flask应用启用BLE访问权限 #

要让容器正常访问BLE设备，需在启动容器时配置权限和目录挂载：

docker run --privileged -v /sys/class/bluetooth:/sys/class/bluetooth -v /var/run/dbus:/var/run/dbus your-flask-image

• --privileged：赋予容器主机级设备访问权限，确保能读取蓝牙硬件
• -v /sys/class/bluetooth:/sys/class/bluetooth：将WSL2的蓝牙设备类目录挂载到容器内
• -v /var/run/dbus:/var/run/dbus：共享DBus套接字，让容器内的蓝牙服务与主机通信
  同时，容器镜像中需要预安装bluez、bluetoothctl等蓝牙依赖包。

2. 让WSL2蓝牙服务识别适配器 #

报错核心是内核未加载蓝牙驱动模块，导致系统无法识别蓝牙设备节点，按以下步骤修复：

1. 检查并更新WSL2内核：
   执行uname -r确认内核版本≥5.10（WSL2对蓝牙的完善支持从该版本开始），版本过低则运行wsl --update更新内核。
2. 手动加载蓝牙驱动模块：

   sudo modprobe btusb
   sudo modprobe bluetooth
   

   加载后再次执行ls /sys/class/bluetooth，应能看到hci0等设备节点。
3. 重启蓝牙服务：

   sudo systemctl restart bluetooth
   

   此时用bluetoothctl list或hciconfig即可验证设备是否被识别。
4. 重置设备挂载：
   若仍无效，在Windows端卸载蓝牙设备驱动，重新执行usbipd attach --busid 2-1 --wsl Ubuntu挂载。

3. 其他让Docker应用访问BLE设备的方式 #

如果上述方案兼容性不佳，可尝试两种替代思路：

• 直接复用Windows主机蓝牙服务：
  无需将适配器挂载到WSL2，确保Docker Desktop启用"WSL 2 based engine"，启动容器时添加--network host参数，容器内的BLE库会通过主机网络直接调用Windows的蓝牙服务（需保证Windows端蓝牙服务处于运行状态）。
• 蓝牙网络转发：
  在Windows端运行蓝牙转发工具，将BLE设备的信号映射为网络端口，容器内的Flask应用通过TCP/UDP端口与BLE设备交互，绕开硬件直接挂载的兼容性问题。

内容的提问来源于stack exchange，提问作者chanaka