当前位置：首页 > news >正文

新硬件装老系统？手把手解决Ubuntu18.04下Realtek 2.5G网卡没网络的尴尬

news 2026/5/2 21:29:18

新硬件装老系统？手把手解决Ubuntu18.04下Realtek 2.5G网卡没网络的尴尬

最近给工作室配了台新主机，华硕主板搭配11代i7，想着性能应该杠杠的。结果装完Ubuntu18.04傻眼了——网卡死活识别不出来。作为一名常年和Linux打交道的开发者，这种"新硬件装老系统"的兼容性问题其实很常见。今天就带大家一步步解决Realtek 2.5G网卡在Ubuntu18.04下的驱动安装难题。

1. 问题诊断：为什么新网卡在老系统上"失联"？

先说说这个问题的本质。Realtek RTL8125这类2.5G网卡是近几年才普及的新硬件，而Ubuntu18.04发布于2018年，其默认内核版本(4.15)根本不可能预装对新硬件的支持。这就好比给老爷车装了个最新款的涡轮增压器——硬件再先进，ECU不认也是白搭。

几个关键判断点：

lspci | grep -i ethernet命令能看到网卡设备但无驱动加载
ifconfig -a输出中找不到eth0或enpXsX这类网卡接口
dmesg | grep r8125显示驱动加载失败或硬件未识别

遇到这种情况别慌，手动编译驱动就能解决。下面我会用最稳妥的DKMS方案，确保系统更新后驱动也能自动重建。

2. 驱动准备：从源码到编译环境

2.1 获取官方驱动源码

首先访问Realtek官网下载专区：

https://www.realtek.com/en/component/zoo/category/network-interface-controllers-10-100-1000m-gigabit-ethernet-pci-express-software

选择对应版本时要注意：

确认网卡型号是RTL8125（通过Windows设备管理器或lspci -nn | grep 8125）
下载标有"2.5G Ethernet LINUX driver r8125"的Unix/Linux版本
当前最新稳定版是9.009.01，但后续版本也兼容

下载后传到Ubuntu系统，或用U盘拷贝。我习惯用scp传输：

scp r8125-9.009.01.tar.gz user@ip:/home/user/

2.2 搭建编译环境

Ubuntu18.04需要先配置基础开发工具：

sudo apt update sudo apt install -y build-essential linux-headers-$(uname -r) dkms

常见坑点：

如果遇到"Unable to locate package linux-headers-xxx"，先执行sudo apt --fix-broken install
企业内网可能需要先配置代理（注意：此处不涉及任何敏感网络工具）

3. 驱动安装：从临时方案到永久配置

3.1 快速测试驱动

解压并运行自动安装脚本：

tar xvf r8125-9.009.01.tar.gz cd r8125-9.009.01 sudo chmod +x autorun.sh sudo ./autorun.sh

如果看到"Driver installed successfully"，执行ifconfig应该能看到网卡了。但这种方式只是临时生效，重启后就会失效。

3.2 DKMS永久安装方案

把驱动纳入DKMS管理系统，才能应对内核更新：

sudo cp -r ~/r8125-9.009.01 /usr/src/r8125-9.009.01

创建DKMS配置文件/usr/src/r8125-9.009.01/dkms.conf：

PACKAGE_NAME="Realtek_r8125" PACKAGE_VERSION="9.009.01" BUILT_MODULE_NAME="r8125" DEST_MODULE_LOCATION="/updates/dkms" AUTOINSTALL="yes" MAKE[0]="make -C src/ all" CLEAN="make -C src/ clean"

注册并编译驱动：

sudo dkms add -m r8125 -v 9.009.01 sudo dkms build -m r8125 -v 9.009.01 sudo dkms install -m r8125 -v 9.009.01 sudo depmod -a sudo modprobe r8125

验证驱动状态：

dkms status | grep r8125 # 应该显示：r8125, 9.009.01: added, built, installed

4. 系统调优与故障排查

4.1 处理内核更新问题

DKMS虽然能自动重建驱动，但某些情况下可能需要手动干预：

方案一：创建自动恢复脚本

#!/bin/bash dkms remove r8125/9.009.01 --all dkms install -m r8125 -v 9.009.01 depmod -a modprobe r8125

方案二：临时锁定内核版本（不推荐长期使用）

sudo apt-mark hold linux-image-$(uname -r) sudo apt-mark hold linux-headers-$(uname -r)

4.2 性能优化参数

在/etc/modprobe.d/r8125.conf中添加：

options r8125 speed=2500 duplex=full autoneg=off

查看当前链路状态：

ethtool eth0 # 关注Speed/Duplex/Auto-negotiation字段

4.3 常见错误处理

问题1：编译时报错"field has incomplete type"解决方法：升级gcc到7.x以上版本：

sudo apt install gcc-7 g++-7 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-7 70

问题2：modprobe报错"Unknown symbol"需要重新生成模块依赖：

sudo depmod -a sudo update-initramfs -u

5. 替代方案评估

如果不想折腾驱动编译，还有几个备选方案：

方案对比表：

方案	优点	缺点	适用场景
手动编译DKMS	永久生效，支持内核更新	步骤复杂	长期使用的生产环境
升级到Ubuntu20.04+	开箱即用	可能破坏现有环境	新项目部署
USB转以太网	即插即用	性能损失	临时调试使用
更换Intel网卡	内核原生支持	硬件成本	采购新设备时