OpenWrt / ImmortalWrt USB 网卡避坑指南

一、USB 网卡芯片选择(买前必看)

推荐优先级

  1. Realtek RTL8153 / RTL8152B(千兆最稳)
    • 代表产品:TP-Link UE300、UE306
    • 驱动:kmod-usb-net-rtl8152
    • 优点:内核原生支持、兼容性极强、ARM 软路由几乎零故障
    • 缺点:无明显缺点,OpenWrt 首选
  2. ASIX AX88179 / AX88179B(性能强)
    • 驱动方式:cdc_ether + cdc_ncm 或专用驱动
    • 优点:速度快、延迟低
    • 缺点:依赖多、内核版本敏感、部分软路由 USB 供电不稳会掉线
  3. 尽量避免
    • 杂牌 RTL8156B 2.5G 网卡(OpenWrt 驱动问题多)
    • 无品牌、无固件信息的 AX88179 山寨网卡
    • 需要频繁模式切换的无线网卡类设备

二、通用必备驱动包(所有 USB 网卡都要装)

bash

运行

opkg update
opkg install kmod-usb-core kmod-usb-net kmod-usb2 kmod-usb3

三、CDC-NCM 网卡(AX88179 等)专用驱动

bash

运行

opkg install \
  kmod-usb-net-cdc-ether \
  kmod-usb-net-cdc-ncm \
  kmod-mii

注意:只装 cdc_ncm 不装 cdc_ether 一定无法识别。


四、插上不识别?排查步骤

  1. 查看 USB 设备是否被识别bash运行lsusb 无输出 → 供电不足 / USB 口坏 / 延长线问题
  2. 查看系统日志bash运行dmesg | grep usb dmesg | grep eth
  3. 查看是否出现新网卡bash运行ip addr 出现 eth2、eth3 等新设备 → 驱动正常

五、Web 界面网卡显示灰色?

灰色 = 驱动正常,但未分配网络用途

解决方法:

  • 加入 br-lan 作为 LAN 口扩展
  • 或新建接口作为 WAN 口(DHCP/PPPoE)分配后图标立即变蓝。

六、USB 网卡经常掉线?

原因:USB 自动省电挂起

解决:

bash

运行

echo 2 > /sys/module/usbcore/parameters/autosuspend

七、速度跑不满、CPU 占用高?

  1. 必须插 USB 3.0 蓝色接口
  2. 避免使用劣质延长线、多口 Hub
  3. ARM 软路由性能有限,不要同时跑:
    • Docker
    • SQM / QoS
    • 多拨 / 流量叠加
    • USB 硬盘读写 + USB 网卡

八、防火墙与网络安全规则

  1. USB 网卡必须归属 lan 或 wan 区域,不可裸奔
  2. 做多 WAN 叠加要避免二层环路
  3. 不建议频繁热插拔 USB 网卡

九、OpenWrt 内核模块铁律

  1. 内核模块版本必须与固件内核完全一致
  2. 小版本不匹配 → 装不上 / 格式错误 / 无法加载
  3. 最稳方案:自己编译固件时直接内置驱动

十、最优使用总结

  1. 优先买 RTL8153 芯片网卡
  2. 自己编译固件,驱动直接内置
  3. USB 插 3.0 口,不用 Hub
  4. 识别后加入网桥或设置 WAN
  5. 关闭 USB 自动挂起,稳定不掉线
此条目发表在计算机技术分类目录。将固定链接加入收藏夹。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注