linuxserver/webtop是否支持使用USB WiFi适配器

该需求完全可以实现。webtop本质是运行在Docker中的完整Linux桌面环境，只要完成USB设备直通、容器内驱动适配两个核心步骤，就能正常使用USB WiFi适配器，和在物理机上使用没有本质区别。

• 宿主机侧预检查
  把USB WiFi适配器插到宿主机上，在宿主机终端执行lsusb，在输出结果里找到你的WiFi适配器条目，记下两个关键信息：一是设备的VID/PID（格式为xxxx:xxxx，比如常见瑞昱8812au芯片的ID是0bda:8812），二是设备所在的总线号、设备号（比如输出里Bus 002 Device 005就代表在2号总线、5号设备）。

  提示：如果宿主机已经自动加载了该WiFi适配器的驱动，建议先在宿主机上把对应网卡禁用，或者临时解绑驱动，避免宿主机占用设备导致直通失败，等确认直通正常后再处理宿主机侧的占用问题即可。

• 配置容器USB直通启动参数
  启动webtop容器时必须添加两类参数：
  1. 设备直通参数：格式为--device=/dev/bus/usb/[总线号]/[设备号]，对应你刚才从lsusb里查到的信息填写，比如刚才举的2号总线5号设备的例子，参数就是--device=/dev/bus/usb/002/005。如果需要频繁插拔适配器，可以用udev规则加usbip的方式做自动直通，不用每次插拔都改启动参数。
  2. 权限参数：要么直接加--privileged给容器提权（简单省事，个人使用场景推荐），要么单独添加NET_ADMIN、SYS_RAWIO两个cap权限，否则容器内没有权限操作无线网卡做扫描、连接操作。
• 容器内安装适配驱动
  容器启动后进入webtop桌面，打开内置终端先执行lsusb，确认WiFi适配器已经能在容器内被识别到，再根据你用的webtop基础镜像安装对应驱动：
  • 基于Debian/Ubuntu的镜像：先执行apt update，安装firmware-linux-free、firmware-misc-nonfree两个包，绝大多数主流WiFi芯片的开源固件都包含在内；如果是瑞昱、博通的部分闭源芯片，开源固件不支持的话，需要对应下载芯片驱动源码，编译安装即可。
  • 基于Alpine的镜像：先执行apk add linux-firmware安装基础固件包，缺什么固件再单独补装就行。
    驱动安装完成后重启容器，就能在桌面的网络设置里看到无线网卡，正常搜索连接WiFi即可。

• 容器内执行lsusb看不到适配器：先检查宿主机上的AppArmor、SELinux是否拦截了Docker的设备访问权限，临时关闭安全模块测试如果能正常识别，添加对应放行规则即可。
• 能看到设备但是搜不到WiFi信号：优先检查容器是否加了足够的操作权限，没有NET_ADMIN权限的话，容器内的系统无权触发无线网卡的扫描、认证流程。
• 驱动安装完成还是无法启动网卡：Docker容器共享宿主机内核，你安装的驱动版本必须和宿主机运行的内核版本完全匹配，否则驱动无法正常加载，核对版本重新编译安装即可。

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