RTL8125 2.5G 网卡在 Linux 上跑不满速？7 个高频问答，驱动安装一次到位

RTL8125 2.5G 网卡在 Linux 上跑不满速7 个高频问答驱动安装一次到位【免费下载链接】realtek-r8125-dkmsA DKMS package for easy use of Realtek r8125 driver, which supports 2.5 GbE.项目地址: https://gitcode.com/gh_mirrors/re/realtek-r8125-dkms给新主机插上那块 RTL8125 2.5G 网卡满心期待跑出 2.5Gbps结果ip link里连接口的影子都没有或者好不容易亮了灯协商速率却死死钉在 1000Mb/s——先别急着怀疑硬件。这张卡的问题十有八九出在驱动上Linux 内核自带的 r8169 通用驱动并不擅长驾驭它。本文要聊的 realtek-r8125-dkms 项目正是官方 r8125 驱动的一键 DKMS 封装能让 RTL8125/RTL8126 在 Linux 下真正跑满 2.5G。下面我用 7 个高频问题把从识别、安装到实测的完整路径走一遍。 问题一网卡明明插着为什么接口不出现或只有千兆先做两件事确认型号、确认当前驱动。lspci | grep -i ethernet lspci -k | grep -A2 -i ethernet你应看到第一行出现Realtek ... RTL8125或RTL8126第二行会列出这张卡当前绑定哪个驱动——如果写的是r8169问题基本就坐实了。这里有个前提要先划清本项目只针对 PCI 接口的 RTL8125/RTL8126。如果你手上是 RTL8156 这类 USB 网卡走的是另一套 r8152 驱动本文方法不适用别装错。⚔️ 问题二内核自带的 r8169 和官方 r8125差在哪r8169是内核里的万金油驱动兼容一大票 Realtek 芯片RTL8125 也在名单里——能认但只是能用特性不全、对新芯片的适配总是慢半拍于是出现千兆协商、甚至干脆不出接口的怪象。r8125则是瑞昱官方驱动项目把它封装成 DKMS 包版本 9.018.00模块名就是r8125。两个驱动宣称支持同一批设备 ID内核只会加载其中一个而默认情况下先手总是内核自带的r8169——这就是装完没生效这一千古谜题的根源后面问题五会正面拆解。 问题三DKMS 是什么为什么说它能一劳永逸DKMSDynamic Kernel Module Support动态内核模块支持可以理解为驱动登记处把源码登记进系统每次内核升级后自动用新内核重新编译一份驱动永远跟着系统走这正是它比手动编译省心的核心。用之前先补三件套Debian/Ubuntu 系sudo apt install dkms build-essential sudo apt install linux-headers-$(uname -r)正常现象是uname -r输出的版本号与ls /usr/lib/modules/$(uname -r)/build能正常列出内容说明头文件就位。顺带预告一个高频翻车点dkms build报No rule to make target之类错误九成是头文件没装全或版本不匹配回这里补装即可。 问题四项目拿到手装进 DKMS 具体怎么做拉取源码git clone https://gitcode.com/gh_mirrors/re/realtek-r8125-dkms cd realtek-r8125-dkms项目里的dkms-install.sh就是干这事的跑它sudo ./dkms-install.sh这个脚本实际做了三步把当前目录复制到/usr/src/r8125-9.018.00然后依次执行dkms add、dkms build、dkms install。编译期间会滚大量日志属正常现象耐心等它走完。你应看到脚本最后输出Finished running dkms install steps.且无Error再用dkms status能看到r8125/9.018.00 ... installed。顺带一提项目里还有个dkms-remove.sh卸载时跑它就能把登记和源码目录一起清干净不用手抖删文件。 问题五装完明明显示 installed重启后却原形毕露这是 90% 的人卡住的地方lsmod | grep r8125没有输出因为r8169又抢先把设备占了。解决办法是给r8169下禁入令sudo tee /etc/modprobe.d/blacklist-r8169.conf /dev/null EOT # 屏蔽 r8169强制使用 r8125 专用驱动 blacklist r8169 EOT sudo update-initramfs -u sudo reboot你应看到update-initramfs -u输出Generating /boot/initrd.img-版本号且无报错重启后lsmod | grep -E r8125|r8169只剩r8125。如果modprobe r8125报Operation not permitted多半是 Secure Boot 在拦进 BIOS 关掉它或给模块做签名二选一。 问题六怎么科学确认 2.5G 是真的跑满了依次过这三关lsmod | grep -E r8125|r8169 # 驱动状态 ip link show # 接口是否出现通常是 enpXxx ethtool 接口名 | grep Speed # 协商速率你应看到接口出现ethtool回显2500Mb/s。若仍显示1000Mb/s先别怪驱动——查网线建议 Cat5e 以上和对端设备是不是真 2.5G 口协商失败也会掉速。速率只能说明握手成功真实带宽还得实测。起服务端、跑客户端各一条命令iperf3 -s iperf3 -c 服务器IP -t 30 -P 4你应看到吞吐稳定在 2.3Gbps 以上而不是千兆环境那个熟悉的 940Mbps 天花板。 问题七内核升级后驱动会失效吗还有别的装法吗这正是 DKMS 的舒适区dkms.conf里写了AUTOINSTALLyes内核一升级驱动自动重编译你基本可以当它不存在。至于项目里的autorun.sh那是另一条路它只作用于当前内核会卸载旧驱动、编译、把r8169.ko改名备份成r8169.bak再加载r8125。优点是救急最快缺点是内核一升级就失效得重跑它的日志会追加进log.txt报错时tail -50 log.txt看最后几行最有效。想在管理上更进一步两个进阶方向任选装成 .deb 包装好devscripts debmake debhelper dkms dh-dkms后执行dpkg-buildpackage -b -rfakeroot -us -uc产物用sudo dpkg -i realtek-r8125-dkms*.deb安装之后像普通软件一样可升级、可卸载性能微调sudo sysctl -w net.core.rmem_max26214400加大接收缓冲再配ethtool -C 接口名 rx-usecs 30 tx-usecs 30开中断合并高负载下 CPU 占用更友好。 写在最后一句踩坑经验 下一步去哪如果只让我留一条经验就是问题五那步别省装上驱动只是开始不把r8169请出局一切等于白干。我第一次装这块卡时就是栽在明明 installed 却没生效上来回折腾了快两小时才想到是驱动抢占你读完这篇应该能十分钟走完全程。想继续深挖的话项目里的REALTEK_README.txt是官方驱动的原始说明src/下是完整驱动源码r8125_n.c、r8125_ptp.c这些dkms.conf里还能看到并行编译的细节。从git clone https://gitcode.com/gh_mirrors/re/realtek-r8125-dkms开始让这张 2.5G 网卡跑出它该有的速度吧。【免费下载链接】realtek-r8125-dkmsA DKMS package for easy use of Realtek r8125 driver, which supports 2.5 GbE.项目地址: https://gitcode.com/gh_mirrors/re/realtek-r8125-dkms创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考