Linux 安装腾达 U12 无线网卡驱动

腾达(Tenda)U12 是一款性价比极高的 AC1300 双频 USB 3.0 外置无线网卡(支持 5GHz 867Mbps + 2.4GHz 400Mbps),其核心硬件方案采用的是经典广受好评的 Realtek RTL8812AU 芯片。

在 Windows 和 macOS 下,这款网卡几乎开箱即用或官网一键驱动即可点亮;但在 Linux 生态中,它却是许多极客的“噩梦”:

  1. 主线内核缺失:Linux Mainline 官方内核源码树至今未原生合入完善的 RTL8812AU 驱动;
  2. 官方驱动早已年久失修:腾达官网随附的 Linux 驱动停留在 Linux 3.x / 4.x 古早时代,在现代 Linux 5.x / 6.x 内核与现代 GCC 编译器下编译会直接触发上百行语法错误;
  3. 滚动更新陷阱(最致命):很多教程教你无脑 make && sudo make install,而在 Arch Linux 这种滚动更新发行版上,只要下一次执行 pacman -Syu 升级了 Linux 内核,重启后网卡就会瞬间失联暴毙!

本文将针对现代 Linux 内核(以 Arch Linux、Ubuntu 为代表),详解现代社区驱动分支选型、DKMS 自动跟踪内核升级机制、USB 3.0 稳定性调优及断网排坑全指南。


一、硬件核验:识别设备真实身份

在动手编译前,先把腾达 U12 插入电脑 USB 3.0 接口(通常为蓝色接口),在终端执行 lsusb 查看硬件 ID:

1
lsusb

控制台通常会输出类似以下条目之一:

1
2
3
4
5
# 情况 1:直接识别为 Realtek 原厂 ID
Bus 001 Device 004: ID 0bda:8812 Realtek Semiconductor Corp. RTL8812AU 802.11a/b/g/n/ac 2T2R DB WLAN Adapter

# 情况 2:识别为腾达厂商定制贴牌 ID
Bus 001 Device 004: ID 2604:0012 Tenda U12 802.11a/b/g/n/ac Wireless Adapter

只要设备 ID 中包含 0bda:8812 或 2604:0012,就证实其底层芯片确为 RTL8812AU,完全适用本文方案。


二、上游驱动分支选型:告别僵尸仓库

网上很多老旧教程引用的 GitHub 仓库(如早期著名的 gnab/rtl8812au),早在近十年前就已经归档停止维护。如果强行克隆编译,会直接因内核 API 变更而崩溃报错。

目前开源社区主要有两个活跃维护的现代化分支:

驱动分支仓库维护团队核心优势推荐场景
aircrack-ng/rtl8812au安全审计社区主力维护完美适配 Linux 5.x ~ 6.x+,原生支持监听模式(Monitor Mode)与数据包注入(Frame Injection)🏆 首选推荐(兼顾日常高速上网与网络安全审计)
morrownr/8812au-20210629Linux 社区无线硬件极客专注家用网络吞吐性能、AP 热点模式与抗断连优化备选推荐(注重纯吞吐与信号稳定性)

本文以维护最活跃、受众最广的 aircrack-ng/rtl8812au 分支为核心基准展开。


三、核心杀手锏:为什么必须采用 DKMS?

很多新手安装网卡驱动时,直接在源码目录下敲下:

1
2
make
sudo make install # ❌ 埋下巨大隐患的传统做法!

这种做法将编译出的 8812au.ko 模块硬编码拷贝到了当前运行内核的目录(如 /lib/modules/6.5.0-arch1/)下。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
【传统 make install 致命缺陷】
源码编译 ──> 写入 /lib/modules/6.5.0/ ──> ✅ 当前 WiFi 正常
│
pacman -Syu 系统滚包
内核升级至 6.6.0
│
▼
❌ 重启进入 6.6.0 内核: 找不到模块,网卡瞬间暴毙!
-----------------------------------------------------------------------------
【DKMS (动态内核模块支持) 工业级方案】
源码注册至 DKMS 树 ──> 绑定系统内核升级 Hook
│
pacman -Syu 系统滚包
内核升级至 6.6.0
│
▼
⚡ 自动触发 Hook: 在后台调用新内核头文件自动重新编译 8812au.ko
│
▼
✅ 重启进入 6.6.0 内核: WiFi 依然无缝连通!

DKMS(Dynamic Kernel Module Support) 能够在系统安装新内核包时,通过包管理器 Hook 在后台自动拉取新内核头文件对驱动进行无感重编译,从此一劳永逸,再也不用担心滚内核导致断网失联!


四、全平台安装实战

1. 基础编译依赖与内核头文件准备

在编译内核模块前,必须安装与当前运行内核版本严格匹配的**内核头文件(Kernel Headers)**与基础编译工具链:

Arch Linux / Manjaro:

1
2
3
4
5
6
# 安装基础编译环境、内核头文件与 DKMS
sudo pacman -S base-devel linux-headers dkms git

