OpenWrt下8812au网卡无法识别或驱动加载失败？

Question

在OpenWrt中，8812au（如RTL8812AU AirCrack/AC1200系列）网卡常因内核模块缺失或版本不匹配导致无法识别：`lsusb` 可见设备，但 `iwinfo` 或 `ip link` 无对应无线接口。根本原因多为——官方OpenWrt固件默认未集成闭源的 `rtl8812au_aircrack-ng` 驱动（需 `kmod-rtl8812au-aircrack-ng` 及其固件包），且该驱动对内核版本高度敏感（如23.05仅支持Linux 6.1，而旧版驱动仅适配5.10/5.15）。此外，USB供电不足、设备ID未被驱动白名单收录（如新型号VID/PID未添加）、或与 `kmod-rtl8xxxu` 等冲突驱动共存，亦会触发 probe failure。典型现象包括 `dmesg | grep -i 8812` 显示“no driver”、“unknown symbol”或“Module not found”。解决需严格匹配OpenWrt版本、内核、驱动分支，并手动安装对应IPK（含 `kmod`, `firmware`, `usb-core` 依赖）。

Answer 1

```html

一、现象层：可见设备，不可用接口——典型故障表征

执行 lsusb 可清晰识别 RTL8812AU 设备（如 ID 0bda:8812 或新型号 0bda:c812），但 ip link show 与 iwinfo 均无 wlanX 接口；lsmod | grep 8812 返回空；无线扫描、AP 模式、monitor 模式全部失效。此为「USB 枚举成功但内核未绑定驱动」的明确信号。

二、日志层：dmesg 是真相的唯一信源

运行 dmesg | grep -i -A3 -B3 8812，常见输出包括：

• usb 1-1: Product: RTL8812AU（设备已枚举）
• rtl8812au_aircrack_ng: unknown symbol in module（符号解析失败 → 内核版本/编译选项不匹配）
• usbcore: registered new interface driver rtl8812au_aircrack_ng（驱动注册成功）→ 但后续无 probe 日志 → 表明 VID/PID 不在白名单
• rtl8812au_aircrack_ng: no matching device found（白名单缺失）
• Module not found: rtl8812au_aircrack_ng（kmod 未安装或路径错误）

三、架构层：OpenWrt 驱动生态的三重耦合约束

RTL8812AU 在 OpenWrt 中并非“即插即用”，其可用性受以下三者严格协同控制：

维度	约束说明	典型冲突案例
OpenWrt 版本	23.05 默认内核为 6.1.x；22.03 为 5.15.x；19.07 已废弃	在 23.05 上强行安装适配 5.15 的 kmod → unknown symbol __stack_chk_fail
内核 ABI 兼容性	模块需与 target 内核 CONFIG_MODULE_SIG、CONFIG_DEBUG_INFO 等配置完全一致	自编译固件启用 MODULE_SIG_FORCE，但官方 IPK 未签名 → 拒绝加载
驱动分支演进	aircrack-ng/rtl8812au-aircrack-ng v5.6.x 支持 6.1+；v5.3.4 仅支持 ≤5.15	v5.3.4 编译的 kmod 在 23.05 下触发 Invalid module format

四、依赖层：IPK 安装必须满足的最小完备集

单装 kmod-rtl8812au-aircrack-ng 必然失败。完整依赖链如下（以 OpenWrt 23.05 / x86_64 为例）：

1. kmod-usb-core（USB 子系统基础）
2. kmod-usb2 或 kmod-usb3（依物理端口而定）
3. kmod-crypto-hash + kmod-crypto-aead（WPA3 加密依赖）
4. kmod-mac80211（mac80211 核心框架）
5. kmod-rtl8812au-aircrack-ng（驱动模块）
6. firmware-realtek（含 rtlwifi/rtl8812aefw.bin 固件）
7. iw 与 hostapd（用户态工具，非驱动但功能必需）

五、排错层：结构化诊断流程图

graph TD
  A[lsusb 看到 0bda:8812?] -->|否| B[检查 USB 物理连接/供电]
  A -->|是| C[dmesg | grep -i 8812]
  C --> D{有 “registered new interface driver”？}
  D -->|否| E[未安装 kmod 或模块未加载 → opkg install]
  D -->|是| F{有 “probe ok” 或 “wlanX created”？}
  F -->|否| G[VID/PID 白名单缺失 → 查 github issues 提交设备 ID]
  F -->|是| H[检查 ip link / iwinfo 是否出现接口]
  H -->|否| I[确认 mac80211 是否启动 → /etc/init.d/network restart]

六、修复层：生产环境推荐实施路径

✅ 正确操作序列（以 OpenWrt 23.05.3 为例）：

1. 确认内核版本：uname -r → 应为 6.1.112
2. 下载对应仓库 IPK：https://downloads.openwrt.org/releases/23.05.3/targets/x86/64/packages/
3. 按依赖顺序安装：opkg install kmod-usb2 kmod-mac80211 firmware-realtek kmod-rtl8812au-aircrack-ng
4. 手动触发 probe：echo "0bda c812" > /sys/bus/usb/drivers/rtl8812au_aircrack_ng/new_id（若 VID/PID 新增）
5. 验证固件加载：dmesg | grep -i "firmware load" → 应见 rtlwifi/rtl8812aefw.bin: loaded
6. 重启网络：/etc/init.d/network restart 后 iw dev 应列出 wlan0

七、进阶层：定制化构建与白名单扩展

当设备 VID/PID（如 2357:c012）未被上游驱动收录时，需修改源码并重建：

1. 定位驱动源码：package/kernel/rtl8812au-aircrack-ng/src/core/rtw_usb.c
2. 在 static const struct usb_device_id rtw_usb_id_table[] 中追加：
3. {USB_DEVICE(0x2357, 0xc012), .driver_info = RTL8812},
4. 更新 Makefile 中 PKG_SOURCE_VERSION 并执行 make package/kernel/rtl8812au-aircrack-ng/compile V=s
5. 提取生成的 kmod-rtl8812au-aircrack-ng_*.ipk 部署至目标机

八、避坑层：高频误操作清单

• ❌ 在 23.05 上使用 22.03 的 kmod（ABI 不兼容）
• ❌ 卸载 kmod-rtl8xxxu 后未 reboot（残留内核符号污染）
• ❌ 仅安装 kmod 而忽略 firmware-realtek（固件缺失导致 probe hang）
• ❌ 使用 insmod 手动加载（绕过 depmod，依赖未解析）
• ❌ 忽略 USB 供电：实测部分 AC1200 需 ≥900mA，路由器 USB 口常仅提供 500mA → 触发 usb 1-1: device descriptor read/64, error -71

九、验证层：闭环测试用例集

完成部署后，必须通过以下全链路验证：

测试项	命令	预期输出
内核模块加载	lsmod | grep 8812	rtl8812au_aircrack_ng 3112960 0 - Live 0xffffffffc0a00000
无线接口创建	iw dev	phy#0   Interface wlan0     ifindex 5     wdev 0x1
Monitor 模式支持	iw dev wlan0 set type monitor && ip link set wlan0 up	无报错，且 tcpdump -i wlan0 type mgt 可捕获 beacon

十、演进层：长期维护建议

鉴于 RTL8812AU 驱动持续活跃开发，建议建立可持续维护机制：

• 订阅 GitHub Release 页面，关注 v5.6+ 对 6.6+ 内核的支持进展
• 将自定义 VID/PID 补丁提交至 OpenWrt 主线 PR（https://github.com/openwrt/packages/pulls）
• 在 /etc/hotplug.d/usb/ 下编写 udev 类脚本，自动加载新设备 ID
• 对关键节点（如 /lib/firmware/rtlwifi/）启用 inotifywait 监控，异常时告警
• 建立内核版本 → 驱动分支 → IPK URL 映射表，纳入 CI/CD 流水线校验

```