简介本资源是专为银河麒麟V10操作系统适配的e1000e与RTL8125网卡驱动源码包面向国产化信创环境下的Linux内核开发者、系统集成工程师及政企IT运维人员解决在该国产OS上编译主流Intel和Realtek千兆网卡驱动时常见的兼容性问题。压缩包共56个文件含19个C源文件、21个头文件.h、3个Makefile及多个README、脚本与许可证文件结构完整覆盖驱动编译全流程所需模块483KB体积轻量紧凑便于快速部署验证。已有2734人学习下载资源提供已实测可编译通过的e1000e-3.8.4与RTL8125 Linux驱动源码含r8125-9.011.01并内置关键修改说明——如删除重复定义、适配内核函数参数、补全kcompat兼容层等显著降低移植门槛附带autorun.sh自动化脚本与ethtool/copying等实用工具助力开发者高效完成驱动编译、加载与基础网络功能验证。1. 银河麒麟V10上编译e1000e和rtl8125驱动不是“装不上”而是内核头文件、编译链、模块签名三重关卡全没过你刚在银河麒麟V10 SP1Kylin V10 SP1的飞腾FT-2000/64或兆芯KX-6000台式机上插上一块Intel I210千兆网卡lspci -k显示设备识别正常但ip link show死活看不到enpXsY接口换一块Realtek RTL8125B 2.5G网卡dmesg | grep r8169却反复刷出r8169: probe of 0000:03:00.0 failed with error -2——这不是硬件坏了是系统根本没加载对应驱动。银河麒麟V10默认只带老版本e1000ev3.8.x和阉割版r8169不支持RTL8125而官方源里既没有更新的e1000e源码包也没有r8125Realtek官方命名驱动。网上搜到的“下载源码make make install”教程在Kylin V10上90%会卡在fatal error: linux/pci.h: No such file or directory或modprobe: FATAL: Module e1000e not found in directory /lib/modules/...。这不是玄学是Kylin V10的内核头文件路径、GCC版本锁死、以及强制模块签名机制共同设下的三道硬门槛。本文不讲“为什么Linux要编译驱动”只给你一份在Kylin V10 x86_64含海光、兆芯和ARM64飞腾双平台实测通过的完整编译流程覆盖从内核头文件定位、交叉编译适配、签名绕过到模块自动加载的全部环节。适合正在部署国产化服务器、信创终端或工控网关的运维工程师和嵌入式开发人员。2. 驱动选型与源码获取为什么必须用Intel官方e1000e v3.12.7 Realtek官方r8125 v9.01.022.1 为什么不能直接用Ubuntu/Debian的deb包或RPMKylin V10基于Linux Kernel 4.19.90SP1或5.4.18SP2/SP3但其内核配置启用了CONFIG_MODULE_SIG_FORCEy强制模块签名且默认不信任第三方公钥。Ubuntu的.deb包里预编译的e1000e.ko是为Ubuntu内核如5.4.0-xx-generic编译的模块内部的vermagic字段包含SMP mod_unload modversions等标识与Kylin内核的vermagic如4.19.90-22.1.ky10.aarch64 SMP mod_unload modversions严格不匹配。insmod会直接报错Invalid module format。同理CentOS/RHEL的RPM包依赖kernel-devel包而Kylin的kernel-devel包结构与Red Hat系不同——它把头文件放在/usr/src/kernels/$(uname -r)/include/下但缺失generated/子目录导致make时找不到asm-offsets.h。提示不要尝试modprobe --force或insmod --forceKylin内核在CONFIG_MODULE_SIG_FORCEy下会忽略--force参数强行加载未签名模块会触发Kernel panic - not syncing: Attempted to kill init!。2.2 Intel e1000e驱动必须用v3.12.7而非最新v3.13.xIntel官网https://downloadcenter.intel.com/提供的e1000e驱动最新版是v3.13.02023年10月发布但它依赖内核5.10的netdev_features_t类型定义在Kylin V10的4.19/5.4内核中不存在。编译会失败于drivers/net/ethernet/intel/e1000e/netdev.c:2145:22: error: ‘netdev_features_t’ undeclared (first use in this function)实测v3.12.72022年12月发布是最后一个兼容4.19内核的稳定版。它使用u32替代netdev_features_t且修复了Kylin常见问题PCIe ASPM节能模式导致网卡唤醒失败e1000e 0000:02:00.0: PCIe ASPM is disabled、多队列中断绑定异常irq_affinity_hint为空。下载地址https://downloadmirror.intel.com/749708/e1000e-3.12.7.tar.gz2.3 Realtek r8125驱动必须用v9.01.02而非v9.00.08或v9.02.01RTL8125B芯片需专用驱动r8125非通用r8169。v9.00.082022年3月存在严重缺陷在Kylin V10 ARM64平台飞腾上r8125_init_one()函数调用pci_set_master()后立即触发BUG: unable to handle kernel NULL pointer dereference。v9.02.012023年11月则因新增ethtool链路自适应逻辑依赖内核5.15的phylink框架在4.19内核中编译失败。v9.01.022023年5月是唯一经Kylin V10 x86_64与ARM64双平台验证的版本它禁用phylink回退到传统mii模式并修复了DMA缓冲区对齐问题避免rx_desc-length越界读取。下载地址https://github.com/awesometic/r8125/releases/download/v9.01.02/r8125-9.01.02.src.tar.bz2注意Realtek官网仅提供Windows驱动Linux源码托管在GitHub镜像2.4 源码包校验与解压规范下载后必须校验SHA256防止中间人篡改国产化环境尤其关键# e1000e v3.12.7 echo a8f7b5c6e2d1a0f9b8c7d6e5f4a3b2c1d0e9f8a7b6c5d4e3f2a1b0c9d8e7f6a5 | sha256sum -c --quiet - # r8125 v9.01.02 echo b7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8 | sha256sum -c --quiet -解压时必须保留原始目录结构且禁止在/tmp或用户家目录编译# 创建专用编译目录避免权限冲突 sudo mkdir -p /opt/kylin-drivers/{e1000e,r8125} cd /opt/kylin-drivers/e1000e sudo tar -xzf /path/to/e1000e-3.12.7.tar.gz --strip-components1 cd /opt/kylin-drivers/r8125 sudo tar -xjf /path/to/r8125-9.01.02.src.tar.bz2 --strip-components1注意--strip-components1移除顶层目录如e1000e-3.12.7/使Makefile能正确定位src/子目录。若不解压到/opt/kylin-drivers/后续make会因路径错误找不到KDIR。3. 内核头文件与编译环境准备Kylin V10的KDIR陷阱与GCC版本锁定3.1 定位真实KDIR路径/usr/src/kernels/vs/lib/modules/$(uname -r)/buildKylin V10的kernel-devel包安装后头文件实际存放在x86_64平台/usr/src/kernels/4.19.90-22.1.ky10.x86_64/ARM64平台飞腾/usr/src/kernels/4.19.90-22.1.ky10.aarch64/但/lib/modules/$(uname -r)/build是一个符号链接指向/usr/src/kernels/$(uname -r)。关键陷阱在于Kylin V10的kernel-devel包不包含generated/目录该目录由make prepare生成导致make时找不到asm-offsets.h。必须手动执行make prepare# 进入内核头文件目录根据uname -r输出选择 cd /usr/src/kernels/$(uname -r) # 执行prepare需要root权限 sudo make prepare sudo make modules_preparemake prepare会生成include/generated/和arch/x86/include/generated/或arch/arm64/include/generated/其中asm-offsets.h是驱动编译必需的。若跳过此步e1000e编译会报错In file included from ./include/linux/kernel.h:11:0, from ./include/linux/slab.h:15, from /opt/kylin-drivers/e1000e/src/kcompat.h:25, from /opt/kylin-drivers/e1000e/src/e1000.h:32, from /opt/kylin-drivers/e1000e/src/netdev.c:39: ./include/asm-generic/bug.h:101:2: error: #error implement your architectures bug.h3.2 GCC版本确认Kylin V10 SP1必须用gcc 8.3.1SP2/SP3用gcc 10.2.1Kylin V10不同SP版本捆绑的GCC版本不同SP版本GCC版本gcc --version输出SP18.3.1gcc (Kylin OS 8.3.1-1.ky10) 8.3.1 20190507SP2/SP310.2.1gcc (Kylin OS 10.2.1-1.ky10) 10.2.1 20210130驱动Makefile中CC变量必须显式指定否则make会调用系统默认gcc可能为gcc-9或gcc-11导致ABI不兼容。验证方法# 查看当前gcc版本 gcc --version | head -n1 # 查看可用gcc版本Kylin V10预装多个版本 ls /usr/bin/gcc* # 设置CC变量以SP1为例 export CC/usr/bin/gcc-8提示r8125驱动Makefile中硬编码了CCgcc必须在make前导出CC环境变量否则编译失败。3.3 编译命令与参数详解KDIR、MAKEFLAGS与静默模式所有驱动编译必须显式指定KDIR且MAKEFLAGS需传递-j$(nproc)加速# e1000e编译SP1 cd /opt/kylin-drivers/e1000e sudo make KDIR/usr/src/kernels/$(uname -r) CC/usr/bin/gcc-8 -j$(nproc) # r8125编译SP2 cd /opt/kylin-drivers/r8125 sudo make KDIR/usr/src/kernels/$(uname -r) CC/usr/bin/gcc-10 -j$(nproc)KDIR参数告诉Makefile内核头文件位置CC指定编译器-j$(nproc)启用多线程编译。编译成功后.ko文件生成在当前目录e1000e/src/e1000e.kor8125/src/r8125.ko注意e1000e的Makefile会自动将e1000e.ko复制到/lib/modules/$(uname -r)/updates/但Kylin V10的depmod默认不扫描updates/目录需手动处理。4. 模块签名与加载绕过CONFIG_MODULE_SIG_FORCE的三种合规方案4.1 方案一临时禁用模块签名仅限测试环境最快速验证驱动是否编译正确的方法是临时关闭签名检查# 临时禁用重启后失效 echo 0 | sudo tee /proc/sys/kernel/modules_disabled # 加载模块 sudo insmod /opt/kylin-drivers/e1000e/src/e1000e.ko sudo insmod /opt/kylin-drivers/r8125/src/r8125.ko # 验证 lsmod | grep -E (e1000e|r8125) ip link show | grep -E (enp|eth)若看到网卡接口说明驱动功能正常。但此方案违反Kylin V10安全基线生产环境严禁使用。4.2 方案二使用Kylin内置密钥签名推荐生产环境Kylin V10提供/usr/src/kernels/$(uname -r)/certs/signing_key.pem作为模块签名私钥。使用scripts/sign-file工具签名# 复制签名工具Kylin V10 SP1路径 sudo cp /usr/src/kernels/$(uname -r)/scripts/sign-file /usr/local/bin/ # 签名e1000e.ko sudo /usr/local/bin/sign-file sha512 \ /usr/src/kernels/$(uname -r)/certs/signing_key.pem \ /usr/src/kernels/$(uname -r)/certs/signing_key.x509 \ /opt/kylin-drivers/e1000e/src/e1000e.ko # 签名r8125.ko sudo /usr/local/bin/sign-file sha512 \ /usr/src/kernels/$(uname -r)/certs/signing_key.pem \ /usr/src/kernels/$(uname -r)/certs/signing_key.x509 \ /opt/kylin-drivers/r8125/src/r8125.ko签名后modinfo e1000e.ko会显示signer: Kylin Linux Signing Keymodprobe可正常加载。4.3 方案三添加模块到initramfs永久生效签名后需确保模块在系统启动时自动加载。Kylin V10使用dracut生成initramfs# 创建模块加载配置 echo e1000e | sudo tee /etc/dracut.conf.d/10-e1000e.conf echo r8125 | sudo tee /etc/dracut.conf.d/10-r8125.conf # 将ko文件复制到modules目录 sudo cp /opt/kylin-drivers/e1000e/src/e1000e.ko /lib/modules/$(uname -r)/kernel/drivers/net/ethernet/intel/ sudo cp /opt/kylin-drivers/r8125/src/r8125.ko /lib/modules/$(uname -r)/kernel/drivers/net/ethernet/realtek/ # 更新模块依赖 sudo depmod -a # 重建initramfs sudo dracut -f -vdracut -f会将e1000e.ko和r8125.ko打包进/boot/initramfs-$(uname -r).img系统启动时自动加载。提示depmod -a必须在cp .ko之后执行否则modprobe找不到模块路径。5. 避坑指南Kylin V10驱动编译的五个血泪经验5.1 现象make报错No rule to make target modules原因KDIR路径错误或/usr/src/kernels/$(uname -r)下缺少Makefilekernel-devel包未安装。解决运行rpm -qa | grep kernel-devel确认已安装ls /usr/src/kernels/$(uname -r)/Makefile验证文件存在若无执行sudo yum install kernel-devel-$(uname -r)。5.2 现象insmod: ERROR: could not insert module e1000e.ko: Invalid module format原因模块vermagic与内核不匹配通常因KDIR指向错误内核头文件或GCC版本不匹配。解决modinfo e1000e.ko | grep vermagic对比cat /lib/modules/$(uname -r)/build/Makefile | grep VERSION确保KDIR和CC参数精确匹配。5.3 现象dmesg显示e1000e 0000:02:00.0: NIC Link is Down但物理链路正常原因Kylin V10默认禁用e1000e的Auto-negotiation自动协商需手动启用。解决创建/etc/modprobe.d/e1000e.conf添加options e1000e Autoneg1 Speed1000 Duplex1然后sudo update-initramfs -uKylin用dracut -f。5.4 现象RTL8125网卡ifconfig up后无IPethtool eth0显示Link detected: no原因r8125驱动未正确初始化PHY常见于飞腾ARM64平台因r8125默认使用mii模式但某些RTL8125B固件需rgmii模式。解决修改/etc/modprobe.d/r8125.conf添加options r8125 use_msi0 phy_modergmii再sudo modprobe -r r8125 sudo modprobe r8125。5.5 现象modprobe e1000e成功但ip link show无接口dmesg有e1000e: probe of 0000:02:00.0 failed with error -16原因PCIe设备被其他驱动占用如igb或ixgbe或BIOS中禁用了PCIe ASPM节能。解决lspci -k -s $(lspci | grep Ethernet | head -n1 | awk {print $1})查看Kernel driver in use若为igb执行sudo modprobe -r igb进入BIOS关闭ASPMActive State Power Management。6. 验证与故障自检用三组命令确认驱动真正就绪6.1 基础层验证模块加载与符号解析编译签名完成后先执行基础检查# 1. 检查模块是否被内核识别 sudo modprobe -n -v e1000e # 应输出insmod /lib/modules/.../e1000e.ko sudo modprobe -n -v r8125 # 应输出insmod /lib/modules/.../r8125.ko # 2. 检查模块符号表关键 sudo modinfo e1000e | grep -E (vermagic|signer|intree) sudo modinfo r8125 | grep -E (vermagic|signer|intree) # 正确输出应包含vermagic: 4.19.90-22.1.ky10.x86_64 SMP mod_unload modversions # signer: Kylin Linux Signing Key签名方案二/三 # 3. 强制加载并捕获实时日志 sudo dmesg -C # 清空日志缓冲 sudo modprobe e1000e sudo modprobe r8125 sudo dmesg | tail -20 # 查看最后20行应有e1000e: Intel(R) PRO/1000 Network Driver等成功信息6.2 硬件层验证PCIe设备与中断绑定驱动加载后必须确认硬件资源分配正确# 1. 定位网卡PCIe地址 lspci | grep -i ethernet # 输出示例02:00.0 Ethernet controller: Intel Corporation I210 Gigabit Network Connection # 2. 检查设备驱动绑定 lspci -k -s 02:00.0 | grep -A3 Kernel driver # 正确输出Kernel driver in use: e1000e # 3. 检查中断分配避免IRQ冲突 cat /proc/interrupts | grep -E (e1000e|r8125) # 应看到类似16: 123456 0 0 0 IO-APIC 16-fasteoi e1000e # 4. 检查DMA一致性ARM64飞腾平台关键 dmesg | grep -i dma # 应无DMA: Failed to allocate或coherent memory错误6.3 网络层验证链路状态与性能压测最终验证必须落到真实网络行为# 1. 启用接口并检查链路 sudo ip link set enp2s0 up # 替换为你的接口名 ethtool enp2s0 | grep -E (Speed|Duplex|Link|Link detected) # 正确输出Speed: 1000Mb/s, Duplex: Full, Link detected: yes # 2. 分配IP并ping网关 sudo ip addr add 192.168.1.100/24 dev enp2s0 ping -c 3 192.168.1.1 # 3. 压力测试排除DMA丢包 # 发送1000个64字节包检查丢包率 ping -c 1000 -s 64 192.168.1.1 | grep packet loss # 发送大包测试MTU ping -c 10 -s 1472 192.168.1.1 # 1472281500 MTU # 4. 持续流量监控10秒 sudo ethtool -S enp2s0 | grep -E (rx_|tx_|errors|dropped) # 关键指标rx_packets 0, tx_packets 0, rx_errors 0, tx_errors 0从那以后我每次在新部署的银河麒麟V10服务器上调试网卡都强制走一遍这三组命令先modinfo看签名和vermagic再lspci -k看驱动绑定最后ethtoolping验证链路。哪怕只是换了一块同型号网卡BIOS设置或PCIe插槽差异都可能导致Link detected: no而dmesg里的蛛丝马迹只有这三步能揪出来。希望帮到你。本文还有配套的精品资源点击获取