# 注意:如果你使用的是 LTS 长期支持版内核或 Zen 内核,需安装对应头文件:
# sudo pacman -S linux-lts-headers (LTS 内核用户)
# sudo pacman -S linux-zen-headers (Zen 内核用户)

Ubuntu / Debian:

1
2
sudo apt update
sudo apt install build-essential linux-headers-$(uname -r) dkms git

2. 方式 A:Arch Linux 极简优雅安装(AUR 途径)

如果你使用的是 Arch Linux,社区早已在 AUR 中打包维护了带有 DKMS 自动挂钩的稳定驱动包,推荐直接通过 AUR 助手一键安装:

1
2
3
4
5
# 使用 yay 助手一键安装
yay -S rtl8812au-dkms-git

# 或使用 paru 助手
paru -S rtl8812au-dkms-git

AUR 会自动下载最新源码、配置 DKMS 规则、针对当前所有已安装内核完成自动编译并激活模块。安装完毕后直接跳至本文第六节进行配置调优即可!


3. 方式 B:通用源码 DKMS 自动化部署(适用于所有发行版)

对于不想使用 AUR 或运行在 Ubuntu/Debian/Fedora 环境的用户,可以使用官方源码自带的 DKMS 自动化部署脚本:

1
2
3
4
5
6
# 1. 克隆现代上游驱动源码
git clone https://github.com/aircrack-ng/rtl8812au.git
cd rtl8812au

# 2. 运行仓库自带的 DKMS 安装向导(需要 root 权限)
sudo ./dkms-install.sh

脚本会自动完成以下动作:

  1. 校验当前内核版本与环境依赖;
  2. 将驱动源码同步挂载至 /usr/src/8812au-<version>/;
  3. 执行 dkms add、dkms build 与 dkms install;
  4. 自动激活内核模块。

检查 DKMS 状态:

1
dkms status

若终端返回包含如下信息,即证明 DKMS 挂载与编译彻底成功:

1
8812au/5.6.4.2, 6.6.1-arch1-1, x86_64: installed

五、手动加载与网络服务接管

拔下腾达 U12 并重新插入电脑 USB 接口,或在终端手动加载模块:

1
2
# 重新加载内核模块
sudo modprobe 8812au

检查网络接口是否生成:

1
ip link

你将看到新增了一个无线网络接口(如 wlan0 或基于硬件拓扑命名的 wlp0s20f0u3)。

检查 RF 硬件射频锁状态:

若网卡没有指示灯闪烁或搜不到信号,检查是否被系统软锁(Soft blocked):

1
rfkill list

若显示 Soft blocked: yes,执行解禁指令:

1
sudo rfkill unblock wifi

现在打开你的 NetworkManager(nmcli dev wifi 或桌面网络托盘),即可畅享 5GHz 满血 Wi-Fi 信号!


六、生产级性能调优与抗断网排坑

1. 终结 USB 3.0 射频电磁干扰 2.4GHz 频段

根据 Intel 官方白皮书研究,USB 3.0 接口在数据传输时产生的扩频时钟辐射噪声,恰好落在 2.4GHz ~ 2.5GHz 无线频段上,极易导致 2.4G Wi-Fi 丢包、延迟飙升甚至断连。

驱动提供了底层参数调优支持,我们创建专属内核配置文件:

1
sudo nano /etc/modprobe.d/8812au.conf

写入以下优化参数:

1
2
3
4
5
6
7
8
9
10
11
12
# 启用 USB 3.0 极速传输模式 (1 为启用 USB 3.0,0 为降级强制 USB 2.0 提高抗干扰)
options 8812au rtw_switch_usb_mode=1

# 彻底关闭网卡节能休眠 (0=关闭节能,1=开启省电)
# ⚠️ 极度关键:强力阻止在系统空闲或下载大文件时网卡因电源管理策略意外掉线!
options 8812au rtw_power_mgnt=0

# 禁用低功耗休眠机制
options 8812au rtw_enusbss=0

# LED 灯控制 (1=常态闪烁,0=关闭刺眼蓝光呼吸灯)
options 8812au rtw_led_enable=1

保存后执行重载生效:

1
sudo modprobe -r 8812au && sudo modprobe 8812au

2. 经典排坑:内核升级后未重启导致的编译报错

在 Arch Linux 上执行完 pacman -Syu 后,磁盘上的内核文件和头文件已经升级到了全新版本,但内存中运行的依然是旧内核。此时若立刻执行编译,会提示找不到内核目录:

1
make[1]: *** /lib/modules/6.5.0-arch1/build: No such file or directory. Stop.

排坑解法:养成良好习惯:系统滚包更新内核后,必须先重启电脑(Reboot),再执行任何新驱动的编译或挂载操作。


七、日常维护与驱动卸载

若后续需要卸载或更新驱动,只需执行驱动目录下的卸载脚本:

1
2
cd rtl8812au
sudo ./dkms-remove.sh

或通过 DKMS 命令直接清除:

1
sudo dkms remove -m 8812au -v 5.6.4.2 --all

Linux 安装腾达 U12 无线网卡驱动
https://bubao.github.io/posts/aca5d3de.html
作者
一念
发布于
2021年3月13日
许可协议