新买的 RTL8125 网卡只跑 1Gbps多半是驱动被 r8169 抢了先【免费下载链接】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 网卡插进主机开机后ip link里确实看到了新接口速率却停在 1Gbps——花两百多买的 2.5G 卡跑得跟板载千兆一样。问题不在硬件而在驱动内核自带的 r8169 通用驱动抢先加载把 RTL8125 的专用驱动 r8125 挤在门外。realtek-r8125-dkms 这个项目把瑞昱官方驱动打包成 DKMS 模块装上后内核升级也不用再管。先跑起来再说一条命令应急别急着搞懂所有原理。你现在就要用网项目里带着瑞昱官方的autorun.sh脚本克隆下来直接跑git clone https://gitcode.com/gh_mirrors/re/realtek-r8125-dkms cd realtek-r8125-dkms sudo ./autorun.sh脚本会依次做四件事卸载 r8169/r8125 旧模块、用make编译、备份并替换内核目录里的 r8169.ko、最后depmod加modprobe加载。等到屏幕上出现Completed.跑一句lsmod | grep r8125看到输出就说明驱动已经生效。但先别高兴太早autorun.sh 只管当前内核下次内核一升级它就被冲掉得重新跑一遍。想一劳永逸接着看下面的方案。为什么内核认不出这张卡一张网卡要干活得先有驱动。Linux 内核自带了一批万金油驱动r8169 就是负责照顾各种 Realtek 网卡的通用选手。问题在于万金油虽然认识 RTL8125却只肯发挥它千兆的本事2.5G 的速度被白白锁死有些主板上它干脆不加载接口直接消失。瑞昱官方自己发布了专用驱动 r8125本项目用的是 9.018.00 版能把 2.5G 完整跑起来但它不在内核里得自己装。装还不是最麻烦的——麻烦在于就算装好了r8169 加载优先级更高专用驱动照样被挤掉。所以除了装驱动还必须把 r8169拉黑。至于 DKMS你可以把它理解成一位驱动管家把源码登记进去每次内核升级后自动用新内核重新编译一遍驱动永远跟得上系统。这就是它比 autorun.sh 省心的原因。七步装到位内核升级不再操心全程约 5 分钟跟着走每步都有预期结果。第一步确认网卡型号lspci | grep -i ethernet回显里有Realtek ... RTL8125或RTL8126字样才能继续。如果显示的是 RTL8156那是 USB 网卡本项目不适用。命令没输出先确认卡插稳了、主板 PCIe 槽供电正常。第二步装齐编译环境sudo apt update sudo apt install dkms build-essential linux-headers-$(uname -r)预期三条软件包全部安装成功没有红字报错。linux-headers-$(uname -r)会跟随当前内核版本自动匹配这条最容易漏。第三步确认头文件就位ls /usr/lib/modules/$(uname -r)/build预期命令不报No such file。如果报错说明头文件没装全回到第二步重装一次再继续。第四步运行 DKMS 安装脚本sudo ./dkms-install.sh脚本做三件事把项目复制到/usr/src/r8125-9.018.00执行dkms add→dkms build→dkms install最后输出Finished running dkms install steps.。编译期间会滚动大量日志属正常现象等它跑完即可。第五步核对登记状态dkms status预期看到r8125/9.018.00, ... installed。如果显示的是built而不是installed多半是头文件问题重走第二步后重新执行脚本。第六步屏蔽 r8169这一步最容易被忽略sudo tee -a /etc/modprobe.d/blacklist-r8169.conf /dev/null EOT # To use r8125 driver explicitly blacklist r8169 EOT sudo update-initramfs -u预期update-initramfs输出Generating /boot/initrd.img-xxx无报错。黑名单让内核启动时不加载 r8169专用驱动才有机会上场。第七步重启并确认加载结果sudo reboot重启后打开终端lsmod | grep -E r8125|r8169预期只出现 r8125 相关行r8169 消失。再用ip link show找到新接口通常是 enp 开头驱动安装宣告成功。最容易翻车的三个坑坑一装完驱动不拉黑 r8169。反面场景重启后lsmod里还是只有 r8169r8125 始终不出现。正确做法必须写黑名单文件并update-initramfs -u再重启。黑名单配置是持久的装一次即可不是每次重启都要重写。坑二编译报No rule to make target。反面场景dkms build中途失败日志指向找不到内核构建目录。正确做法确认linux-headers-$(uname -r)已装且版本与uname -r完全一致重装后重跑安装脚本。坑三modprobe r8125报Operation not permitted。反面场景模块编译成功但加载被拒。原因通常是 Secure Boot 拦截了未签名模块。正确做法进 BIOS 关闭 Secure Boot 后重来。怎么确认 2.5G 真的到手了三个指标逐个验证ethtool enp3s0 | grep Speed把接口名换成你自己的。达标线输出Speed: 2500Mb/s而不是1000Mb/s。再上 iperf3 实测带宽。服务端机器跑iperf3 -s客户端跑iperf3 -c 服务器IP -t 30 -P 4达标线带宽接近 2.3Gbps 以上。如果只有 940Mbps 左右先检查对端交换机、网线是不是也支持 2.5G——网线至少 Cat5e对端端口也要是 2.5G这是新手最容易忽略的锅。新手常问的三件事问装好之后r8169 的事还用管吗不用。黑名单文件是持久的只要不删它每次启动都生效。问以后想卸载怎么办项目里带了dkms-remove.sh执行sudo ./dkms-remove.sh即可它会移除 DKMS 登记并清理/usr/src/r8125-9.018.00卸载干净不留尾巴。问Ubuntu 用户想用 apt 管理驱动可以吗可以README 里提供了 Launchpad PPA 方式sudo add-apt-repository ppa:awesometic/ppa后sudo apt install realtek-r8125-dkms驱动就能像普通软件一样升级。具体以项目根目录的 README.md 为准。写在最后驱动认对了人2.5G 才算是真的到手。官方驱动说明见项目根目录的 REALTEK_README.txt安装与验证细节见 README.md。按上面七步走完那块网卡就再也不会让你对着 1Gbps 发呆了。【免费下载链接】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），仅供参考
