简介一份ASIX AX88179 USB 3.0网卡驱动资源包面向需要在Linux、Windows及macOS下安装或调试该网卡的用户。该芯片属于高性能USB 3.0转千兆以太网控制器支持2.6.xx与3.0.xx两个Linux内核系列资源内提供C语言源码与Makefile也包含各系统的图形化安装组件开发者与普通用户都能按需选用。压缩包为7z格式整体约10.98MB共333个文件其中txt、pdf与readme为使用说明文档dll、exe、sys、inf、cat构成Windows驱动与安装环境reg为注册表配置dmg为macOS安装镜像log与dat保留了安装日志和测试信息。该驱动资源已有4605人学习/下载特别适合经常跨平台切换、依赖USB转千兆网卡的高速网络用户也适合系统管理员和网络维护者。除安装驱动外这些文件还便于排查驱动签名、注册表写入和安装失败问题Linux源码与构建文件允许针对特定内核重新编译整体体积不足11MB却覆盖多系统场景可减少逐一寻找适配版本的麻烦。1. AX88179 在 Linux 下到底要不要装驱动做过嵌入式或者常折腾装机的人对 AX88179 应该不陌生这颗 ASIX 的 USB 3.0 转千兆网卡芯片几乎霸占了大半张 USB 网卡的市场十几块钱的“USB 千兆网卡”里十有八九是它或者它的兄弟 AX88179A。Linux 下装 AX88179 驱动这件事看起来是个“插上就能用”的小事但真踩过坑的人都知道内核主线虽然从 3.x 开始就集成了 ax88179_178a 驱动可一旦碰到老内核、Secure Boot、树外驱动冲突、2.5G 速率协商这些场景网卡认不出来、插上没反应、速率死活上不去的问题一个接一个。本文按我实际装过的一套流程来写从确认芯片版本、选方案、编译安装到验证跑满千兆全路径覆盖适合正在 Linux 下配这块网卡的人直接抄作业。2. 装前确认硬件版本、内核支持与驱动方案选型2.1 先分清 AX88179 和 AX88179A别把芯片认错这是最容易翻车的第一步。AX88179 和 AX88179A 是两颗不同的芯片前者是 USB 3.0 转千兆1000M后者在部分型号上支持 2.5G 速率但两者在 Linux 下的驱动处理逻辑不一样。很多人的网卡插上后 dmesg 里显示的是AX88179A然后拿 AX88179 的驱动去加载虽然也能跑但 2.5G 协商不出来速率卡在 1000M这时候第一个怀疑对象就应该是芯片型号。怎么确认先看芯片丝印拆开网卡外壳看主控芯片上的字AX88179和AX88179A一字之差。不方便拆就看 USB 描述符lsusb输出里会有一行0b95:1790这是 ASIX 的 vendor ID 和 device ID。注意0b95:1790这个 ID 是 AX88179 和 AX88179A 共用的光靠 lsusb 分不清具体是哪颗但能确认它确实是 ASIX 的芯片而不是其它方案。真要区分世代最靠谱的办法是看芯片丝印或者查产品页面上的标注。这一步的意义在于如果你拿到的是 AX88179A并且你的使用场景需要 2.5G 速率那就要特别留意内核版本和驱动版本主线内核较老的版本对 AX88179A 的 2.5G 模式支持不完整可能需要在加载模块时加参数或者干脆用树外官方驱动。2.2 内核自带 ax88179_178a 还是官方树外驱动二选一Linux 主线内核从 3.x 开始就把 ax88179_178a 驱动合并进去了模块名是ax88179_178a位置在kernel/drivers/net/usb/ax88179_178a.ko。对绝大多数现代发行版来说插上就能识别不需要额外装任何东西。那这篇安装文为什么还要写因为“免驱”有三个前提内核版本足够新、内核开启了 USB 网卡支持、没有 Secure Boot 拦着模块加载。这三个条件只要有一个不满足就得回到“手动装”这条路。另外还有个更隐蔽的场景某些发行版的内核配置里把CONFIG_USB_NET_AX8817X编成了模块而不是编进内核如果你用的是精简内核比如自编译的、或者容器宿主机这个模块可能根本没被装进去。方案选型我一般这样定场景推荐方案发行版内核 ≥ 5.4Secure Boot 关闭直接用主线自带的 ax88179_178a零配置发行版内核 ≥ 5.4Secure Boot 开启主线驱动 给模块签名或关掉 Secure Boot老内核、自编译内核、嵌入式交叉编译用 ASIX 官方树外驱动源码自行编译需要 AX88179A 的 2.5G 速率而主线驱动协商不出用官方树外驱动加载时看是否带速率参数主线驱动和官方驱动模块名都叫ax88179_178a这是最大的冲突来源。你不能两个都装编译官方驱动时会直接覆盖/lib/modules/$(uname -r)/kernel/drivers/net/usb/ax88179_178a.ko如果不重新跑 depmod系统还是会去加载旧的模块白折腾。3. 编译安装官方驱动从源码到 DKMS 一次跑通3.1 准备编译环境linux-headers、gcc、make 一个都不能少选定了官方树外驱动第一件事不是下载源码而是确认编译环境齐不齐。编译内核模块需要当前内核版本的 headers不是装个 build-essential 就完了。headers 版本必须和uname -r完全一致差一个小版本号都编不过。Debian/Ubuntu 系sudo apt update sudo apt install -y linux-headers-$(uname -r) build-essential dkmsRHEL/CentOS/Fedora 系sudo dnf install -y kernel-devel-$(uname -r) gcc make dkms注意第一行命令里的$(uname -r)是命令替换先执行 uname -r 拿到当前内核版本号再拼路径。如果提示找不到linux-headers-5.4.0-xxx-generic这个包先apt update再试多半是软件源索引没刷新。headers 装完验证一下/lib/modules/$(uname -r)/build这个软链是否存在ls -l /lib/modules/$(uname -r)/build这个软链指向/usr/src/linux-headers-xxx如果软链断了或者指向不存在编译时第一个报错就是找不到generated/autoconf.h非常典型。软链有问题就用sudo apt install --reinstall linux-headers-$(uname -r)重装一次大多数情况能修好。DKMS 不是编译必需的东西但它能解决内核升级后驱动失配的问题——模块是跟着内核版本编译的内核一升级旧模块就不能加载了得重新编。DKMS 会在每次内核变更后自动触发重编这是后面要用的先一起装好。3.2 源码编译与安装modprobe 之前先看 dmesg官方驱动源码是一个 tar.bz2 包解压后目录名一般是ax88179_178a_linux_vXXXX_source。这里注意一点官方包的 Makefile 默认走的是条件编译会根据你当前内核的配置决定编出什么不需要手动改头文件但这不代表参数完全不用管。tar xjf ax88179_178a_linux_v1.19.0_source.tar.bz2 cd ax88179_178a_linux_v1.19.0_source make sudo make installmake执行时会在当前目录下生成ax88179_178a.ko如果报错最常见的就是 3.1 里 headers 没配对。sudo make install会把模块拷贝到/lib/modules/$(uname -r)/kernel/drivers/net/usb/覆盖掉主线自带的同名文件然后自动执行 depmod 刷新模块依赖。这里有一个很多教程没提的坑覆盖安装之前先把旧模块卸载掉否则正在被使用的模块文件被替换后网卡还挂着旧驱动的状态新模块虽然装上了但不会自动生效。卸载和加载按这个顺序来sudo modprobe -r ax88179_178a sudo modprobe ax88179_178a第一次加载前先看一眼 dmesg确认 USB 设备已经被系统识别dmesg | tail -20正常情况下能看到usb 3-1: New USB device found以及asix相关的绑定信息。如果 dmesg 里完全没有这行说明 USB 层就没识别到设备问题可能出在硬件接触、USB 口供电或者直接就是网卡本身坏了先别急着折腾驱动。加载成功后用lsmod确认模块状态lsmod | grep ax88179输出里应该有ax88179_178a并且 Used 列不为 0。然后ip link看有没有新的网卡接口一般叫eth0或者enx0b951790xxx基于 MAC 生成的名字看到就说明驱动工作正常。3.3 用 DKMS 托管驱动内核升级后不用重编直接用make install装的模块在下一次内核升级后就会失效——这是树外驱动最烦人的地方也是我后来强制改用 DKMS 的原因。DKMS 的原理是把源码注册到系统里每次内核变更后自动重新编译并安装对应版本的模块你不需要再手动进源码目录跑 make。第一步把源码放到一个固定目录然后注册sudo dkms add .这一步在源码目录下执行DKMS 会读取目录下的dkms.conf。官方源码包里是自带这个文件的如果你拿到的源码没有需要自己写一个cat dkms.conf EOF PACKAGE_NAMEax88179_178a PACKAGE_VERSION1.19.0 BUILT_MODULE_NAME[0]ax88179_178a DEST_MODULE_LOCATION[0]/kernel/drivers/net/usb/ AUTOINSTALLyes EOFPACKAGE_VERSION要和源码目录名的版本号对应BUILT_MODULE_NAME是编译产物的模块名DEST_MODULE_LOCATION表示安装到内核模块树里的哪个子目录。这个路径不要随便改/kernel/drivers/net/usb/是内核约定俗成的位置放别处 depmod 也能扫到但保持和主线驱动一致的位置最省心。注册完成后构建并安装sudo dkms build -m ax88179_178a/1.19.0 sudo dkms install -m ax88179_178a/1.19.0build是编译install是安装到当前内核。这两步成功后再modprobe ax88179_178a加载。之后每次内核升级DKMS 都会自动重编不用再管。DKMS 状态查看和卸载dkms status sudo dkms remove ax88179_178a/1.19.0 --alldkms status会列出所有已注册的模块和对应的内核版本看到状态是installed就说明托管成功。4. 避坑实录加载失败、断流、Secure Boot 签名与 2.5G 识别4.1 现象insmod 报错 module verification failed有次在 BIOS 里开了 Secure Boot 的机器上装驱动modprobe ax88179_178a直接报module verification failed: signature not found模块加载失败网卡起不来。原因Secure Boot 开启时内核只加载有有效签名的模块。官方驱动的 .ko 文件没有签名过不了验证。解决两个方向要么给模块签名要么临时关掉 Secure Boot。签名需要用到内核源码里的sign-file工具和一对密钥。如果你的机器只是个人用、没有强制安全要求直接进 BIOS 关掉 Secure Boot 最省事。必须保留 Secure Boot 的话用下面这套流程# 生成签名密钥对 openssl req -new -x509 -newkey rsa:2048 -keyout MOK.priv -outform DER -out MOK.der -nodes -days 36500 -subj /CNAX88179 Module Signer/ # 签名模块 /usr/src/linux-headers-$(uname -r)/scripts/sign-file sha256 MOK.priv MOK.der ax88179_178a.ko # 导入 MOK sudo mokutil --import MOK.dermokutil --import会提示设置一个一次性密码重启后蓝白界面会弹出 MOK management选 Enroll key 并根据提示输入之前设置的密码确认导入。签名完还要重新depmod或dkms install一次才能生效。这条路径我自己跑通过一次后面再遇到 Secure Boot 的机器就直接关 BIOS 了省时间。4.2 现象网卡能识别但协商速率只有 1000M/100MAX88179A 插在支持 2.5G 的交换机上ethtool eth0看到的速率只有 1000Mb/s怎么都协商不出 2500M。原因AX88179A 的 2.5G 模式在主线程驱动里要满足两个条件——内核版本较新一般是 6.2 之后且芯片本身被正确识别为 AX88179A。部分老内核或部分发行版的内核配置对 AX88179A 的设备 ID 判断不完整导致只用千兆模式初始化。解决先看dmesg | grep -i ax88179确认驱动识别到的名字带不带 A。如果显示ax88179_178a但没提到 AX88179A需要换用官方树外驱动并在驱动源码的ax88179.c里检查有没有定义支持 2.5G 的速率表。有些版本需要在模块加载参数里打开 2.5G 开关具体参数名以源码里的module_param声明为准常见的是tp_mode或者速率相关标志位。我一般这样处理先升级内核到发行版最新版再不行就切官方驱动两者之间优先升级内核——主线驱动的维护比树外驱动勤快得多。另外注意USB 3.0 网卡的速率对线材和接口很敏感2.5G 协商不出来先换一根短线1 米以内再试很多“驱动问题”实际上是劣质 USB 线导致的信号衰减。4.3 现象驱动加载成功但 ifconfig -a 看不到 eth 口modprobe没报错lsmod也能看到模块但ip link里找不到新的网络接口。原因多半是 udev 的网卡命名规则把它命名成了奇怪的enx...名字或者之前系统里已经有一个占着eth0的接口新接口被排到了eth1后面ifconfig不带-a参数看不见未激活的接口。解决用ip link或ifconfig -a全量列出接口找到带 MAC 地址前缀的enx...接口。确定是哪个接口后用ethtool确认它确实是 AX88179 网卡而不是别的ethtool enx0b951790 | head -10如果嫌名字难看写 udev 规则固定命名sudo nano /etc/udev/rules.d/70-ax88179.rules内容一行SUBSYSTEMnet, ACTIONadd, ATTR{address}xx:xx:xx:xx:xx:xx, NAMEeth_ax把xx:xx:xx:xx:xx:xx换成网卡实际 MAC保存后udevadm control --reload-rules并重启网络服务接口名就固定了。这段规则在所有用过这块网卡的机器上通用也是我做 USB 网卡调试时第一个落盘的文件。4.4 现象升级内核后网卡消失某次apt upgrade把内核从 5.15 升到 5.19重启后网卡没了lsmod | grep ax88179空dmesg 里也没有任何 USB 网卡绑定信息。原因直接make install装的树外驱动只绑定在 5.15 内核上新内核的/lib/modules/5.19里根本没有这个模块所以 USB 设备插了但没驱动理会。解决这就是 3.3 里 DKMS 的意义。当时没注册 DKMS只能重新走一遍编译流程。现在我的习惯是所有树外驱动一律先dkms add再dkms install不用make install裸装。如果你已经陷入“升级后网卡消失”的循环回到 3.3 把 DKMS 补齐一劳永逸。5. 装完怎么验证从 dmesg 到 iperf3 实测跑满千兆5.1 驱动加载与网卡识别三板斧装完别急着测速先把三个状态确认到位。第一板斧查模块lsmod | grep ax88179_178a状态正常时输出形如ax88179_178a 57344 0第一列是模块名第三列是引用计数。第二板斧查接口ip link show | grep -A 2 ax88179或者直接ip link找enx开头的接口。第三板斧查速率和链路状态ethtool eth0看到Speed: 1000Mb/s、Duplex: Full、Link detected: yes就是物理层正常。如果 Speed 显示Unknown!说明线缆或对端设备有问题先别怀疑驱动。5.2 用 iperf3 实测吞吐顺带检查丢包和 RX 错误计数接口起来不代表性能达标AX88179 有个典型问题是大流量下 RX 方向丢包尤其是老驱动版本。用 iperf3 打一下 TCP 双向流量最直观服务端对端机器iperf3 -s -p 5201客户端插着 AX88179 的机器iperf3 -c 192.168.1.100 -p 5201 -t 30 -i 5-t 30表示跑 30 秒-i 5每 5 秒输出一次。千兆环境下单向带宽跑到 940Mbps 左右才算合格如果只有 600M 甚至更低先看网卡统计ethtool -S eth0 | grep -E rx_errors|tx_errors|rx_droppedrx_dropped持续增长说明缓冲区不够常见做法是用 ethtool 关掉网卡的 LRO/GROsudo ethtool -K eth0 gro off gso off这条命令临时关闭聚合卸载对某些 USB 网卡能明显改善小包丢包。如果验证后发现是这种问题把关闭命令写进 systemd 服务开机自动执行或者干脆从驱动参数层面禁用不用每次开机手动敲。从那以后我每次装机验证都强制走一遍 lsmod → ethtool → iperf3 这个顺序哪怕只是换了一根 USB 线也要重来一遍跑完这几步才敢说这环境是真装好了。希望帮到你。本文还有配套的精品资源点击获取