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成功与否看三层，缺任何一层都不算装好：
dmesg | tail里固件加载完成，没有红色报错；lsmod | grep 7601能看到三个模块；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就是这个模板，照抄即可。
最后两条具体建议：
- 升级系统或切换内核之前，先跑一遍
./info.sh记下模块的 vermagic，下次出问题能立刻判断是不是内核换过了。 - 如果系统自带了同芯片的内核模块，加载这个驱动前先
rmmod掉旧的，两个驱动会抢同一个 USB 设备，表现就是 ra0 反复出现又消失。
【免费下载链接】mt7601u项目地址: https://gitcode.com/gh_mirrors/mt7/mt7601u
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
