简介面向 Linux 与 Android 平台的 Realtek RTL8188FU、RTL8188FTV USB 无线网卡驱动合集适合具备一定内核基础、从事嵌入式驱动开发与系统移植的工程人员用于排查无线网卡编译、加载、连接及兼容性问题。压缩包共五十六个文件、约二十四点三二 MB内含驱动源码包、覆盖安卓四点二至八点零各版本的无线网络开发参考代码、认证与热点工具、配置文件、内核补丁以及安装脚本并附多份技术说明文档。目前已有九千六百零三人学习下载。读者可据此完成驱动编译安装与模块加载参考各版本代码开展安卓平台移植了解站点模式、软热点、桥接、点对点投屏、省电、规范支持和调试日志等功能的配置方法也能借助版本说明与快速入门资料定位差异、减少反复试错。1. 一块十几块钱的 USB 网卡插上没反应RTL8188FU/FTV 驱动到底补了哪块短板电商平台搜 USB WIFI REALTE 8188FT出来的大多是十几块钱的 2.4GHz 单频小网卡拆开看芯片基本是 RTL8188FU 或它的 TV 变体 RTL8188FTVUSB 2.0 接口、802.11n、标称 150Mbps、只有 2.4G。插到工控机、树莓派或者安卓盒子上lsusb能看见0bda:f179、0bda:c820、0bda:a729这类 IDip link里却空荡荡。内核自带的rtl8xxxu对这两个型号支持时有时无较新的内核分支干脆不认dmesg里连个 wlan 设备名都不给。这份驱动源码包补的就是这块一整套 C 代码Linux 与 Android 两套编译入口编出来的8188fu.ko直接insmod就能起接口。适合手上有几台设备要批量铺无线链路、又不想为每台机器换一张Linux 免驱卡的人。2. 拆开源码包RTL8188FU 与 RTL8188FTV 共用一套 802.11 状态机2.1 目录骨架与两个芯片变体的宏开关拿到包先别急着make用tree -L 2扫一遍心里有张地图比什么都强。这类原厂驱动包的目录组织高度一致看懂了这一份后面遇到同系列的 8188FS、8192FU 迁移成本很低。路径作用实际改动频率os_dep/linux/usb_intf.cUSB 探测、VID/PID 表、电源管理回调、probe 入口高os_dep/linux/ioctl_cfg80211.ccfg80211_ops 注册扫描/连接/密钥下发中os_dep/linux/ioctl_linux.cwext 私有 ioctl老工具链靠它低os_dep/linux/xmit_linux.cskb 收发、netdev_ops、队列映射低os_dep/android/安卓平台适配、框架层对接中core/rtw_*.c802.11 管理帧、扫描、关联、加密、AP 模式低hal/、halrf/PHY 参数、射频校准、功率表、信道表低include/autoconf.h编译期总开关全篇最关键的一个头文件高firmware/rtl8188fufw.bin运行时由request_firmware拉起的固件不改RTL8188FU 和 RTL8188FTV 在这份源码里不是两套代码。二者共用同一个core与hal差异集中在 USB PID 表、部分射频功率参数表和电源管理的默认值上靠autoconf.h里的CONFIG_RTL8188F宏统一打开。这意味着你不需要为两个型号维护两份工程只要把 PID 表补齐、把 RF 参数按型号选对一个.ko能同时覆盖两种料。我一般会在usb_intf.c的 ID 表上方加一行注释把现场见过的 PID 都记下来下次换批次不用重新查。2.2 autoconf.h 与 Makefile编译期真正影响行为的七个开关autoconf.h是这套驱动的中枢里面几十个CONFIG_宏但真正会咬人的就那几个。新手最容易犯的错是把所有宏都打开图省事结果编出来的模块又大又不稳还找不到原因。/* include/autoconf.h 节选按需开启不要全开 */ #define CONFIG_RTL8188F /* 芯片型号8188FU/FTV 共用 */ #define CONFIG_USB_HCI /* USB 总线接口 */ #define CONFIG_CFG80211 /* 提供 nl80211 接口iw/hostapd 要用 */ #define CONFIG_WEXT_PRIV /* 保留 wext老工具链兜底 */ /* #define CONFIG_POWER_SAVING */ /* 默认开会掉速、会断流桌面端建议关 */ #define CONFIG_LPS_32K /* 低功耗睡眠和 POWER_SAVING 二选一 */ /* #define CONFIG_MP_INCLUDED */ /* 产测模式量产固件必须关掉 */ /* #define CONFIG_CONCURRENT_MODE */ /* 双接口并发单网卡场景开了纯属浪费内存 */ #define CONFIG_RFKILL /* 有硬件 rfkill 开关的机器要开 */每个宏背后都是实打实的行为差异。CONFIG_POWER_SAVING打开后空载时驱动会把射频打进休眠省电是真省但配合某些 USB HUB 会出现闲置三分钟必掉线的玄学问题桌面和工控场景我一般直接注释掉。CONFIG_MP_INCLUDED会把产测命令通道编进去能通过 ioctl 直接发裸包改功率产线用得上出货固件留着就是个后门。CONFIG_CFG80211关掉的话iw直接报nl80211 not found只有iwconfig还能用新系统上基本等于残废。Makefile 那边负责的是平台分支原理是给不同目标板预设ARCH、CROSS_COMPILE、KSRC三个变量。典型的写法长这样ifeq ($(CONFIG_PLATFORM_I386_PC), y) EXTRA_CFLAGS -DCONFIG_LITTLE_ENDIAN ARCH : x86_64 CROSS_COMPILE : KSRC : /lib/modules/$(shell uname -r)/build endif ifeq ($(CONFIG_PLATFORM_ARM_RPI), y) EXTRA_CFLAGS -DCONFIG_LITTLE_ENDIAN -DCONFIG_IOCTL_CFG80211 ARCH : arm CROSS_COMPILE : arm-linux-gnueabihf- KSRC : /lib/modules/$(shell uname -r)/build endifKSRC指向的是已经配置并编译过一次的内核源码树或头文件包不是随便一个/usr/src/linux目录。判断标准很简单目录下同时存在.config、Module.symvers、include/generated/autoconf.h三个文件。缺Module.symvers会报符号未定义缺.config会按默认配置编产出的 vermagic 和你正在跑的内核对不上insmod时一句version magic should be就把你挡在门外。2.3 它不走 mac80211自带全栈对编译和抓包意味着什么这一点决定了后面所有的排错思路必须说清楚。这份驱动没有依赖内核的mac80211软栈它自己实现了 802.11 状态机直接注册net_device再挂一组自己的cfg80211_ops。业内的说法叫 fullmac 风格虽然这颗芯片本身是 softmac 硬件但驱动把 MAC 层的大部分活儿揽到了自己身上。好处在 Android 上体现得最明显。很多设备内核根本没编mac80211或者只把它作为 GKI 的受限符号导出这时候任何依赖mac80211的驱动都加载不了而这份驱动只要内核有cfg80211就能跑。坏处有两个一是hostapd的 nl80211 路径只实现了一部分开 AP 模式经常要配驱动自带的补丁版hostapd标准版可能卡在nl80211: Could not configure driver mode二是抓包不能靠mac80211的 monitor 接口得用驱动自己的 monitor 模式iw dev wlan0 interface add mon0 type monitor有时候不生效得改源码里的CONFIG_MONITOR_MODE再重编。理解了这层架构你就不会在modprobe mac80211上浪费时间也不会指望它和iwlwifi那种驱动一样听话。它就是一套自带生态的东西能用、能连、能跑吞吐但边界很清楚。3. Linux 侧编译实录从 make 到 iw dev 里冒出 wlan13.1 依赖装载与内核头路径自检先解决能编的问题。桌面发行版上标准动作就三条命令装编译链、装当前内核的头文件、确认build软链指对了地方。sudo apt update sudo apt install -y build-essential bc kmod git linux-headers-$(uname -r) # 确认 build 软链和关键文件都在 ls -l /lib/modules/$(uname -r)/build ls /lib/modules/$(uname -r)/build/{.config,Module.symvers}linux-headers-$(uname -r)这个包名在 Debian/Ubuntu 系成立Fedora 系对应kernel-develArch 系是linux-headers名字不同但本质一样一份预配置好的头文件树加上Module.symvers。如果第二条ls报No such file说明你装的头和跑的内核不是同一个版本或者内核是自己编的但没执行make modules_install。自己编内核的场景要特别注意Module.symvers必须来自那次编译的输出目录不能从别处拷否则符号 CRC 对不上加载时报disagrees about version of symbol。树莓派这类 ARM 板子上还有一个坑官方内核的build软链指向/usr/src/linux-headers-xxx-v8但这棵树的.config里CONFIG_CFG80211可能是模块而非内建insmod前得先modprobe cfg80211不然驱动加载时会报一堆unknown symbol in module新手很容易误判成代码问题。3.2 改平台宏、指定 KSRC把 8188fu.ko 编出来平台宏和KSRC都改对之后编译本身很快几十秒的事。x86 本地编译最省事因为uname -r直接给出了正确的内核版本。cd rtl8188fu-driver # 只留 x86 平台分支其余关掉避免多个 KSRC 互相覆盖 sed -i s/^CONFIG_PLATFORM_I386_PC y/CONFIG_PLATFORM_I386_PC y/ Makefile sed -i s|^KSRC :.*|KSRC : /lib/modules/$(shell uname -r)/build| Makefile make clean make -j$(nproc) 21 | tee build.log ls -lh 8188fu.kotee build.log这个习惯救过我很多次编译报错动辄几百行滚屏之后想回头找第一条 error 基本靠翻日志。make clean也别省这套驱动的依赖关系写得不算严谨改了autoconf.h不 clean 直接编经常出现宏没生效的假象。交叉编译换三个变量就行以树莓派 32 位系统为例make clean make ARCHarm CROSS_COMPILEarm-linux-gnueabihf- \ KSRC/lib/modules/$(uname -r)/build \ -j$(nproc) # 验证产物架构别把 aarch64 的 ko 拷到 armhf 机器上 file 8188fu.koARCH要和目标内核的架构严格一致CROSS_COMPILE末尾那个短横线不能丢丢了会拼出arm-linux-gnueabihf-gcc变成arm-linux-gnueubihfgcc这种不存在的名字。KSRC如果是在 x86 主机上给树莓派编要指向树莓派的内核头文件树不能指本机的这一步搞错了file一看架构就露馅。3.3 固件落位、depmod 与 insmod 后的第一轮 dmesg 检查模块编出来不等于能跑固件没放对位置驱动照样起不来或者起来后扫不到任何 AP。# 固件有两个常见搜索路径两个都放一份最稳妥 sudo cp firmware/rtl8188fufw.bin /lib/firmware/ sudo cp firmware/rtl8188fufw.bin /lib/firmware/rtlwifi/ 2/dev/null || true sudo depmod -a sudo modprobe cfg80211 sudo insmod ./8188fu.ko dmesg | tail -40depmod -a的作用是刷新模块依赖索引只有你打算用modprobe 8188fu而不是insmod时才必须但养成习惯没坏处。真正要看的是dmesg尾部那几十行正常的加载序列会依次出现 USB 设备枚举、厂商与产品 ID、固件加载成功、wlan0或wlan1注册。如果只看到枚举没有注册八成是 PID 没匹配上如果看到request_firmware failed就是固件路径问题如果看到rtw_cfg80211_init_wiphy之类的失败那多半是cfg80211没提前加载。ip link里出现新接口后先别急着连网iw dev看一遍能力集ip link show iw dev iw phy | grep -A5 Supported interface modes确认managed模式在列Supported bands里只有 2.4GHz信道 1 到 13这就对上了。如果iw phy报No such device说明cfg80211注册失败回头翻dmesg。3.4 用 wpa_supplicant 打通一条链路并量化吞吐验证驱动能不能用最快的办法是拿wpa_supplicant连一个已知能用的 AP别一上来就折腾 AP 模式。cat /tmp/wpa-2g.conf EOF ctrl_interface/var/run/wpa_supplicant network{ ssidlab-2g psk12345678 key_mgmtWPA-PSK protoRSN pairwiseCCMP scan_ssid1 } EOF sudo ip link set wlan0 up sudo wpa_supplicant -i wlan0 -c /tmp/wpa-2g.conf -B sudo dhclient -v wlan0 iw dev wlan0 link ping -c 20 -i 0.2 192.168.1.1 iperf3 -c 192.168.1.100 -t 30 -P 4配置里key_mgmtWPA-PSK加protoRSN加pairwiseCCMP是最稳的组合这颗芯片不支持 WPA3-SAEproto里写RSN但密码套件用 TKIP 也会连不上。scan_ssid1对隐藏 SSID 有必要普通网络加了也无害。iw dev wlan0 link输出里的signal和bitrate是两个关键指标信号低于 -70dBm 时 2.4G 的重传率会明显上升。iperf3实测能到 40 到 70Mbps 属于正常区间150Mbps 是理论物理层速率单天线 20MHz 带宽下实际吞吐打对折是常态。如果只有几 Mbps 且iw dev显示tx failed计数器一直涨先换 USB 口再换短一点的线最后才怀疑驱动。4. Android 侧交叉编译让 vendor 分区里的 .ko 真被加载4.1 安卓内核与桌面内核在这份驱动上的三处硬差异同样一套代码在桌面上编完就能用在安卓上往往卡在三个地方而且每一处都不会给你明确报错。第一是符号导出。安卓设备内核为了精简会把cfg80211的部分函数改成不导出驱动里调用的cfg80211_*只要有一个不在Module.symvers里insmod就直接报unknown symbol。第二是模块签名很多量产内核开了CONFIG_MODULE_SIG_FORCE没签名的.ko一律拒绝加载报module verification failed。第三是 SELinux就算insmod成功了wpa_supplicant去操作接口时也可能被策略挡掉dmesg里一串avc: denied。这三处不是代码问题是构建体系和策略问题得分别处理。GKI 之后情况更微妙一些。5.10 以上的通用内核镜像只允许供应商模块使用 KMI 白名单里的符号白名单外的符号即使导出也会被裁掉。这份驱动用的cfg80211接口大部分在列但wext相关的那部分不一定所以安卓侧优先走 nl80211 路径把CONFIG_WEXT_PRIV当兜底而不是首选。4.2 交叉工具链与 KSRC命令行长什么样安卓的编译命令和 Linux 只差环境变量但每个变量的来路都得说清楚。export ARCHarm64 export CROSS_COMPILE/prebuilts/gcc/linux-x86/aarch64/aarch64-linux-android-4.9/bin/aarch64-linux-android- export KSRC/path/to/device-kernel # 编译该设备 boot.img 时用的那棵树 export CLANG_TRIPLEaarch64-linux-gnu- make clean make -j$(nproc) \ ARCH$ARCH \ CROSS_COMPILE$CROSS_COMPILE \ KSRC$KSRC \ 21 | tee build-android.logKSRC是整件事的命门。它必须是编译该设备内核时用过的那棵源码树目录下要有.config、Module.symvers、include/generated/、scripts/。随便下一份同版本内核源码是没用的.config里的CONFIG_LOCALVERSION、编译时间戳、符号 CRC 全都不一样编出来的模块一insmod就是version magic不匹配。我一般会在设备树目录里留一个build.sh把KSRC写死避免几个月后回来找不到对应关系。工具链版本也要贴。用 4.9 的 GCC 编 5.10 内核的模块大概率报unrecognized command line option。更稳的做法是直接用内核树里prebuilts自带的那个交叉编译器路径从设备内核的构建脚本里抄别自己另找。4.3 模块签名、modules.load 与 SELinux 上下文模块编出来了怎么塞进去、塞进去怎么被系统认这一段是最容易前功尽弃的地方。adb root adb remount adb push 8188fu.ko /vendor/lib/modules/8188fu.ko adb shell chmod 644 /vendor/lib/modules/8188fu.ko adb shell restorecon -v /vendor/lib/modules/8188fu.ko # 开机自动加载的清单不同安卓版本路径不同 adb shell grep -q 8188fu /vendor/lib/modules/modules.load || \ echo 8188fu.ko /vendor/lib/modules/modules.loadrestorecon那一步不能省。/vendor/lib/modules/下的文件默认上下文是u:object_r:vendor_file:sbl手动adb push进去的文件继承的是adb进程的上下文init加载时会因为策略拒绝而静默失败。modules.load只对 first stage 加载有效Android 11 之后 vendor 模块清单可能被编进vendor_boot镜像改文件不生效这种机器上手动insmod验证最省事验证通过再考虑改镜像。签名问题在测试阶段可以先绕过内核里关掉CONFIG_MODULE_SIG_FORCE重编 boot或者把公钥编进内核的 keyring。量产机上这两条路都走不通只能拿到厂商签名通道这一点得提前评估别等到产线才发现。4.4 adb 侧验证从 insmod 到拿到 IP安卓上没有dhclient网络配置走的是dhcpcd或者ndcwpa_supplicant的参数也和桌面不太一样。adb shell insmod /vendor/lib/modules/8188fu.ko adb shell dmesg | tail -50 adb shell ip link adb shell wpa_supplicant -i wlan0 -c /data/local/tmp/wpa.conf -B -Dnl80211 adb shell dhcpcd wlan0 || adb shell ndc network interface add wlan0 adb shell ifconfig wlan0 adb shell ping -c 5 192.168.1.1-Dnl80211优先如果wpa_supplicant报Failed to initialize driver interface换成-Dwext再试这一步能快速区分是 cfg80211 注册失败还是驱动本身没起来。dhcpcd在部分精简系统里被裁掉了ndc是备选命令语法随安卓版本变化跑之前先ndc help看一眼。dmesg里的关键行和桌面上一致唯一要注意的是安卓的dmesg权限非 root 看不到内核日志adb root是前提。整个链路打通之后把/data/local/tmp/wpa.conf里的密码删掉别留在测试机上。5. 避坑与排查五类让驱动编不过、跑不稳的现场5.1 编译期一片 implicit declaration内核 API 断裂现象make跑到一半开始刷屏strlcpy未声明、struct cfg80211_ops has no member named mgmt_frame_register、kernel_write参数个数不对、set_fs找不到。原因这份驱动的代码基线大概停在 4.x 到 5.4 之间而 5.15、6.1、6.6 这几个 LTS 把一批老 API 删了或者改了签名。strlcpy在 5.15 之后被strscpy取代set_fs/get_fs在 5.10 移除cfg80211_ops里好几个回调合并进了struct cfg80211_ops的新字段usb_control_msg在 5.16 之后多了个timeout参数位置变化。解决不推荐逐个文件手改容易越改越乱。在include/osdep_service_linux.h顶部加一层版本垫片把差异收敛到一个地方/* 兼容垫片按内核版本选择实现改一处比改十处稳 */ #include linux/version.h #include linux/string.h #if (LINUX_VERSION_CODE KERNEL_VERSION(5, 15, 0)) #define rtw_strlcpy(dst, src, len) strscpy(dst, src, len) #else #define rtw_strlcpy(dst, src, len) strlcpy(dst, src, len) #endif /* 6.1 之后 usb_control_msg 的超时参数位置有变封装一层 */ static inline int rtw_usb_ctrl_msg(struct usb_device *dev, unsigned int pipe, u8 req, u8 type, u16 val, u16 idx, void *buf, size_t len, int timeout) { #if (LINUX_VERSION_CODE KERNEL_VERSION(5, 16, 0)) return usb_control_msg(dev, pipe, req, type, val, idx, buf, len, timeout); #else return usb_control_msg(dev, pipe, req, type, val, idx, buf, len, timeout); #endif }然后在报错的调用点把strlcpy换成rtw_strlcpy把老的cfg80211_ops回调字段注释掉、改用cfg80211_ops里对应的新字段。改完一定要make clean再编这套驱动的依赖文件写得松增量编译会骗你。剩下一两个实在对不上的用EXTRA_CFLAGS -Wno-errorimplicit-function-declaration先放过去但要记在清单上别当没看见。5.2 模块加载成功但没有 wlan 接口VID/PID 没匹配上现象lsmod能看到8188fudmesg里也有 USB 设备枚举的记录但ip link里没有任何新增接口dmesg里找不到 probe 成功的行。原因os_dep/linux/usb_intf.c里的rtw_usb_id_tbl是白名单匹配不在表里的设备驱动根本不会去 probe。市面上同一颗芯片的成品网卡换过好几轮 PID源码包里的表不一定覆盖你手上这一批。解决先在宿主机上看清楚设备的 VID/PID 和接口类lsusb # 典型输出Bus 001 Device 004: ID 0bda:f179 Realtek ... lsusb -v -d 0bda:f179 | grep -E bInterfaceClass|bInterfaceSubClass|bDeviceClass拿到 ID 之后补进表里注意匹配宏要用USB_DEVICE_AND_INTERFACE_INFO而不是简单的USB_DEVICE因为这颗芯片的接口类通常是0xff厂商自定义用USB_DEVICE匹配 class 为 0 的通用设备会漏掉static struct usb_device_id rtw_usb_id_tbl[] { {USB_DEVICE_AND_INTERFACE_INFO(0x0bda, 0xf179, 0xff, 0xff, 0xff)}, {USB_DEVICE_AND_INTERFACE_INFO(0x0bda, 0xc820, 0xff, 0xff, 0xff)}, {USB_DEVICE_AND_INTERFACE_INFO(0x0bda, 0xa729, 0xff, 0xff, 0xff)}, {} /* 必须有这个空项收尾否则内核会越界读表 */ };补完重编重载dmesg里应该能看到rtw_usb_probe相关的行。如果bInterfaceClass是0xe0无线控制器而不是0xff匹配宏第三个参数要相应改成0xe0这一点lsusb -v一查便知。5.3 能连上但传大流量就断USB 自动挂起和低功耗模式现象ping通小文件下载正常iperf3跑二三十秒链路直接掉dmesg里偶尔有usb 1-1: reset high-speed USB device重连后一切正常过一会儿再断。原因两个叠加因素。一是内核的 USB 自动挂起空闲时把设备送进 suspend这颗芯片的唤醒时序做得不严醒来后状态机没恢复干净。二是驱动自己的CONFIG_POWER_SAVING射频间歇休眠和 USB autosuspend 撞在一起重传率飙升直到链路被判死。解决分三层关掉。# 第一层内核启动参数全局关掉 USB 自动挂起 sudo sed -i s/GRUB_CMDLINE_LINUX_DEFAULT/GRUB_CMDLINE_LINUX_DEFAULTusbcore.autosuspend-1 / /etc/default/grub sudo update-grub # 第二层驱动编译期关掉省电 sed -i s/^#define CONFIG_POWER_SAVING/#undef CONFIG_POWER_SAVING/ include/autoconf.h make clean make -j$(nproc) # 第三层运行时再确认一遍 sudo iw dev wlan0 set power_save off cat /sys/module/usbcore/parameters/autosuspend三层都做基本能根治。只做第三层的话重启或者重新插拔就失效了。如果关掉之后还断检查供电USB 2.0 口带这颗芯片加外置天线峰值电流能到 400mA 以上前面接个不带电源的 HUB 很容易掉压换个主板直出的口试试。5.4 接口起来了但扫不到任何 AP固件没加载现象ip link能看到wlan0iw dev wlan0 scan返回空列表或者Operation not permitteddmesg里有一行request_firmware failed或者rtl8188fu: download firmware failed。原因固件文件名或路径不对。驱动里request_firmware用的名字是写死的不同版本的源码包可能写成rtl8188fufw.bin也可能带子目录rtlwifi/rtl8188fufw.bin路径对不上就加载失败。固件加载失败时驱动往往还是会注册接口只是射频起不来表现就是能看见设备但扫不到东西。解决先确认驱动里用的确切名字strings 8188fu.ko | grep -i \.bin # 输出通常是 rtl8188fufw.bin看有没有前缀目录然后按名字放到对应位置两个常见路径都放一份不占多少空间sudo cp firmware/rtl8188fufw.bin /lib/firmware/ sudo cp firmware/rtl8188fufw.bin /lib/firmware/rtlwifi/ sudo rmmod 8188fu sudo insmod ./8188fu.ko dmesg | grep -i firmware安卓上对应路径是/vendor/firmware/权限 644SELinux 上下文u:object_r:vendor_firmware_file:sbl同样要restorecon。固件版本和驱动版本最好配对混用不同批次的 bin 会出现能连但速率只有 1Mbps 的怪现象。5.5 能连但速度只有几 Mbps信道、带宽和天线现象iw dev wlan0 link显示bitrate只有 6.5Mbps 或者 1Mbpsiperf3跑出来个位数重传计数一直涨。原因三个常见源头。2.4G 频段本来就挤周围十几个 AP 叠在同一信道驱动默认开了 40MHz 共存检测检测到邻居就退回 20MHz 甚至更低USB 小网卡自带的天线增益极低插在金属机箱背面基本等于屏蔽。解决固定信道避开拥堵关掉 40MHz 共存改善物理位置。# 看周围信道占用挑一个干扰最少的 sudo iw dev wlan0 scan | grep -E DS Parameter set|signal | head -40 # 路由器侧固定 1/6/11 之一带宽强制 20MHz # 驱动侧关掉 40MHz 相关开关减少协商抖动 sudo iw dev wlan0 set bitrates legacy-2.4 1 2 5.5 11 6 9 12 18 24 36 48 54信道选 1、6、11 这三个互不重叠的别选中间那些看着空闲实际上被邻道挤爆的。天线方面把网卡从机箱背面挪到前面板或者用一根短的 USB 延长线架高实测信号能差 10dBm 以上。这几条看着像玄学但 2.4G 这个频段的物理特性就是这样改完再测一遍iperf3前后对比一目了然。6. 用 DKMS 把编译固化内核一升级不用重新翻笔记前面所有步骤都是手工的手工的东西注定会忘。系统内核一升级/lib/modules/$(uname -r)/build指向新版本之前编的8188fu.kovermagic 对不上开机insmod失败网卡消失然后你又要从头来一遍。DKMS 解决的正是这个问题把源码登记进去每次内核更新自动重编重装。先在源码目录里放一个dkms.conf关键是MAKE[0]那行要显式传KSRC不然 DKMS 默认拿/lib/modules/${kernelver}/build某些发行版上这个路径和实际头文件树不一致PACKAGE_NAMErtl8188fu PACKAGE_VERSION1.0.0 BUILT_MODULE_NAME[0]8188fu BUILT_MODULE_LOCATION[0]. DEST_MODULE_LOCATION[0]/kernel/drivers/net/wireless MAKE[0]make -j$(nproc) KSRC/lib/modules/${kernelver}/build CLEANmake clean AUTOINSTALLyesBUILT_MODULE_LOCATION指的是make之后.ko落在源码树的哪个子目录这份驱动编完就在根目录所以写.。DEST_MODULE_LOCATION是安装到/lib/modules/${kernelver}/下的相对路径写updates也行写kernel/drivers/net/wireless更符合传统布局。登记和安装的命令不多顺序别搞反sudo mkdir -p /usr/src/rtl8188fu-1.0.0 sudo cp -r ./rtl8188fu-driver/* /usr/src/rtl8188fu-1.0.0/ sudo cp dkms.conf /usr/src/rtl8188fu-1.0.0/ sudo dkms add -m rtl8188fu -v 1.0.0 sudo dkms build -m rtl8188fu -v 1.0.0 sudo dkms install -m rtl8188fu -v 1.0.0 dkms statusdkms status输出rtl8188fu/1.0.0, kernel, x86_64: installed才算成功。之后apt upgrade拉了新内核DKMS 会在安装阶段自动编一遍编失败的话会在dpkg日志里留记录/var/lib/dkms/rtl8188fu/1.0.0/build/make.log是排查入口。安卓侧没法用 DKMS但有替代习惯把KSRC、CROSS_COMPILE、内核版本号写进一个build.env跟源码一起提交换机器的时候source build.env make就行。我还会在仓库根目录放一个自检脚本新机器上跑一遍就知道环境齐不齐#!/usr/bin/env bash # check-env.sh三板斧自检缺哪条补哪条 set -u KV$(uname -r) echo [1] 内核头文件树 test -f /lib/modules/${KV}/build/.config echo OK || echo MISSING .config test -f /lib/modules/${KV}/build/Module.symvers echo OK || echo MISSING Module.symvers echo [2] 固件 ls /lib/firmware/rtl8188fufw.bin 2/dev/null echo OK || echo MISSING firmware echo [3] 设备枚举 lsusb | grep -iE 0bda:(f179|c820|a729) || echo NO DEVICE最后说个血泪教训。我之前在一台工控机上图快手工编完insmod就交付了没登记 DKMS。三个月后系统自动更新内核现场断网运维打电话过来我只能远程让人家把旧内核从 GRUB 里选回来。从那以后我每次给这类外挂驱动做交付第一件事就是把 DKMS 配好、把check-env.sh留一份在/root/然后才去测吞吐。希望帮到你。本文还有配套的精品资源点击获取