1. 问题诊断与网卡型号确认当你兴冲冲地装好Ubuntu系统却发现右下角网络图标始终显示未连接时先别急着重装系统。我最近帮朋友调试一台华硕B460M主板的机器时就遇到了完全相同的状况——系统死活认不出有线网络。这种问题八成是网卡驱动在作怪特别是使用Realtek RTL8125-CG这类较新的2.5G网卡时。第一步要确认网卡型号。打开终端CtrlAltT输入这个神奇的命令lspci | grep -i ethernet你会看到类似Realtek Semiconductor Co., Ltd. RTL8125 2.5GbE Controller的输出。如果显示的是RTL8125-CG恭喜你找到了病因——Ubuntu默认内核可能没有内置这个驱动。有个细节要注意不同主板厂商可能对网卡型号标注有差异。比如我的华硕主板标注的是RTL8125-CG而微星主板可能只写RTL8125。其实它们驱动是通用的但建议到主板官网确认具体型号。有个用户就踩过坑他以为自己的网卡是RTL8168结果拆开机箱才发现贴纸上写着RTL8125B白折腾了半天。2. 驱动下载与临时安装方案确认型号后我们要去Realtek官网下载专用驱动。这里有个坑要注意Realtek官网改版过多次直接搜索可能找不到下载入口。建议收藏这个直达链接https://www.realtek.com/zh-tw/component/zoo/category/network-interface-controllers-10-100-1000m-gigabit-ethernet-pci-express-software下载时要注意两个关键点选择标有2.5G Ethernet LINUX driver r8125的版本核对内核版本兼容性比如for kernel up to 5.6我实测过r8125-9.004.01.tar.bz2这个版本在Ubuntu 20.04/22.04都可用。下载完成后解压到任意目录右键在终端打开执行sudo ./autorun.sh这个脚本会自动编译并加载驱动。执行完ifconfig就能看到eth0网卡了。但别高兴太早——这个方法有个致命缺陷重启后驱动会消失。就像我那个朋友说的每次开机都要重装驱动比网吧的还原卡还烦人。3. DKMS持久化驱动安装要让驱动在系统更新后依然存活就得请出DKMSDynamic Kernel Module Support这个神器。它会在内核更新时自动重编译驱动相当于给驱动上了永久居留证。完整操作流程3.1 准备编译环境先安装基础编译工具sudo apt update sudo apt install build-essential dkms linux-headers-$(uname -r)有次我忘了装linux-headers结果编译时报错kernel source not found耽误了半小时才找到原因。3.2 部署驱动源码把驱动解压到/usr/src目录这是DKMS的标准路径sudo tar xvf r8125-9.004.01.tar.bz2 -C /usr/src3.3 配置DKMS参数在/usr/src/r8125-9.004.01目录创建dkms.conf文件内容如下PACKAGE_NAMERealtek_r8125 PACKAGE_VERSION9.004.01 DEST_MODULE_LOCATION/updates/dkms BUILT_MODULE_NAMEr8125 BUILT_MODULE_LOCATIONsrc/ MAKE[0]make -C src/ all CLEAN[0]make -C src/ clean AUTOINSTALLyes特别注意PACKAGE_VERSION必须和目录名中的版本号完全一致否则dkms会报找不到源码错误。3.4 注册并编译驱动依次执行这些命令sudo dkms add -m r8125 -v 9.004.01 sudo dkms build -m r8125 -v 9.004.01 sudo dkms install -m r8125 -v 9.004.01 sudo depmod -a sudo modprobe r8125这个过程可能会花3-5分钟期间你会看到大量编译输出。有个常见错误是signature verification failed这时需要在BIOS中关闭Secure Boot。4. 网络配置与故障排查驱动装好后还需要正确配置网络接口。现代Ubuntu默认使用netplan管理网络配置文件通常在/etc/netplan/目录下。给个参考配置network: version: 2 renderer: networkd ethernets: enp3s0: # 用ip a命令查到的实际接口名 dhcp4: true optional: true常见问题解决方案接口名称不匹配用ip a查看实际接口名可能是enp0s20f6、enp3s0等DHCP获取不到IP尝试换成静态IP测试网速不达标检查网线是否支持2.5G至少Cat5e以上内核更新后失效重新执行dkms install步骤有个特别案例用户反馈驱动正常但网速只有100M。后来发现是他用的老路由器只支持百兆换成2.5G交换机后立刻跑满带宽。所以硬件兼容性也要纳入排查范围。5. 长期维护建议驱动安装只是开始要想长期稳定使用还需要注意这些内核更新处理每次系统更新内核后建议手动检查驱动状态dkms status | grep r8125如果显示installed就表示正常若显示added则需要重新build和install。驱动版本升级当Realtek发布新驱动时先卸载旧版再安装新版sudo dkms remove -m r8125 -v 9.004.01 --all禁用默认驱动有些系统会加载自带的r8169驱动导致冲突可以黑名单屏蔽echo blacklist r8169 | sudo tee /etc/modprobe.d/blacklist-r8169.conf我在三台不同配置的机器上测试过这个方案最久的一台已经稳定运行11个月。唯一遇到的问题是某次内核大版本升级后需要重新安装驱动整个过程不超过10分钟。对于想用2.5G网卡玩NAS的用户这个方案比换Intel网卡更经济实惠。