Linux网卡驱动完全指南：Realtek r8125驱动安装与性能优化

在Linux系统中，高性能网络连接依赖于稳定的硬件驱动程序。Realtek r8125驱动专为2.5 GbE（千兆以太网）网卡设计，提供比传统千兆网络更快的传输速度和更稳定的连接体验。本指南将通过"问题-方案-优化"的逻辑主线，帮助您解决Realtek r8125网卡的驱动安装、配置及性能调优问题，让您的2.5G网卡配置达到最佳状态。

驱动选择决策指南：r8125 vs r8169

在开始安装前，了解Realtek网卡驱动的选择至关重要。Linux系统通常默认使用r8169驱动，但对于支持2.5Gbps的RTL8125芯片组，专用的r8125驱动能提供更好的性能和兼容性。

特性	r8169驱动	r8125驱动
最高速率	1Gbps	2.5Gbps
芯片支持	广泛但老旧	专为RTL8125优化
能源效率	一般	高（支持EEE节能）
DKMS支持	有限	原生支持
高级功能	基础	完整（RSS、Jumbo Frame等）

决策建议：如果您的网卡型号为RTL8125或需要2.5Gbps速率，强烈建议使用r8125驱动；老旧Realtek网卡可继续使用r8169驱动。

驱动安装教程：三种方法对比

方法一：Debian包安装（推荐）

Debian包安装是最简便的方法，适合Debian/Ubuntu系统用户：

# 安装Debian包
sudo dpkg -i realtek-r8125-dkms_*.deb

# 若出现依赖问题，运行以下命令修复
sudo apt install --fix-broken -y

方法二：使用autorun.sh脚本

如果您已克隆项目仓库，可直接运行自动安装脚本：

# 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/re/realtek-r8125-dkms
cd realtek-r8125-dkms

# 运行自动安装脚本
sudo chmod +x autorun.sh
sudo ./autorun.sh

方法三：DKMS手动安装

DKMS（Dynamic Kernel Module Support）允许内核更新后自动重新编译驱动：

# 运行DKMS安装脚本
sudo chmod +x dkms-install.sh
sudo ./dkms-install.sh

# 验证DKMS状态
dkms status | grep r8125

🔧 操作提示：安装完成后建议重启系统，确保驱动正确加载。

驱动配置操作指南

禁用冲突驱动

为确保r8125驱动正常工作，需要禁用系统默认的r8169驱动：

# 创建黑名单配置文件
sudo tee /etc/modprobe.d/blacklist-r8169.conf > /dev/null <<EOT
# 禁用r8169驱动以使用r8125
blacklist r8169
EOT

# 更新initramfs并重启
sudo update-initramfs -u
sudo reboot

⚠️ 注意：重启后系统将完全依赖r8125驱动，请确保已正确安装。

验证驱动安装状态

重启后，使用以下命令验证驱动是否成功加载：

# 检查r8125模块是否加载
lsmod | grep r8125

# 查看网络接口信息
ip link show

# 检查网卡速率
ethtool eth0 | grep "Speed"

成功标志：lsmod命令应显示r8125模块，ethtool应显示2500Mb/s的速率。

性能调优指南

启用Jumbo Frame

RTL8125支持最大9KB的巨型帧（Jumbo Frame），可提高大数据传输效率：

# 临时设置MTU为9000（重启后失效）
sudo ifconfig eth0 mtu 9000

# 永久设置（Debian/Ubuntu系统）
sudo tee -a /etc/network/interfaces > /dev/null <<EOT
iface eth0 inet dhcp
    mtu 9000
EOT

配置EEE节能功能

EEE（Energy Efficient Ethernet）功能可在低流量时自动降低功耗：

# 查看当前EEE状态
sudo ethtool --show-eee eth0

# 启用EEE功能
sudo ethtool --set-eee eth0 eee on tx-lpi on tx-timer 1546

接收端缩放（RSS）配置

RSS技术可将网络流量分配到多个CPU核心，提高处理性能：

# 查看当前RSS队列数
sudo ethtool -x eth0

# 设置RSS队列数为4（根据CPU核心数调整）
sudo ethtool -X eth0 rx-flow-hash udp4 sdfn tcp4 sdfn

常见场景配置模板

家庭网络优化模板

适合家庭2.5G网络环境，平衡性能与功耗：

# 设置固定速率2.5Gbps
sudo ethtool -s eth0 speed 2500 duplex full autoneg off

# 启用Jumbo Frame
sudo ifconfig eth0 mtu 9000

# 配置节能模式
sudo ethtool --set-eee eth0 eee on tx-lpi on

服务器高性能配置模板

适合服务器环境，最大化网络性能：

# 禁用节能功能
sudo ethtool --set-eee eth0 eee off

# 启用RSS多队列
sudo ethtool -X eth0 rx-flow-hash udp4 sdfn tcp4 sdfn

# 增加接收缓冲区
sudo sysctl -w net.core.rmem_max=26214400

性能测试对比

使用iperf3工具测试不同配置下的网络性能：

# 安装iperf3
sudo apt install iperf3 -y

# 作为服务端
iperf3 -s

# 在另一台机器上作为客户端测试
iperf3 -c <服务器IP> -t 60 -i 10

测试结果对比（示例）

配置	平均吞吐量	CPU占用率	延迟
默认配置	940 Mbps	35%	1.2 ms
启用Jumbo Frame	2350 Mbps	20%	0.8 ms
启用RSS	2420 Mbps	15%	0.7 ms

故障排查操作指南

驱动未加载问题

# 检查驱动模块状态
modinfo r8125

# 手动加载驱动
sudo modprobe r8125

# 查看加载日志
dmesg | grep r8125

网络不稳定问题

# 检查链路状态
sudo ethtool eth0

# 查看错误统计
ifconfig eth0 | grep errors

# 更新固件（如适用）
sudo apt install firmware-realtek -y

内核升级后驱动失效

# 重新构建DKMS模块
sudo dkms remove r8125/9.009.02 --all
sudo dkms add ./r8125-dkms
sudo dkms build r8125/9.009.02
sudo dkms install r8125/9.009.02

驱动版本兼容性速查表

驱动版本	支持内核版本	发布日期	主要改进
9.009.02	2.6.32-5.19.x	2023-05	增加对新内核支持
9.008.00	2.6.32-5.15.x	2022-11	改进EEE功能
9.007.01	2.6.32-5.10.x	2022-05	修复稳定性问题
9.006.01	2.6.32-5.4.x	2021-11	初始DKMS版本

使用建议：始终使用与您内核版本匹配的最新驱动，以获得最佳性能和稳定性。

总结

Realtek r8125驱动为Linux系统提供了强大的2.5G网络支持。通过本指南的安装教程、性能调优和故障排查步骤，您可以充分发挥RTL8125网卡的潜力。无论是家庭用户还是服务器环境，合理配置驱动参数都能显著提升网络性能。记得定期检查驱动更新，以确保兼容性和安全性。如有问题，可查阅项目源码目录中的文档或提交issue获取支持。