RTL8125 2.5G网卡驱动安装不再踩坑DKMS一步到位内核升级也省心【免费下载链接】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里根本看不到接口或者明明插的是 2.5G 交换机协商速率却卡在 1000Mb/s——这不是硬件坏了而是驱动没到位。realtek-r8125-dkms 这个项目把 Realtek 官方 r8125 驱动封装成 DKMS 模块让 RTL8125 驱动安装变成一条命令的事而且内核升级后驱动会自动重编译再也不用每次升级都手工折腾。一、先搞清楚网卡跑不满到底卡在哪一环先把故事讲完整。上周有位朋友买了一块 PCIe 接口的 RTL8125 2.5G 网卡装进 Debian 主机后执行ip link show结果只有一个 lo 和一个板载千兆口新网卡连影子都没有换一台机器试接口出现了但ethtool里显示Speed: 1000Mb/s。这两个现象根因其实是同一个驱动不对路。内核里自带的r8169是一个通用驱动主要面向老款千兆芯片。它虽然能勉强驱动 RTL8125但能力有限经常只协商到 1G甚至干脆不识别。Realtek 官方另有专用驱动r8125才是为 2.5G 芯片优化过的正主。麻烦在于Linux 加载模块时r8169往往抢先一步占了网卡r8125就算装好也没机会上场。打个比方r8169像一位只懂老业务的老员工占了工位却干不了新活你要做的是把新来的专家r8125请进来并让老员工暂时休假屏蔽 r8169。而本项目 realtek-r8125-dkms就是帮你把这个过程自动化、并且内核升级后自动重来的人事管家。二、开工之前一张 10 分钟核对清单本节给你一张清单逐项打勾后再动手能避开 90% 的中途卡壳。必须项缺一不可网卡型号确认执行lspci | grep -i ethernet回显里要能看到Realtek ... RTL8125或RTL8126字样。如果看到的是RTL8156USB 网卡本项目不适用别往下走了。Debian / Ubuntu 系系统本教程基于apt生态其他发行版请对照dkms-install.sh脚本里的逻辑手动执行。dkms 工具sudo apt install dkms内核头文件sudo apt install linux-headers-$(uname -r)编译内核模块全靠它编译工具链sudo apt install build-essentialgit 客户端sudo apt install git用于克隆仓库可选项非必需ethtool查看网卡协商速率验证环节要用iperf3实测真实带宽数据比感觉更可靠一句话提醒头文件版本必须和当前内核严格一致。uname -r输出什么linux-headers-后面就接什么手滑装错版本后面dkms build必报错。三、三条路怎么选一张决策表帮你定本项目提供了三种装法它们互不干扰但绝大多数人只需要选一条。先看表再动手路线适合谁难度内核升级后长期维护成本DKMS 安装dkms-install.sh想一劳永逸的普通用户、生产环境低驱动自动重编译无需操心极低强烈推荐autorun.sh 一键脚本应急救火、当下就要有网最低失效需重新执行脚本高每次升级都要重跑手动编译src/下 make开发者、要自定义编译参数中失效需手动重编高依赖关系自己维护我的建议很直接不是十万火急就选 DKMS 这条稳路。下面第四节就是它的完整实操autorun.sh 和手动编译适合什么样的人第四节结尾会补两句让你心里有数。四、DKMS 安装实操五步走完装驱动 防冲突全程本节是全文核心。按顺序执行每步都有成功标志方便你随时自检。第 1 步把源码克隆到本地git clone https://gitcode.com/gh_mirrors/re/realtek-r8125-dkms cd realtek-r8125-dkms成功标志ls能看到autorun.sh、dkms-install.sh、dkms.conf和src/源码目录。如果克隆因网络波动失败重试几次即可。第 2 步确认内核头文件真的就绪uname -r ls /usr/lib/modules/$(uname -r)/build成功标志第一条输出一个版本号如6.8.0-45-generic第二条不报 No such file。如果报错回到清单把linux-headers-$(uname -r)装上再继续。第 3 步运行 DKMS 安装脚本核心一步sudo chmod x dkms-install.sh sudo ./dkms-install.sh脚本内部其实只干了三件事你可以对照输出确认进度把当前目录复制到/usr/src/r8125-9.018.00依次执行dkms add→dkms build后者会调用 make 编译内核模块期间会滚动大量编译日志属正常现象等待即可不要因为刷屏就以为卡死了执行dkms install把r8125.ko安装进内核模块目录。成功标志最后一行输出Finished running dkms install steps.且全程没有Error。别急装完还不算完——接下来这一步最关键。第 4 步屏蔽冲突驱动 r8169最关键的一步就像前面说的r8169会抢先加载把你的新驱动挤掉。这一步就是给它下停职令sudo tee /etc/modprobe.d/blacklist-r8169.conf /dev/null EOT # 屏蔽 r8169强制使用 r8125 专用驱动 blacklist r8169 EOT sudo update-initramfs -u成功标志update-initramfs -u刷新并显示update-initramfs: Generating /boot/initrd.img-版本号无报错。第 5 步重启让一切生效sudo reboot重启后先别急着开心走一遍第五节验证确认驱动真的在干活。应急路线补一句如果现在没网、急着救急可以不走 DKMS直接sudo ./autorun.sh。它会自动卸载旧驱动、编译、备份并替换 r8169、更新 initramfs最后输出Completed.。但记住它是一次性膏药——只对当前内核生效下次升级内核必须重跑。手动编译cd src make -j$(nproc) sudo make install sudo modprobe r8125同理适合需要自定义编译参数的人普通用户不必碰。五、装完不算完逐项勾选这张验证清单驱动装上 ≠ 驱动在干活。以下五条全部打勾才算真正完成lspci -k | grep -A2 -i ethernet里显示的驱动是r8125而不是r8169lsmod | grep r8125有输出且lsmod | grep r8169无输出dkms status显示r8125/9.018.00状态为installed能看到当前内核版本号ip link show能看到新网卡接口通常是enpXxx且ethtool 接口名 | grep Speed回显2500Mb/s实测带宽服务端iperf3 -s客户端iperf3 -c 服务器IP -t 30 -P 4结果接近 2.3Gbps 以上对比千兆环境的 940Mbps 基线提升一目了然失败现象参考如果lsmod里只有 r8169、没有 r8125说明黑名单没生效或没更新 initramfs回到第四节第 4 步复查如果速率仍显示 1000Mb/s先别怪驱动检查对端设备和网线详见下表。六、翻车现场速查表现象、原因、解法一列清现象原因解决办法dkms build报No rule to make target之类错误内核头文件未装或版本不匹配sudo apt install linux-headers-$(uname -r)后重试重启后只有 r8169、没有 r8125黑名单未生效 / initramfs 未更新检查/etc/modprobe.d/blacklist-r8169.conf内容重跑sudo update-initramfs -u再重启加载后速率仍显示 1000Mb/s对端设备只支持千兆或网线规格不足确认对端也是 2.5G 设备网线至少 Cat5emodprobe r8125报Operation not permitted内核模块签名校验失败 / Secure Boot 未关进 BIOS 关闭 Secure Boot或为模块签名autorun.sh 编译报错但屏幕信息太少日志被追加写入了文件执行tail -50 log.txt查看具体报错行七、进阶玩家的两条延伸路线驱动装好只是及格线想再进一步有两条路可选。路线一性能调优。追求满速可以加大接收缓冲区并开启中断合并降低高负载下的 CPU 占用sudo sysctl -w net.core.rmem_max26214400 sudo ethtool -C 接口名 rx-usecs 30 tx-usecs 30路线二自己打 Debian 包。想体验驱动像普通软件一样可升级可卸载的管理方式可以在项目目录里自己构建.debsudo apt install devscripts debmake debhelper build-essential dkms dh-dkms dpkg-buildpackage -b -rfakeroot -us -uc sudo dpkg -i realtek-r8125-dkms*.deb之后驱动就归dpkg管了升级、卸载都干干净净适合重度 Linux 用户。八、收尾三句话记住今天的内容DKMS 方式最省心内核升级自动重编译装一次管一年装完必须屏蔽 r8169否则驱动被抢占等于白装最后用 ethtool 和 iperf3 实测速率让数据替驱动说话。下一步行动很简单对照第二节清单核一遍环境然后从第四节第 1 步开始执行大约 5 分钟你的 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），仅供参考 RTL8125 2.5G网卡驱动安装不再踩坑：DKMS一步到位，内核升级也省心
RTL8125 2.5G网卡驱动安装不再踩坑DKMS一步到位内核升级也省心【免费下载链接】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里根本看不到接口或者明明插的是 2.5G 交换机协商速率却卡在 1000Mb/s——这不是硬件坏了而是驱动没到位。realtek-r8125-dkms 这个项目把 Realtek 官方 r8125 驱动封装成 DKMS 模块让 RTL8125 驱动安装变成一条命令的事而且内核升级后驱动会自动重编译再也不用每次升级都手工折腾。一、先搞清楚网卡跑不满到底卡在哪一环先把故事讲完整。上周有位朋友买了一块 PCIe 接口的 RTL8125 2.5G 网卡装进 Debian 主机后执行ip link show结果只有一个 lo 和一个板载千兆口新网卡连影子都没有换一台机器试接口出现了但ethtool里显示Speed: 1000Mb/s。这两个现象根因其实是同一个驱动不对路。内核里自带的r8169是一个通用驱动主要面向老款千兆芯片。它虽然能勉强驱动 RTL8125但能力有限经常只协商到 1G甚至干脆不识别。Realtek 官方另有专用驱动r8125才是为 2.5G 芯片优化过的正主。麻烦在于Linux 加载模块时r8169往往抢先一步占了网卡r8125就算装好也没机会上场。打个比方r8169像一位只懂老业务的老员工占了工位却干不了新活你要做的是把新来的专家r8125请进来并让老员工暂时休假屏蔽 r8169。而本项目 realtek-r8125-dkms就是帮你把这个过程自动化、并且内核升级后自动重来的人事管家。二、开工之前一张 10 分钟核对清单本节给你一张清单逐项打勾后再动手能避开 90% 的中途卡壳。必须项缺一不可网卡型号确认执行lspci | grep -i ethernet回显里要能看到Realtek ... RTL8125或RTL8126字样。如果看到的是RTL8156USB 网卡本项目不适用别往下走了。Debian / Ubuntu 系系统本教程基于apt生态其他发行版请对照dkms-install.sh脚本里的逻辑手动执行。dkms 工具sudo apt install dkms内核头文件sudo apt install linux-headers-$(uname -r)编译内核模块全靠它编译工具链sudo apt install build-essentialgit 客户端sudo apt install git用于克隆仓库可选项非必需ethtool查看网卡协商速率验证环节要用iperf3实测真实带宽数据比感觉更可靠一句话提醒头文件版本必须和当前内核严格一致。uname -r输出什么linux-headers-后面就接什么手滑装错版本后面dkms build必报错。三、三条路怎么选一张决策表帮你定本项目提供了三种装法它们互不干扰但绝大多数人只需要选一条。先看表再动手路线适合谁难度内核升级后长期维护成本DKMS 安装dkms-install.sh想一劳永逸的普通用户、生产环境低驱动自动重编译无需操心极低强烈推荐autorun.sh 一键脚本应急救火、当下就要有网最低失效需重新执行脚本高每次升级都要重跑手动编译src/下 make开发者、要自定义编译参数中失效需手动重编高依赖关系自己维护我的建议很直接不是十万火急就选 DKMS 这条稳路。下面第四节就是它的完整实操autorun.sh 和手动编译适合什么样的人第四节结尾会补两句让你心里有数。四、DKMS 安装实操五步走完装驱动 防冲突全程本节是全文核心。按顺序执行每步都有成功标志方便你随时自检。第 1 步把源码克隆到本地git clone https://gitcode.com/gh_mirrors/re/realtek-r8125-dkms cd realtek-r8125-dkms成功标志ls能看到autorun.sh、dkms-install.sh、dkms.conf和src/源码目录。如果克隆因网络波动失败重试几次即可。第 2 步确认内核头文件真的就绪uname -r ls /usr/lib/modules/$(uname -r)/build成功标志第一条输出一个版本号如6.8.0-45-generic第二条不报 No such file。如果报错回到清单把linux-headers-$(uname -r)装上再继续。第 3 步运行 DKMS 安装脚本核心一步sudo chmod x dkms-install.sh sudo ./dkms-install.sh脚本内部其实只干了三件事你可以对照输出确认进度把当前目录复制到/usr/src/r8125-9.018.00依次执行dkms add→dkms build后者会调用 make 编译内核模块期间会滚动大量编译日志属正常现象等待即可不要因为刷屏就以为卡死了执行dkms install把r8125.ko安装进内核模块目录。成功标志最后一行输出Finished running dkms install steps.且全程没有Error。别急装完还不算完——接下来这一步最关键。第 4 步屏蔽冲突驱动 r8169最关键的一步就像前面说的r8169会抢先加载把你的新驱动挤掉。这一步就是给它下停职令sudo tee /etc/modprobe.d/blacklist-r8169.conf /dev/null EOT # 屏蔽 r8169强制使用 r8125 专用驱动 blacklist r8169 EOT sudo update-initramfs -u成功标志update-initramfs -u刷新并显示update-initramfs: Generating /boot/initrd.img-版本号无报错。第 5 步重启让一切生效sudo reboot重启后先别急着开心走一遍第五节验证确认驱动真的在干活。应急路线补一句如果现在没网、急着救急可以不走 DKMS直接sudo ./autorun.sh。它会自动卸载旧驱动、编译、备份并替换 r8169、更新 initramfs最后输出Completed.。但记住它是一次性膏药——只对当前内核生效下次升级内核必须重跑。手动编译cd src make -j$(nproc) sudo make install sudo modprobe r8125同理适合需要自定义编译参数的人普通用户不必碰。五、装完不算完逐项勾选这张验证清单驱动装上 ≠ 驱动在干活。以下五条全部打勾才算真正完成lspci -k | grep -A2 -i ethernet里显示的驱动是r8125而不是r8169lsmod | grep r8125有输出且lsmod | grep r8169无输出dkms status显示r8125/9.018.00状态为installed能看到当前内核版本号ip link show能看到新网卡接口通常是enpXxx且ethtool 接口名 | grep Speed回显2500Mb/s实测带宽服务端iperf3 -s客户端iperf3 -c 服务器IP -t 30 -P 4结果接近 2.3Gbps 以上对比千兆环境的 940Mbps 基线提升一目了然失败现象参考如果lsmod里只有 r8169、没有 r8125说明黑名单没生效或没更新 initramfs回到第四节第 4 步复查如果速率仍显示 1000Mb/s先别怪驱动检查对端设备和网线详见下表。六、翻车现场速查表现象、原因、解法一列清现象原因解决办法dkms build报No rule to make target之类错误内核头文件未装或版本不匹配sudo apt install linux-headers-$(uname -r)后重试重启后只有 r8169、没有 r8125黑名单未生效 / initramfs 未更新检查/etc/modprobe.d/blacklist-r8169.conf内容重跑sudo update-initramfs -u再重启加载后速率仍显示 1000Mb/s对端设备只支持千兆或网线规格不足确认对端也是 2.5G 设备网线至少 Cat5emodprobe r8125报Operation not permitted内核模块签名校验失败 / Secure Boot 未关进 BIOS 关闭 Secure Boot或为模块签名autorun.sh 编译报错但屏幕信息太少日志被追加写入了文件执行tail -50 log.txt查看具体报错行七、进阶玩家的两条延伸路线驱动装好只是及格线想再进一步有两条路可选。路线一性能调优。追求满速可以加大接收缓冲区并开启中断合并降低高负载下的 CPU 占用sudo sysctl -w net.core.rmem_max26214400 sudo ethtool -C 接口名 rx-usecs 30 tx-usecs 30路线二自己打 Debian 包。想体验驱动像普通软件一样可升级可卸载的管理方式可以在项目目录里自己构建.debsudo apt install devscripts debmake debhelper build-essential dkms dh-dkms dpkg-buildpackage -b -rfakeroot -us -uc sudo dpkg -i realtek-r8125-dkms*.deb之后驱动就归dpkg管了升级、卸载都干干净净适合重度 Linux 用户。八、收尾三句话记住今天的内容DKMS 方式最省心内核升级自动重编译装一次管一年装完必须屏蔽 r8169否则驱动被抢占等于白装最后用 ethtool 和 iperf3 实测速率让数据替驱动说话。下一步行动很简单对照第二节清单核一遍环境然后从第四节第 1 步开始执行大约 5 分钟你的 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），仅供参考