★ FEATURED ARTICLE 简介本资源专为在物理机上离线部署CentOS 7.9系统的运维工程师与Linux系统管理员设计解决Realtek RTL8125 2.5GbE网卡在默认内核下无法识别、驱动安装失败及Secure Boot冲突导致联网异常等典型问题。压缩包共51个文件含15个RPM依赖包覆盖gcc、kernel-devel、glibc等编译环境核心组件、8个C源码与7个头文件构成r8125-9.011.01驱动主体、6个Windows批处理脚本辅助环境检查与路径配置、以及autorun.sh、Makefile、README等关键控制与说明文件整体大小55.41MB结构完整、开箱即用。已有3258人学习下载用户可直接获取经实测验证的全链路离线驱动安装方案包括BIOS级配置要点、内核符号链接修复、rpm强制安装策略及自动化构建流程避免因版本错配或依赖缺失反复踩坑显著提升国产化硬件适配效率。1. 离线安装物理机CentOS7系统Realtek2.5G网卡驱动r8125为什么装完系统连不上内网、ping不通网关甚至ifconfig都看不到eth0你刚在一台全新上架的国产服务器或工控主机上刷完CentOS 7.9最小化镜像插上Realtek RTL8125B/RTL8125BG这类2.5G网卡——结果lspci | grep -i realtek能认出硬件ip link show却死活不显示对应网口dmesg | grep r8125空空如也modprobe r8125报错“Module not found”。更糟的是这台机器压根没联网U盘里只有ISO和几个rpm包连yum install kernel-devel都卡在“Cannot find a valid baseurl for repo”……这不是配置问题是内核模块根本没加载。CentOS 7.9默认内核3.10.0-1160系列原生不支持r8125官方驱动又强依赖在线编译环境与匹配的kernel-headersdevel包。本文就带你用纯离线方式在无网络、无GUI、无root密码已重置的物理机上把r8125驱动从源码编译、签名、注入内核模块路径、自动加载一气呵成。适合运维批量部署、信创项目交付、工业现场调试等真实离线场景——不是教你怎么联网再装而是教你怎么在“断网即失联”的边缘状态下让2.5G网卡真正亮起来。2. 理清三重依赖链为什么不能直接拷贝ko文件kernel-devel版本、内核头文件、模块签名缺一不可Realtek r8125驱动不是“下载一个r8125.ko扔进/lib/modules/uname -r/kernel/drivers/net/ethernet/realtek/”就能用的黑盒模块。它本质是需针对当前运行内核实时编译的内核模块且CentOS 7启用了模块签名强制校验CONFIG_MODULE_SIG_FORCEy未签名模块会被内核静默拒绝。因此离线安装必须闭环解决三个硬性依赖2.1 确认目标主机真实内核版本与架构别信cat /proc/version或uname -r输出的表面信息——某些定制镜像会修改/lib/modules/下的目录名但不更新内核符号链接。最可靠方式是# 进入救援模式或单用户模式后执行若已启动但无网络先挂载系统盘 mount /dev/sda2 /mnt # 假设根分区为sda2 chroot /mnt # 真实内核版本由vmlinuz文件决定 ls -l /boot/vmlinuz-* # 输出示例/boot/vmlinuz-3.10.0-1160.114.2.el7.x86_64 # → 实际需匹配的内核版本为 3.10.0-1160.114.2.el7.x86_64 # 同时确认架构x86_64绝大多数服务器或 aarch64少数国产平台 uname -m提示若/boot下存在多个vmlinuz用grubby --default-kernel查默认启动项避免编译错版本导致模块加载失败。2.2 获取严格匹配的kernel-devel与kernel-headers RPM包Realtek官方驱动Makefile中KDIR ? /lib/modules/$(shell uname -r)/build指向/lib/modules/3.10.0-1160.114.2.el7.x86_64/build该路径实际是kernel-devel包安装的符号链接。离线环境下必须获取完全同版本的RPMkernel-devel-3.10.0-1160.114.2.el7.x86_64.rpmkernel-headers-3.10.0-1160.114.2.el7.x86_64.rpm注意kernel-headers包名中的版本号可能略低于kernel-devel如3.10.0-1160.el7但必须保证主版本一致3.10.0-1160。若版本不匹配make会报错No rule to make target scripts/Makefile.modbuiltin。2.3 驱动源码包选择与签名准备Realtek官网提供两种格式r8125-9.008.01.tar.bz2最新稳定版支持RTL8125B/RTL8125BG/RTL8126Br8125-9.008.01.src.rpmSource RPM需rpmbuild重建对离线环境不友好强烈推荐tar包解压后sudo ./autorun.sh可全自动完成编译、安装、模块签名若启用Secure Boot、depmod更新。但注意autorun.sh默认调用/usr/src/kernels/路径而CentOS 7的kernel-devel安装路径为/usr/src/kernels/3.10.0-1160.114.2.el7.x86_64/需确保该路径存在且内容完整含include/、scripts/、Makefile等。若/usr/src/kernels/为空说明kernel-devel未正确安装或路径被破坏。3. 离线环境驱动编译四步法从U盘拷贝到模块自动加载假设你已将以下文件存入U盘FAT32格式避免Linux权限丢失kernel-devel-3.10.0-1160.114.2.el7.x86_64.rpmkernel-headers-3.10.0-1160.114.2.el7.x86_64.rpmr8125-9.008.01.tar.bz2gcc-4.8.5-44.el7.x86_64.rpmCentOS 7.9最小化安装常缺失gccmake-3.82-24.el7.x86_64.rpm同上3.1 挂载U盘并安装基础编译工具链# 插入U盘确认设备名通常为/dev/sdb1 fdisk -l | grep Disk /dev/sd # 创建挂载点并挂载 mkdir /mnt/usb mount /dev/sdb1 /mnt/usb # 安装gcc与make按依赖顺序make依赖gcc rpm -ivh /mnt/usb/gcc-4.8.5-44.el7.x86_64.rpm rpm -ivh /mnt/usb/make-3.82-24.el7.x86_64.rpm # 验证 gcc --version # 应输出 4.8.5 make --version # 应输出 3.82参数说明rpm -ivh中iinstall,vverbose显示详情,hhash进度条。若提示依赖缺失如glibc-devel说明该主机非标准CentOS 7.9需额外补全glibc-devel-2.17-325.el7_9.x86_64.rpm等基础开发包。3.2 安装kernel-devel并验证路径完整性# 安装内核开发包关键 rpm -ivh /mnt/usb/kernel-devel-3.10.0-1160.114.2.el7.x86_64.rpm rpm -ivh /mnt/usb/kernel-headers-3.10.0-1160.114.2.el7.x86_64.rpm # 检查路径是否存在且非空 ls -l /usr/src/kernels/ # 正确输出应为 # drwxr-xr-x. 22 root root 4096 Dec 15 10:22 3.10.0-1160.114.2.el7.x86_64 # 进入目录检查核心文件 cd /usr/src/kernels/3.10.0-1160.114.2.el7.x86_64 ls -l Makefile include/scripts/ # 必须存在 # 若缺少Makefile说明rpm包损坏或安装异常需重新下载3.3 解压驱动源码并执行离线编译安装# 解压驱动U盘中 tar -xjf /mnt/usb/r8125-9.008.01.tar.bz2 -C /tmp/ cd /tmp/r8125 # 关键修改autorun.sh强制指定KDIR路径防自动探测失败 sed -i s/KDIR ?.*$/KDIR ? \/usr\/src\/kernels\/3.10.0-1160.114.2.el7.x86_64/ src/Makefile # 执行安装自动编译、安装ko、更新depmod、配置开机加载 sudo ./autorun.sh # 观察输出关键行 # Check items: ... [OK] # make[1]: Entering directory /usr/src/kernels/3.10.0-1160.114.2.el7.x86_64 # INSTALL /tmp/r8125/src/r8125.ko # DEPMOD 3.10.0-1160.114.2.el7.x86_64逻辑说明autorun.sh本质是封装了make clean make modules make modules_install depmod -a的脚本。sed命令强制写死KDIR避免其调用uname -r后因chroot环境或路径映射错误导致编译失败。make modules_install会将r8125.ko复制到/lib/modules/3.10.0-1160.114.2.el7.x86_64/kernel/drivers/net/ethernet/realtek/depmod -a生成modules.dep依赖关系。3.4 加载模块并验证网卡识别# 手动加载模块测试 sudo modprobe r8125 # 检查是否成功 lsmod | grep r8125 # 应输出 r8125 294912 0 dmesg | tail -20 # 查看内核日志应有r8125: This product is supported by Realtek # 查看网卡接口 ip link show | grep -A5 state DOWN\|state UP # 寻找类似 eth0: BROADCAST,MULTICAST,UP # 若看到eth0但无IP手动配置测试 sudo ip addr add 192.168.1.100/24 dev eth0 sudo ip link set eth0 up ping -c 3 192.168.1.1 # 测试网关连通性参数说明modprobe r8125触发内核加载模块lsmod确认模块驻留内存dmesg是诊断核心若出现r8125: version magic 3.10.0-1160.114.2.el7.x86_64 SMP mod_unload should be 3.10.0-1160.114.2.el7.x86_64 SMP mod_unload pae 说明kernel-headers版本不匹配需更换。4. r8125离线安装避坑指南5个血泪经验总结第3条90%的人会翻车离线环境没有错误提示的缓冲带一个微小偏差就会导致整个流程中断。以下是某实验室批量部署200台工控机时踩出的真实坑点按发生频率排序4.1 现象./autorun.sh报错“Cant find kernel source tree”原因autorun.sh内部调用find /lib/modules/$(uname -r)/build但离线主机处于chroot环境或/lib/modules/$(uname -r)/build软链接指向错误路径如指向/usr/src/kernels/3.10.0-1160.el7.x86_64而非实际安装的3.10.0-1160.114.2.el7.x86_64。解决# 删除错误软链接 rm -f /lib/modules/3.10.0-1160.114.2.el7.x86_64/build # 重建指向正确路径 ln -sf /usr/src/kernels/3.10.0-1160.114.2.el7.x86_64 /lib/modules/3.10.0-1160.114.2.el7.x86_64/build4.2 现象modprobe r8125后dmesg显示“r8125: disagrees about version of symbol struct_module”原因驱动模块编译时使用的kernel-devel版本与当前运行内核/boot/vmlinuz-*版本不一致。例如编译用3.10.0-1160.114.2.el7但实际启动的是3.10.0-1160.113.2.el7。解决用ls -l /boot/vmlinuz-$(uname -r)确认真实内核文件时间戳下载完全同名的kernel-devel包精确到.el7后缀重新安装kernel-devel并清理旧模块sudo rm /lib/modules/3.10.0-1160.114.2.el7.x86_64/kernel/drivers/net/ethernet/realtek/r8125.ko4.3 现象ip link show能看到eth0但ethtool eth0显示Speed: Unknown!且无法获取2.5G速率原因高频翻车点Realtek r8125驱动默认关闭EEEEnergy Efficient Ethernet节能模式而部分交换机端口在EEE协商失败时会降速至1G或断开。CentOS 7.9内核未启用CONFIG_R8125_EEE选项驱动源码中r8125_main.c的eee_enable默认为0。解决# 编辑驱动源码启用EEE支持需在编译前修改 sed -i /#define EEE_ENABLE/s/0/1/ src/r8125_main.c # 或更稳妥加载模块时传参无需重编译 echo options r8125 eee_enable1 /etc/modprobe.d/r8125.conf sudo modprobe -r r8125 sudo modprobe r8125 # 验证 ethtool eth0 | grep -i speed\|eee # 正确输出应含 Speed: 2500Mb/s 和 EEE status: enabled4.4 现象重启后r8125模块未自动加载ip link无eth0原因autorun.sh虽执行depmod -a但未将模块名写入/etc/modules-load.d/配置导致initramfs未包含该模块。解决# 创建开机加载配置 echo r8125 /etc/modules-load.d/r8125.conf # 重建initramfs关键否则重启后仍失效 dracut -f -v # 验证initramfs是否包含模块 lsinitrd /boot/initramfs-$(uname -r).img | grep r81254.5 现象dmesg报错“r8125: signature and/or required key missing - tainting kernel”原因主机启用Secure Boot而r8125.ko未签名。CentOS 7默认不启用Secure Boot但部分国产BIOS固件强制开启。解决# 临时禁用Secure Boot需进BIOS设置 # 或离线签名需提前准备MOK密钥 sudo mokutil --import /tmp/r8125.der # 导入公钥 # 重启后按提示输入密码完成密钥注册 # 再用sign-file工具签名ko文件过程复杂生产环境建议优先禁用Secure Boot5. 进阶技巧自动化批量部署脚本 故障自愈机制让200台机器一次搞定当面对数十台同型号物理机时手动重复上述步骤效率极低。我一般会构建一个“三合一”离线部署包并加入自愈逻辑——即使某台机器因BIOS设置差异导致首次加载失败也能在下次启动时自动修复。5.1 构建可复用的离线部署包结构在U盘根目录创建如下结构centos7-r8125-offline/ ├── rpm/ # 存放所有rpm包 │ ├── kernel-devel-3.10.0-1160.114.2.el7.x86_64.rpm │ ├── gcc-4.8.5-44.el7.x86_64.rpm │ └── ... ├── driver/ │ └── r8125-9.008.01.tar.bz2 └── scripts/ ├── deploy_r8125.sh # 主部署脚本含版本校验、自动修复 └── self_heal.sh # 开机自启的守护脚本5.2 主部署脚本核心逻辑deploy_r8125.sh#!/bin/bash # 自动检测当前内核版本并匹配rpm包 CURRENT_KERNEL$(uname -r) RPM_DIR/mnt/usb/centos7-r8125-offline/rpm DRIVER_TAR/mnt/usb/centos7-r8125-offline/driver/r8125-9.008.01.tar.bz2 # 步骤1校验kernel-devel是否存在且匹配 if ! rpm -q kernel-devel-${CURRENT_KERNEL} /dev/null; then echo Installing kernel-devel for ${CURRENT_KERNEL} rpm -ivh ${RPM_DIR}/kernel-devel-${CURRENT_KERNEL}.rpm fi # 步骤2解压驱动并打EEE补丁解决4.3坑 tar -xjf ${DRIVER_TAR} -C /tmp/ sed -i /#define EEE_ENABLE/s/0/1/ /tmp/r8125/src/r8125_main.c # 步骤3编译安装带错误捕获 if ! /tmp/r8125/autorun.sh; then echo Autorun failed, retrying with explicit KDIR... cd /tmp/r8125/src make clean make KDIR/usr/src/kernels/${CURRENT_KERNEL} make install depmod -a fi # 步骤4配置开机加载与自愈 echo r8125 /etc/modules-load.d/r8125.conf echo options r8125 eee_enable1 /etc/modprobe.d/r8125.conf dracut -f # 步骤5安装自愈脚本见5.3 cp /mnt/usb/centos7-r8125-offline/scripts/self_heal.sh /usr/local/bin/ chmod x /usr/local/bin/self_heal.sh systemctl enable self_heal.service5.3 自愈脚本self_heal.sh与服务单元#!/bin/bash # 每5分钟检查r8125模块状态异常时自动重载 if ! lsmod | grep -q ^r8125 ; then echo $(date): r8125 module missing, reloading... /var/log/r8125-heal.log modprobe -r r8125 2/dev/null modprobe r8125 # 强制重置网卡 ip link set eth0 down 2/dev/null ip link set eth0 up 2/dev/null fi # 检查速率是否为2500Mb/s if ! ethtool eth0 2/dev/null | grep -q Speed: 2500; then echo $(date): Speed not 2500Mb/s, resetting EEE... /var/log/r8125-heal.log ethtool -s eth0 eee off ethtool -s eth0 eee on fi对应systemd服务/etc/systemd/system/self_heal.service[Unit] DescriptionR8125 Driver Self-Healing Service Afternetwork.target [Service] Typeoneshot ExecStart/usr/local/bin/self_heal.sh RemainAfterExityes [Install] WantedBymulti-user.target然后启用定时器# 创建每5分钟执行的timer cat /etc/systemd/system/self_heal.timer EOF [Unit] DescriptionRun r8125 self-heal every 5 minutes [Timer] OnCalendar*:*:0/5 Persistenttrue [Install] WantedBytimers.target EOF systemctl daemon-reload systemctl enable self_heal.timer systemctl start self_heal.timer5.4 验证与压测确认2.5G带宽真实可用部署完成后务必用iperf3进行端到端吞吐量验证需另一台同网段机器# 在目标机装r8125执行 iperf3 -s -i 1 # 在客户端执行确保客户端网卡也支持2.5G iperf3 -c 192.168.1.100 -t 30 -P 4 # -P 4启用4线程并行合格标准单线程稳定≥2.2Gbps受TCP协议栈限制4线程总和≥2.4Gbps证明驱动与网卡硬件协同正常ethtool -S eth0 | grep rx_packets\|tx_packets显示收发包计数持续增长无rx_missed_errors或tx_aborted_errors最后说句实在话Realtek r8125在CentOS 7上的离线适配本质是跟内核版本、编译环境、硬件协商三者较劲。我见过太多人卡在kernel-devel版本差一个小数点或者忘了dracut -f导致重启失效。所以现在我的U盘里永远存着3个不同内核版本的rpm包部署前先ls /boot/vmlinuz*再动手——这招省下的排错时间够你喝两杯咖啡。希望帮到你。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
