Ubuntu系统下Realtek RTL8125 2.5G网卡驱动永久配置指南每次内核更新后都要重新编译网卡驱动重启系统后驱动莫名其妙消失如果你正在使用Ubuntu 20.04或22.04 LTS版本并且主板搭载了Realtek RTL8125-CG 2.5G以太网卡这篇文章将彻底解决你的烦恼。我们将深入探讨如何利用DKMSDynamic Kernel Module Support工具实现驱动的自动重建和持久化安装让你告别反复手动编译的繁琐操作。1. 理解问题的根源在开始技术操作之前有必要先了解为什么Realtek RTL8125这类较新的2.5G网卡在Ubuntu系统中会遇到驱动问题。Linux内核对新硬件的支持往往存在一定的滞后性特别是像Realtek这样的第三方厂商提供的专有驱动。当你通过简单的./autorun.sh脚本安装驱动后虽然能暂时解决问题但这种安装方式存在两个致命缺陷驱动不会随内核更新自动重建每次系统内核升级后原有的驱动模块与新内核不兼容导致网卡无法使用缺乏版本管理手动安装的驱动难以追踪和更新系统维护变得复杂这就是为什么我们需要DKMS——一个专门为解决这类问题而设计的框架。DKMS会在内核更新时自动重新编译和安装内核模块确保驱动始终与当前运行的内核保持兼容。2. 准备工作与环境检查在开始DKMS配置前我们需要确保系统环境准备就绪。以下是必要的准备工作2.1 确认网卡型号首先确认你的网卡确实是Realtek RTL8125 2.5G型号lspci -nn | grep -i ethernet输出应该包含类似这样的信息03:00.0 Ethernet controller [0200]: Realtek Semiconductor Co., Ltd. RTL8125 2.5GbE Controller [10ec:8125] (rev 05)关键是要看到10ec:8125这个设备ID这明确标识了RTL8125网卡。2.2 安装必要的构建工具DKMS需要编译环境支持安装以下软件包sudo apt update sudo apt install -y build-essential dkms linux-headers-$(uname -r)重要提示linux-headers-$(uname -r)会安装与当前运行内核匹配的头文件这是成功编译驱动的关键。2.3 下载正确的驱动版本访问Realtek官方网站获取最新驱动 https://www.realtek.com/zh-tw/component/zoo/category/network-interface-controllers-10-100-1000m-gigabit-ethernet-pci-express-software选择适合你内核版本的驱动包。对于Ubuntu 20.04/22.04通常选择标有for kernel up to 5.x的版本即可。3. DKMS驱动的完整配置流程现在进入核心部分——通过DKMS实现驱动的永久安装。我们将分步骤详细解释每个操作的意义和注意事项。3.1 解压驱动到正确位置将下载的驱动包解压到DKMS的标准源目录sudo tar xvf r8125-9.004.01.tar.bz2 -C /usr/src/注意版本号(9.004.01)可能因下载的驱动版本不同而变化请根据实际情况调整命令。3.2 创建DKMS配置文件在驱动目录中创建dkms.conf文件这是整个过程中最关键的一步sudo nano /usr/src/r8125-9.004.01/dkms.conf文件内容如下PACKAGE_NAMERealtek_r8125 PACKAGE_VERSION9.004.01 DEST_MODULE_LOCATION/updates/dkms BUILT_MODULE_NAME[0]r8125 BUILT_MODULE_LOCATION[0]src/ MAKE[0]make -C src/ all CLEAN[0]make -C src/ clean AUTOINSTALLyes让我们解析这个配置文件的关键部分配置项说明PACKAGE_NAMEDKMS识别的模块名称PACKAGE_VERSION驱动版本号必须与目录名一致DEST_MODULE_LOCATION编译后模块的安装位置BUILT_MODULE_NAME实际生成的内核模块名称BUILT_MODULE_LOCATION源代码中模块的构建位置AUTOINSTALL设为yes让DKMS在新内核上自动安装3.3 注册并构建DKMS模块现在我们可以将驱动添加到DKMS系统并开始构建sudo dkms add -m r8125 -v 9.004.01 sudo dkms build -m r8125 -v 9.004.01 -k $(uname -r) sudo dkms install -m r8125 -v 9.004.01 -k $(uname -r)提示-k $(uname -r)参数明确指定为当前内核构建可以省略但显式声明更安全。3.4 加载新驱动并验证最后加载新编译的模块并验证是否正常工作sudo modprobe r8125检查驱动是否加载成功dmesg | grep r8125你应该能看到类似这样的输出表明驱动已正常加载[ 12.345678] r8125: loading out-of-tree module taints kernel. [ 12.345679] r8125: module verification failed: signature and/or required key missing - tainting kernel [ 12.345987] r8125 0000:03:00.0 eth0: RTL8125B, 00:11:22:33:44:55, IRQ 1234. 高级管理与故障排除配置完成后你可能还需要了解一些高级管理技巧和常见问题的解决方法。4.1 DKMS常用管理命令查看已安装的DKMS模块状态sudo dkms status输出示例r8125, 9.004.01, 5.15.0-60-generic, x86_64: installed卸载某个版本的DKMS模块sudo dkms remove -m r8125 -v 9.004.01 --all4.2 内核更新后的验证当系统内核更新后DKMS会自动重新编译驱动。你可以通过以下命令验证sudo dkms autoinstall这个命令会检查所有已注册的DKMS模块确保它们都已为当前内核正确构建和安装。4.3 常见问题及解决方案问题1DKMS构建失败提示缺少头文件解决确保安装了对应内核版本的headerssudo apt install linux-headers-$(uname -r)问题2网卡仍然无法识别解决检查模块是否加载lsmod | grep r8125如果没有输出尝试手动加载sudo modprobe r8125问题3系统启动时驱动未自动加载解决将模块添加到启动加载列表echo r8125 | sudo tee /etc/modules-load.d/r8125.conf5. 网络接口的持久化配置虽然驱动问题已经解决但为了获得最佳的网络体验我们还需要正确配置网络接口。5.1 识别网络接口名称首先确认你的以太网接口名称ip link show通常以enp开头如enp3s0。5.2 配置静态IP或DHCP使用Netplan配置网络Ubuntu 17.10及以后版本的默认网络配置工具sudo nano /etc/netplan/01-netcfg.yaml示例配置DHCPnetwork: version: 2 renderer: networkd ethernets: enp3s0: dhcp4: true应用配置sudo netplan apply5.3 禁用节能特性可选Realtek网卡有时会因节能特性导致性能问题可以通过ethtool调整sudo ethtool -s enp3s0 wol d sudo ethtool -K enp3s0 gso off tso off要使这些设置永久生效可以创建一个systemd服务或在启动脚本中添加这些命令。6. 驱动更新与维护保持驱动更新是确保系统稳定运行的重要环节。以下是维护建议定期检查Realtek官网关注驱动更新特别是遇到内核大版本升级时备份DKMS配置将/usr/src/r8125-*目录和/etc/modprobe.d/下的相关配置备份内核降级选项如果遇到兼容性问题可以暂时使用旧内核启动sudo apt install linux-image-5.15.0-60-generic linux-headers-5.15.0-60-generic sudo grub-set-default Ubuntu, with Linux 5.15.0-60-generic sudo update-grub7. 性能优化与高级调优对于追求极致网络性能的用户还可以考虑以下优化措施7.1 中断合并调整减少网络中断对系统性能的影响sudo ethtool -C enp3s0 rx-usecs 8 rx-frames 32 tx-usecs 8 tx-frames 327.2 接收端缩放(RSS)配置启用多队列支持以利用多核CPUsudo ethtool -L enp3s0 combined 47.3 缓冲区大小调整根据网络负载调整缓冲区大小sudo ethtool -G enp3s0 rx 4096 tx 4096这些优化参数需要根据实际网络环境和硬件配置进行调整建议在更改前记录原始值以便恢复。