RTL8125网卡在CentOS 7.9中驱动无法加载

Question

在CentOS 7.9系统中，RTL8125千兆网卡驱动无法正常加载的常见问题是：系统默认内核未集成RTL8125所需驱动模块（r8125），且DKMS驱动编译失败。该问题多因缺少kernel-devel包、GCC编译环境不完整或签名验证导致。即使手动安装官方驱动，也常因内核版本与头文件不匹配而无法注册模块。此外，Secure Boot启用时会阻止未签名驱动加载，进一步加剧问题。需通过禁用Secure Boot、安装对应kernel-devel包并正确编译安装r8125驱动方可解决，但升级内核后易再次失效，影响系统网络稳定性。

Answer 1

1. 问题背景与现象描述

在CentOS 7.9系统部署过程中，使用搭载RTL8125千兆网卡的服务器或工控设备时，常出现网络接口无法识别、ip link show中无对应enpXsY设备，或dmesg | grep r8125提示“module not found”等问题。进一步排查发现，系统默认内核（如3.10.0-1160系列）并未集成Realtek RTL8125所需的r8125驱动模块，仅支持较老型号如RTL8169。由于该网卡需专用驱动支持，导致物理层连接正常但链路层无法激活。

2. 根本原因分析

• 内核模块缺失：Linux主线内核长期未合并r8125驱动，需依赖厂商提供out-of-tree模块。
• DKMS编译失败：常见报错包括“make[1]: *** /lib/modules/$(uname -r)/build: No such file or directory”，表明缺少kernel-devel包。
• 开发环境不完整：未安装gcc、make、binutils等基础编译工具链。
• Secure Boot限制：UEFI安全启动启用后，会拒绝加载未签名的第三方内核模块。
• 内核版本不匹配：已安装kernel-devel版本与当前运行内核不一致，导致头文件偏移错误。
• 升级后失效：系统更新内核后，DKMS未自动重建模块，需重新编译。

3. 解决方案实施路径

步骤	操作内容	关键命令/说明
1	确认硬件型号	lspci | grep -i ethernet 应显示“RTL8125”
2	关闭Secure Boot	进入BIOS设置界面禁用Secure Boot选项
3	安装依赖组件	yum install -y gcc make kernel-devel kernel-headers
4	验证内核一致性	uname -r 与 rpm -q kernel-devel 版本必须相同
5	下载官方驱动	从Realtek官网获取r8125-9.x.x.tar.bz2
6	解压并编译	tar jxvf r8125-*.tar.bz2 && cd r8125-* && ./autorun.sh
7	检查模块加载	lsmod | grep r8125 和 dmesg | tail -20
8	配置持久化	确保/etc/dracut.conf.d/r8125.conf包含“add_drivers+=r8125”
9	重建initramfs	dracut -f
10	重启验证	reboot && ip a show 查看网卡是否激活

4. 自动化修复脚本示例

#!/bin/bash
# centos7_r8125_installer.sh
KERNEL_VER=$(uname -r)
KDEV_PKG="kernel-devel-${KERNEL_VER}"

if ! rpm -q ${KDEV_PKG} >/dev/null; then
    yum install -y ${KDEV_PKG} || { echo "Failed to install kernel-devel"; exit 1; }
fi

if ! command -v gcc >/dev/null; then
    yum install -y gcc make binutils >/dev/null
fi

# Download and install driver
wget https://github.com/awesometic/realtek-r8125-dkms/archive/master.zip
unzip master.zip
cd realtek-r8125-dkms-master
./install.sh

# Ensure module is loaded at boot
echo "r8125" > /etc/modules-load.d/r8125.conf
dracut -f

5. 故障诊断流程图

graph TD A[网卡无法识别] --> B{lspci是否检测到RTL8125?} B -- 否 --> C[检查PCIe插槽/硬件故障] B -- 是 --> D[Secure Boot是否启用?] D -- 是 --> E[进入BIOS禁用Secure Boot] D -- 否 --> F[检查kernel-devel版本] F --> G{uname -r == installed kernel-devel?} G -- 否 --> H[yum update kernel* && reboot] G -- 是 --> I[执行./autorun.sh编译驱动] I --> J{编译成功?} J -- 否 --> K[检查GCC环境及权限] J -- 是 --> L[modprobe r8125 && ip link show] L --> M[网络接口出现 → 成功]