mt7601u 驱动完整教程：如何点亮 MT7601U 无线网卡，在 Linux 下装好连上网络

mt7601u 驱动完整教程：如何点亮 MT7601U 无线网卡，在 Linux 下装好连上网络

【免费下载链接】mt7601u项目地址: https://gitcode.com/gh_mirrors/mt7/mt7601u

mt7601u 驱动是面向 MediaTek（Ralink）MT7601U 这款 USB 2.4G 单频无线网卡的 Linux 外置内核驱动，支持 STA 客户端模式（连路由器）和 AP 热点模式（自己当热点）。它没有进内核主线，需要你自己对着当前内核编译，但只要路子对，装好连上网络全程不超过十分钟。

动手前先确认：网卡是不是 7601

先插上网卡，跑一条命令自查：

lsusb | grep 7601

输出里有:7601结尾的设备 ID，说明这块卡就是 MT7601U，下面的流程直接适用；如果是 8811、8723D 之类的 ID，先停下，那是别的芯片，别在这个驱动上浪费时间。

另一个前提是内核头文件必须齐全。编译系统直接指向/lib/modules/$(uname -r)/build取头文件，目录不存在会直接失败。Ubuntu/Debian 上装好linux-headers-$(uname -r)包即可。

提前打个预防针：这套代码源自 Ralink 老驱动体系，3.x~4.x 内核下最稳。5.x 及以上内核编译出一堆报错时，别急着改代码，先考虑换个旧内核再来。

5 分钟闭环：拉源码、编译、安装

拉取源码：

git clone https://gitcode.com/gh_mirrors/mt7/mt7601u cd mt7601u

编译前把当前内核的符号表拷进源码目录（项目自带的build.sh会帮你做这件事）：

cp /lib/modules/$(uname -r)/build/Module.symvers src/os/linux

直接跑脚本完成清理加编译：

./build.sh

想把模块装进系统目录再补一条：

make install

注意一个坑：src/Makefile第一行默认WIFI_MODE = AP，也就是默认编出的是热点模式。你要连路由器的话，先把它改成WIFI_MODE = STA再编译，产出的模块名后缀（sta / ap）不同，后面加载命令要跟着变。

如何判断 mt7601u 驱动加载成功

驱动由三个模块组成，加载顺序固定（项目根目录的load.sh就是这个流程）：

insmod src/os/linux/mtutil7601Usta.ko insmod src/os/linux/mt7601Usta.ko insmod src/os/linux/mtnet7601Usta.ko

成功与否看三层，缺任何一层都不算装好：

1. dmesg | tail里固件加载完成，没有红色报错；
2. lsmod | grep 7601能看到三个模块；
3. iwconfig出现ra0接口。

前两条过、第三条没出现，多半是模块和内核的 vermagic 对不上。用modinfo src/os/linux/mt7601Usta.ko | grep vermagic的结果和uname -r比对，不一致说明编译时用了别的内核，在当前内核下重编一次即可。

编译常见卡点及处理办法

• 报错指向/lib/modules/.../build目录不存在：内核头文件没装，装对应版本 headers 包。
• 提示 vermagic 或le_layout不匹配：模块与运行内核不是同一套编译产物，跑一下项目自带的info.sh即可快速核对三个模块的状态。
• 新内核下大片 undeclared 函数报错：老驱动适配新内核的典型症状，最省事的办法是降级内核，而不是逐条修编译错误。

回滚：把驱动干净地摘掉

不再需要或想恢复原状时反着做。先按加载的逆序卸载（unload.sh同款）：

rmmod mtnet7601Usta rmmod mt7601Usta rmmod mtutil7601Usta

再移除已安装的模块：

make uninstall

这两步比手动满系统找 .ko 文件干净得多，之后make clean可清掉编译产物。

装好之后值得试的搭配

• STA 模式下配wpa_supplicant -Dralink可以连加密网络，驱动默认编译时就带了对应支持；
• 源码doc/目录里的iwpriv_usage.txt列了全部 iwpriv 高级命令，调参数时直接查；
• AP 模式配一个小脚本就能出热点：给 ra0 设 IP、起 dhcpd、iptables 做 NAT 转发，miwifi_work.sh就是这个模板，照抄即可。

最后两条具体建议：

1. 升级系统或切换内核之前，先跑一遍./info.sh记下模块的 vermagic，下次出问题能立刻判断是不是内核换过了。
2. 如果系统自带了同芯片的内核模块，加载这个驱动前先rmmod掉旧的，两个驱动会抢同一个 USB 设备，表现就是 ra0 反复出现又消失。

【免费下载链接】mt7601u项目地址: https://gitcode.com/gh_mirrors/mt7/mt7601u