简介面向Ubuntu系统开发者和需要安装Realtek千兆网卡驱动的用户这份离线资源包集中提供了编译工具链的deb软件包及网卡驱动源码特别适合在没有外网或内网受限的环境中完成工具部署与驱动安装。包内共四十二个文件其中二十三个deb安装包涵盖编译器、Make构建工具、C编译器以及基础开发库构成完整的离线依赖集合另有八个头文件、六个C源文件、两个Makefile文件、一个Shell自动安装脚本和一个Readme说明文件对应驱动编译与加载流程压缩包整体约三十兆字节结构清晰。目前已有三千七百六十七人学习下载反映出该资源在解决Realtek网卡离线安装问题上的实用价值。对于服务器维护或需要快速复现编译流程的工程师拿到这份资源后可直接解压使用免去逐一下载依赖的繁琐同时通过查看各软件包的版本与依赖关系也能加深对Ubuntu包管理机制和驱动加载原理的理解。1. r8125离线安装包真正卡住你的往往不是驱动而是编译环境给一台断外网的 Ubuntu 服务器调试 Realtek RTL8125 2.5G 网卡圈内人都知道一个反直觉结论r8125 驱动本身并不难装真正把人卡到深夜的是它前面那一串编译依赖。系统里没有 gccapt 源连不出去build-essential 这个元包带着一长串依赖linux-headers 没装导致 Makefile 直接报错最后连报错都看不懂。这个标题解决的就是这个场景在没有外网的环境里把 gcc、make、build-essential、内核头文件和 r8125 驱动源码一起打包带进去离线把 2.5G 网卡跑起来。适合内网机房、离线部署、嵌入式开发和长期断网的产线环境也适合那些机器能上网但网卡驱动装不上、才意识到鸡生蛋蛋生鸡的人。2. 先理清依赖头绪gcc、make、build-essential 和内核头文件到底要哪些离线安装最怕的不是下载而是不知道自己缺什么。一上来就单独装 gcc 是新手最常见的选择但它解决不了 r8125 编译的全部需求。多数发行版里编译 r8125 需要的不是一个 gcc而是从编译器到内核头文件的一整套链路gcc 负责把驱动 C 代码编成目标码make 负责按 Makefile 组织整个编译流程内核头文件为模块代码提供内核 API 声明build-essential 则负责把前面这些默认组件一次性装齐。把这层关系理顺离线包才打得准否则到了目标机上还是会一趟趟补包。2.1 为什么离线环境里首选 build-essential而不是单独装 gccbuild-essential 是 Debian/Ubuntu 系的一个元包它本身实体文件很少作用是把编译 C/C 程序最常见的工具链一口气拉进来gcc、g、make、dpkg-dev、libc6-dev、libstdc 开发头文件以及它们各自依赖的 cpp、binutils 等底层工具。单独装 gcc 时系统可能仍然缺 g 和 dpkg-dev而 r8125 驱动虽然主要是 C 代码编译脚本里却经常间接调用到这些工具少一个就会在某个环节莫名其妙中断。另一个现实理由是依赖匹配build-essential 里的各组件版本被发行版整体测试过互相配合没有问题。自己手工一个个挑版本很容易出现新 gcc 编老内核模块时语法不兼容、make 版本过旧不认识新 Makefile 语法这类玄学问题。CentOS/RHEL 系机器上对应的是 Development Tools 组包用 yum groupinstall 或 dnf groupinstall 安装如果你在 CentOS 7.9 上踩过装 gcc 的坑可以理解 build-essential 就是 Ubuntu 阵营的同一套东西。离线准备时不只下载 gcc 一个包而是把 build-essential 整个依赖树收齐才是稳的。2.2 r8125 源码编译还缺一类隐藏依赖内核头文件r8125 编译出来的是内核模块也就是 .ko 文件不是普通应用程序。模块代码里大量引用内核内部 API这些声明和实现不在 libc 里而在 linux-headers 包提供的 /usr/src/linux-headers-$(uname -r) 目录里。工具链装好之后如果跳过这一步make 时大概率报“kernel header files not in any of these directories”也就是内核头文件缺失或路径没对上。这里必须先用 uname -r 看内核版本再让 linux-headers 的版本与内核版本严格一致。内核 5.15 的机器去装 5.19 的 headers目录对不上make 照样失败差一个小版本都不行。另外要留意 libc6-dev 和 pkg-config 这类包驱动编译脚本有时会调用 pkg-config 检测某些库是否存在缺失时不直接报错但生成的 Makefile 参数会变最后表现出“编译出来但 insmod 失败”的诡异现象。离线打依赖包时把 libc6-dev、pkg-config、dpkg-dev 一并带上成本最低它们体积都不大。2.3 版本核对r8125 源码、内核与 gcc 三者的版本搭配版本不匹配是离线编译里最隐蔽的坑。先执行 uname -r 拿到目标机内核版本比如 5.15.0-91-generic再通过 cat /etc/os-release 确认发行版版本决定去下载哪一版 linux-headers。另一个容易忽略的是 gcc 版本Ubuntu 20.04 默认 gcc 9Ubuntu 22.04 默认 gcc 11Ubuntu 24.04 默认 gcc 13。新旧 gcc 对内核模块语法的接收度不同老驱动在 gcc 9.3.0 上是稳定组合换到新 gcc 上可能满屏报错。我的习惯是先记录一个三元组内核版本、gcc 版本、r8125 驱动版本把它写进离线包的 README 里比什么都保险。实际工作中经常遇到同事从网上随手扒一个 r8125 源码包目标机内核是 6.x源码还是两三年前的版本编译时一堆 API 不兼容。这类问题不是调配置能解决的最省事的路径是换新版源码包而不是去改内核头文件。所以准备离线包的第一步不是下载 deb而是先把这三个版本号定下来后面能少走一半弯路。3. 在联网机器上准备离线依赖包三条可复现的路径离线安装依赖最稳妥的生产习惯是准备一台与目标机相同发行版、相同架构、相同版本、甚至相同内核版本的联网机器把 deb 包一次性拉下来。为什么强调相同版本Ubuntu 22.04 的 libc6 和 24.04 的 libc6 不兼容硬装会破坏 dpkg 数据库后患无穷。拿连接机器做离线包前先核一遍下面这张表核对项要求原因发行版版本完全一致deb 依赖的库版本不同强行安装会破坏依赖关系内核版本完全一致linux-headers 按内核版本分目录安装CPU 架构一致deb 区分 amd64、arm64、i386 等架构gcc 版本尽量一致驱动源码在不同 gcc 下编译行为不同3.1 路径一apt-get install --download-only 批量收集依赖这是最快、最不容易漏依赖的方法也是我日常用得最多的。在联网机器上执行sudo apt-get update sudo apt-get install --download-only build-essential linux-headers-$(uname -r) -y mkdir -p ~/offline-debs cp /var/cache/apt/archives/*.deb ~/offline-debs/--download-only 只下载不安装下载后的 deb 全部落在 /var/cache/apt/archives 目录里。cp 这一步把本次拉下来的所有包收拢到 ~/offline-debs之后整个目录拷到 U 盘或直接分发到目标机。注意执行前先 uname -r 核对下载机和目标机的内核版本必须一致否则 linux-headers 白下载到目标机上还是编不了内核模块。这个方式最省心的地方是 apt 会自行解析 build-essential 的所有依赖不用手工数依赖树十几到几十个 deb 一次拿全总大小一般在数百 MB 量级。如果下载机配的软件源连起来网速过慢先把 sources.list 里的 mirror 换成国内源再执行中途中断也不要慌重新跑一遍 update 和 install --download-onlyapt 会续传未完成的 deb。3.2 路径二dpkg-repack 从已装好的机器打包如果手头已经有一台装好完整编译环境、且与目标机同版本的系统可以用 dpkg-repack 把已安装的包重新封装成 deb。这个方式的好处是所见即所得打包出来的 deb 和已经跑着的环境完全同版本不会出现镜像源版本漂移的问题。执行sudo apt-get install -y dpkg-repack dpkg-repack gcc make build-essential linux-headers-$(uname -r) libc6-dev dpkg-devdpkg-repack 后面可以接多个包名它会在当前目录下为每个已安装包生成一个 deb。这条路径适合的场景是有一台配置完好的“样板机”想快速复刻到另一台同版本机器上而不是从源站逐个拉包。相比 apt-get download它对网络要求更低但前提是那台样板机的环境必须干净、没有手工乱改过依赖。3.3 路径三把 deb 集合做成本地 apt 源解决依赖顺序问题拿到一堆 deb 后简单粗暴执行 sudo dpkg -i *.deb 经常会因为依赖顺序问题报错build-essential 依赖 gccgcc 又依赖 libc6-dev而 libc6-dev 又被 dpkg-dev 依赖形成网状循环。我一般不会去手工排列安装顺序而是把 deb 目录做成一个本地源让 apt 自己解析依赖顺序cd ~/offline-debs dpkg-scanpackages . /dev/null | gzip Packages.gzdpkg-scanpackages 来自 dpkg-dev 包如果在联网机上已经装了 build-essential通常它就在系统里没有的话先 apt-get install dpkg-dev。扫描目录后生成的 Packages.gz 就是这个本地源的索引文件。把整个目录拷到目标机 /opt/offline-debs然后添加源echo deb [trustedyes] file:///opt/offline-debs ./ | sudo tee /etc/apt/sources.list.d/local.list sudo apt-get update sudo apt-get install -y build-essential linux-headers-$(uname -r)最后一条命令让 apt 从本地源里解析 build-essential 和 linux-headers 的完整依赖树并安装。这里有几个关键细节echo 里的 URL 是 file:///opt/offline-debs三个斜杠漏一个就找不到源[trustedyes] 表示跳过 Release 签名校验离线源没有签名文件不加这个属性 update 时会反复提示仓库没有 Release 文件虽然也能装但报错干扰判断。3.4 清理与恢复本地源用完要记得移出离线源只是临时手段安装完成后如果留着不管后面这台机器一旦重新联网apt 会同时去请求一个已经不存在的本地目录每次 update 都报错。我一般在 /etc/apt/sources.list.d/ 下为离线源单独建文件而不是去改主 sources.list这样事后删除干净。如果目标机原本配置了外网源但内网不可达apt-get update 会长时间卡在超时上可以临时把超时时间调短sudo apt-get -o Acquire::http::Timeout5 update或者直接把外网源注释掉装完再改回来。离线装 Ubuntu gcc 令人印象深刻的失败多数都发生在依赖没收干净或者源配置互相干扰这一步值得多花几分钟把源隔离好。4. 离线编译 r8125 网卡驱动从解压源码到 modprobe 全套命令依赖装好后真正的驱动编译反而简单。r8125 是 Realtek 官方提供的 RTL8125 2.5G 网卡驱动源码包通常是 tar.bz2 或 tar.xz 压缩包里面有 Makefile、src 目录和 autorun.sh 脚本编译目标就是生成能加载进内核的 r8125.ko 模块。动手前先确认网卡确实被系统识别同时看清当前是谁把它绑走了。4.1 先用 lspci 和 ethtool 确认网卡型号与当前驱动归属许多 RTL8125 芯片会被系统自带的 r8169 驱动自动接管这也是新手最容易懵的地方明明驱动装好了lsmod 里也看到 r8125但网卡完全不工作。原因多半是设备早被 r8169 占住r8125 没有绑定机会。先看现状lspci -nn | grep -i realtek ethtool -i enp3s0ethtool -i 输出里的 driver 字段会告诉当前网卡用哪个驱动。如果显示 r8169说明内核通用驱动抢先绑定了这块 Realtek 2.5G 网卡。r8169 不是不能用但它对 RTL8125 的省电、流控和速率协商支持不完整跑 2.5G 时常出现协商不准或速度上不去这也是大家宁可麻烦也要换官方 r8125 驱动的原因。执行 lspci 时注意看设备 ID 是否落在 RTL8125 的范围里有些螃蟹网卡型号接近但走的完全不是同一套驱动装 r8125 没用。4.2 编译安装的最小命令序列与参数含义拿到 r8125 源码包后推荐解压到 /usr/src/r8125-版本号 这类稳定路径。这里有个细节不要在压缩包没解压的目录里直接 make也不要把 Windows 上解压好的目录直接拷过来编行尾符和文件权限都会出问题。最稳妥的一套命令sudo tar -xf r8125-*.tar.bz2 -C /usr/src cd /usr/src/r8125-*/ sudo make clean sudo make KSRC/lib/modules/$(uname -r)/build sudo make KSRC/lib/modules/$(uname -r)/build installmake clean 是为了清掉可能残留的历史编译产物。源码包如果之前在其他内核上编过残留的 .o 和 .ko 会让模块带上旧版本信息加载时报 invalid module format这是很典型的内核模块翻车现场。KSRC 是指向内核头文件目录的变量/lib/modules/$(uname -r)/build 是软链接实际指向 /usr/src/linux-headers-$(uname -r)。显式写这个变量能把路径牢牢固定住避免系统里存在多套内核头文件时选错。install 目标会把编译好的 r8125.ko 拷进 /lib/modules/$(uname -r)/kernel/drivers/net/ethernet/realtek/并更新模块依赖关系。如果只想先编译看结果执行到 make KSRC... 就好模块会落在 src/r8125.ko。官方包的 autorun.sh 本质上就是 make clean、make、install、modprobe 一条龙但离线环境我建议手动分步执行报错时才能判断到底是哪一步挂的。4.3 切换驱动r8169 与 r8125 的设备占用与黑名单编译安装完成后直接 sudo modprobe r8125 往往不够因为 r8169 还占着设备。需要先把 r8169 从内核卸载再让 r8125 绑定sudo modprobe -r r8169 sudo modprobe r8125这两条命令执行期间网卡会短暂消失SSH 连接会立刻断开所以务必通过服务器本地控制台或带外管理IPMI/iDRAC操作。如果通过 SSH 远程执行切驱动瞬间连接就断了人就被锁在门外。等 r8125 加载后再执行 ethtool -i 网卡接口名driver 字段应该变成 r8125。为避免下次重启时 r8169 又把设备抢回去把它加入黑名单echo blacklist r8169 | sudo tee /etc/modprobe.d/blacklist-r8169.conf sudo update-initramfs -uupdate-initramfs 会把黑名单写进 initramfs防止引导阶段就加载 r8169。如果之后想回滚到内核自带的 r8169删掉这个配置文件并重新生成 initramfs再 modprobe r8169 就行。内核自带驱动的模块文件始终在系统里不会被覆盖这条回滚路径是离线服务器上最实用的后悔药。5. 避坑实录离线安装 r8125 的 5 个典型翻车现场5.1 gcc 明明装好了gcc --version 还是旧版本现象用离线源装完新 gcc执行 gcc --version 发现版本没变或者编译时用的还是旧编译器。原因系统里同时存在多个 gcc/usr/bin/gcc 是 alternatives 机制的软链接指向旧版本另一种常见的可能是用户目录 ~/.local/bin 或 /usr/local/bin 里存在自定义 gccPATH 环境变量优先命中了它们。解决先 which gcc 看命中路径再用 update-alternatives 切换which gcc ls -l /usr/bin/gcc sudo update-alternatives --config gcc如果驱动 Makefile 里写死了编译器名还可以用 make CC/usr/bin/gcc-12 直接指定不用动系统全局默认值。这个坑的本质是软链接和目标文件的关系没理清很多“升级 gcc 后还是旧版本”的搜索结果都栽在这里。5.2 make 报错“没有指明目标并且找不到 makefile”现象进入源码目录执行 make立刻报 make: *** No rule to make target...看起来像是 Makefile 不存在。原因常见四种。一是没解压在 .tar.bz2 所在目录里就直接 make二是解压后源码实际在 src 子目录里人还在外层三是从 Windows 拷贝过来文件权限或换行符损坏导致 Makefile 无法被解析四是源码来自 GitHub 仓库而非官方 tar 包需要先跑 autogen.sh 生成 configure 和 Makefile。解决先看当前目录里到底有什么ls -l | grep Makefile find . -name Makefile -maxdepth 2确认 Makefile 存在且文件权限正常再执行 make。官方 tar 包一般自带 Makefile不需要自动生成如果是从仓库克隆的就按 README 的说明先执行 autogen.sh。另外要留意如果报错里带了 makefile:xx 的行号说明 Makefile 是被正确读取的真正的编译失败发生在 gcc 阶段要去更早的日志里找 C 编译器的报错而不是盯着 make 的 exit 1。5.3 报错 kernel header files not in any现象make 过程中出现“*** kernel header files not in any of these directories”停在这个错误上不再继续。原因linux-headers-$(uname -r) 没装或机器上装了多个内核版本当前启动的不是最新那个头文件路径和 uname -r 对不上。Kbuild 需要读取内核头文件里的生成文件来编译模块这条路断了后面全断。解决逐项确认uname -r ls -d /usr/src/linux-headers-$(uname -r) ls -l /lib/modules/$(uname -r)/build如果 /usr/src 下没有对应目录回到第 3 章用本地源补装 linux-headers-$(uname -r)。如果 headers 目录存在但 /lib/modules/$(uname -r)/build 软链接损坏手动重建sudo ln -s /usr/src/linux-headers-$(uname -r) /lib/modules/$(uname -r)/build这里最容易忽视的是重启后内核版本变了离线包是按旧内核准备的机器重启进新内核后 uname -r 变了头文件目录还是旧的模块编译就会失败。所以离线装驱动时要先确认这台机器最终会稳定在哪个内核版本上再按那个版本准备 headers。5.4 dpkg -i *.deb 一个接一个依赖报错现象把离线 deb 包拷贝到目标机执行 sudo dpkg -i *.deb报一堆依赖不满足手工调整安装顺序还是不行。原因不带索引的 dpkg -i 不会自动解析依赖顺序而 build-essential 这类工具链包存在网状依赖关系。同时如果 deb 来源混杂了不同发行版版本的包dpkg 会陷入永远修不完的依赖循环。解决不要 dpkg -i *.deb改用 3.3 节的本地源方式让 apt 自己解析依赖顺序。如果已经把部分包装进去了系统处于半破损状态执行 sudo apt-get -f install 修复。离线下最忌讳反复用 dpkg --force-depends 强装最后 dpkg 数据库损坏还得手工恢复 /var/lib/dpkg/status那时就真的无力回天了。5.5 驱动装上后接口名变了或网卡没起来现象modprobe r8125 后原来的 enp3s0 变成 enp3s0s0或者 ip link 里根本看不到网卡接口。原因切换驱动后设备重新被 probe内核按 PCIe 位置重新生成接口名部分系统还会因为 udev 规则把新设备识别成全新接口原有 IP 配置全部失效。解决切换后用 ip link 查看当前实际接口名把原 IP 配置迁移到新接口上涉及 Netplan 或 /etc/network/interfaces 的都要同步改ip link cat /etc/udev/rules.d/70-persistent-net.rules如果接口名频繁漂移最稳定的做法是按网卡 MAC 写 udev 规则锁定接口名。不要依赖 eth0 这种老式命名在 systemd 环境下每次驱动切换都可能变。操作顺序上先改配置再切驱动比切完再手忙脚乱找接口靠谱得多。6. 验证与固化的收尾操作编译日志、DKMS 和速率测试编译过程建议把输出落到文件里再排查不要靠终端滚动屏翻历史。我一般这么执行sudo make KSRC/lib/modules/$(uname -r)/build 21 | tee /tmp/r8125_make.log21 把标准错误也并入标准输出tee 同时写文件和打到屏幕报错时直接查 /tmp/r8125_make.log搜索 error 或 warning 比人工翻屏高效得多。驱动装好只是第一步下一次内核更新会让 /lib/modules 下对应版本的模块目录失效r8125 没有注册进 DKMS 的话升级内核后又得手动编译一遍。用 DKMS 注册很简单源码包里如果自带 dkms.conf直接执行 dkms add没有就手写一份放在源码根目录典型的 dkms.conf 长这样PACKAGE_NAMEr8125 PACKAGE_VERSION填写你下载到的版本号 BUILT_MODULE_NAME[0]r8125 DEST_MODULE_LOCATION[0]/kernel/drivers/net/ethernet/realtek AUTOINSTALLyes然后执行注册、编译、安装三步sudo dkms add /usr/src/r8125-填写实际目录名 sudo dkms build -m r8125 -v 填写实际版本号 sudo dkms install -m r8125 -v 填写实际版本号注册后内核升级时DKMS 会在新内核上自动重编这个模块不用再手工介入这是离线环境下最值得做的固化步骤。最后验证实际速率ethtool 网卡名查看 Speed 是否为 2500Mb/s再配合 iperf3 双向打流确认吞吐。2.5G 网卡常见的翻车点是协商到 1000Mb/s原因多为网线老化或对端交换机端口不支持这不是驱动问题别在驱动上浪费时间。每台机器装完我都习惯把 uname -r、gcc --version、r8125 版本、DKMS 注册状态记到 /root/install-log.txt 里。下次内核升级或网卡失联时这份记录能直接帮你定位是驱动没了还是配置丢了省掉一大段排查时间。这是我做离线部署多年攒下的习惯希望帮到你。本文还有配套的精品资源点击获取 r8125离线安装包：解决编译依赖与内核头文件匹配难题
简介面向Ubuntu系统开发者和需要安装Realtek千兆网卡驱动的用户这份离线资源包集中提供了编译工具链的deb软件包及网卡驱动源码特别适合在没有外网或内网受限的环境中完成工具部署与驱动安装。包内共四十二个文件其中二十三个deb安装包涵盖编译器、Make构建工具、C编译器以及基础开发库构成完整的离线依赖集合另有八个头文件、六个C源文件、两个Makefile文件、一个Shell自动安装脚本和一个Readme说明文件对应驱动编译与加载流程压缩包整体约三十兆字节结构清晰。目前已有三千七百六十七人学习下载反映出该资源在解决Realtek网卡离线安装问题上的实用价值。对于服务器维护或需要快速复现编译流程的工程师拿到这份资源后可直接解压使用免去逐一下载依赖的繁琐同时通过查看各软件包的版本与依赖关系也能加深对Ubuntu包管理机制和驱动加载原理的理解。1. r8125离线安装包真正卡住你的往往不是驱动而是编译环境给一台断外网的 Ubuntu 服务器调试 Realtek RTL8125 2.5G 网卡圈内人都知道一个反直觉结论r8125 驱动本身并不难装真正把人卡到深夜的是它前面那一串编译依赖。系统里没有 gccapt 源连不出去build-essential 这个元包带着一长串依赖linux-headers 没装导致 Makefile 直接报错最后连报错都看不懂。这个标题解决的就是这个场景在没有外网的环境里把 gcc、make、build-essential、内核头文件和 r8125 驱动源码一起打包带进去离线把 2.5G 网卡跑起来。适合内网机房、离线部署、嵌入式开发和长期断网的产线环境也适合那些机器能上网但网卡驱动装不上、才意识到鸡生蛋蛋生鸡的人。2. 先理清依赖头绪gcc、make、build-essential 和内核头文件到底要哪些离线安装最怕的不是下载而是不知道自己缺什么。一上来就单独装 gcc 是新手最常见的选择但它解决不了 r8125 编译的全部需求。多数发行版里编译 r8125 需要的不是一个 gcc而是从编译器到内核头文件的一整套链路gcc 负责把驱动 C 代码编成目标码make 负责按 Makefile 组织整个编译流程内核头文件为模块代码提供内核 API 声明build-essential 则负责把前面这些默认组件一次性装齐。把这层关系理顺离线包才打得准否则到了目标机上还是会一趟趟补包。2.1 为什么离线环境里首选 build-essential而不是单独装 gccbuild-essential 是 Debian/Ubuntu 系的一个元包它本身实体文件很少作用是把编译 C/C 程序最常见的工具链一口气拉进来gcc、g、make、dpkg-dev、libc6-dev、libstdc 开发头文件以及它们各自依赖的 cpp、binutils 等底层工具。单独装 gcc 时系统可能仍然缺 g 和 dpkg-dev而 r8125 驱动虽然主要是 C 代码编译脚本里却经常间接调用到这些工具少一个就会在某个环节莫名其妙中断。另一个现实理由是依赖匹配build-essential 里的各组件版本被发行版整体测试过互相配合没有问题。自己手工一个个挑版本很容易出现新 gcc 编老内核模块时语法不兼容、make 版本过旧不认识新 Makefile 语法这类玄学问题。CentOS/RHEL 系机器上对应的是 Development Tools 组包用 yum groupinstall 或 dnf groupinstall 安装如果你在 CentOS 7.9 上踩过装 gcc 的坑可以理解 build-essential 就是 Ubuntu 阵营的同一套东西。离线准备时不只下载 gcc 一个包而是把 build-essential 整个依赖树收齐才是稳的。2.2 r8125 源码编译还缺一类隐藏依赖内核头文件r8125 编译出来的是内核模块也就是 .ko 文件不是普通应用程序。模块代码里大量引用内核内部 API这些声明和实现不在 libc 里而在 linux-headers 包提供的 /usr/src/linux-headers-$(uname -r) 目录里。工具链装好之后如果跳过这一步make 时大概率报“kernel header files not in any of these directories”也就是内核头文件缺失或路径没对上。这里必须先用 uname -r 看内核版本再让 linux-headers 的版本与内核版本严格一致。内核 5.15 的机器去装 5.19 的 headers目录对不上make 照样失败差一个小版本都不行。另外要留意 libc6-dev 和 pkg-config 这类包驱动编译脚本有时会调用 pkg-config 检测某些库是否存在缺失时不直接报错但生成的 Makefile 参数会变最后表现出“编译出来但 insmod 失败”的诡异现象。离线打依赖包时把 libc6-dev、pkg-config、dpkg-dev 一并带上成本最低它们体积都不大。2.3 版本核对r8125 源码、内核与 gcc 三者的版本搭配版本不匹配是离线编译里最隐蔽的坑。先执行 uname -r 拿到目标机内核版本比如 5.15.0-91-generic再通过 cat /etc/os-release 确认发行版版本决定去下载哪一版 linux-headers。另一个容易忽略的是 gcc 版本Ubuntu 20.04 默认 gcc 9Ubuntu 22.04 默认 gcc 11Ubuntu 24.04 默认 gcc 13。新旧 gcc 对内核模块语法的接收度不同老驱动在 gcc 9.3.0 上是稳定组合换到新 gcc 上可能满屏报错。我的习惯是先记录一个三元组内核版本、gcc 版本、r8125 驱动版本把它写进离线包的 README 里比什么都保险。实际工作中经常遇到同事从网上随手扒一个 r8125 源码包目标机内核是 6.x源码还是两三年前的版本编译时一堆 API 不兼容。这类问题不是调配置能解决的最省事的路径是换新版源码包而不是去改内核头文件。所以准备离线包的第一步不是下载 deb而是先把这三个版本号定下来后面能少走一半弯路。3. 在联网机器上准备离线依赖包三条可复现的路径离线安装依赖最稳妥的生产习惯是准备一台与目标机相同发行版、相同架构、相同版本、甚至相同内核版本的联网机器把 deb 包一次性拉下来。为什么强调相同版本Ubuntu 22.04 的 libc6 和 24.04 的 libc6 不兼容硬装会破坏 dpkg 数据库后患无穷。拿连接机器做离线包前先核一遍下面这张表核对项要求原因发行版版本完全一致deb 依赖的库版本不同强行安装会破坏依赖关系内核版本完全一致linux-headers 按内核版本分目录安装CPU 架构一致deb 区分 amd64、arm64、i386 等架构gcc 版本尽量一致驱动源码在不同 gcc 下编译行为不同3.1 路径一apt-get install --download-only 批量收集依赖这是最快、最不容易漏依赖的方法也是我日常用得最多的。在联网机器上执行sudo apt-get update sudo apt-get install --download-only build-essential linux-headers-$(uname -r) -y mkdir -p ~/offline-debs cp /var/cache/apt/archives/*.deb ~/offline-debs/--download-only 只下载不安装下载后的 deb 全部落在 /var/cache/apt/archives 目录里。cp 这一步把本次拉下来的所有包收拢到 ~/offline-debs之后整个目录拷到 U 盘或直接分发到目标机。注意执行前先 uname -r 核对下载机和目标机的内核版本必须一致否则 linux-headers 白下载到目标机上还是编不了内核模块。这个方式最省心的地方是 apt 会自行解析 build-essential 的所有依赖不用手工数依赖树十几到几十个 deb 一次拿全总大小一般在数百 MB 量级。如果下载机配的软件源连起来网速过慢先把 sources.list 里的 mirror 换成国内源再执行中途中断也不要慌重新跑一遍 update 和 install --download-onlyapt 会续传未完成的 deb。3.2 路径二dpkg-repack 从已装好的机器打包如果手头已经有一台装好完整编译环境、且与目标机同版本的系统可以用 dpkg-repack 把已安装的包重新封装成 deb。这个方式的好处是所见即所得打包出来的 deb 和已经跑着的环境完全同版本不会出现镜像源版本漂移的问题。执行sudo apt-get install -y dpkg-repack dpkg-repack gcc make build-essential linux-headers-$(uname -r) libc6-dev dpkg-devdpkg-repack 后面可以接多个包名它会在当前目录下为每个已安装包生成一个 deb。这条路径适合的场景是有一台配置完好的“样板机”想快速复刻到另一台同版本机器上而不是从源站逐个拉包。相比 apt-get download它对网络要求更低但前提是那台样板机的环境必须干净、没有手工乱改过依赖。3.3 路径三把 deb 集合做成本地 apt 源解决依赖顺序问题拿到一堆 deb 后简单粗暴执行 sudo dpkg -i *.deb 经常会因为依赖顺序问题报错build-essential 依赖 gccgcc 又依赖 libc6-dev而 libc6-dev 又被 dpkg-dev 依赖形成网状循环。我一般不会去手工排列安装顺序而是把 deb 目录做成一个本地源让 apt 自己解析依赖顺序cd ~/offline-debs dpkg-scanpackages . /dev/null | gzip Packages.gzdpkg-scanpackages 来自 dpkg-dev 包如果在联网机上已经装了 build-essential通常它就在系统里没有的话先 apt-get install dpkg-dev。扫描目录后生成的 Packages.gz 就是这个本地源的索引文件。把整个目录拷到目标机 /opt/offline-debs然后添加源echo deb [trustedyes] file:///opt/offline-debs ./ | sudo tee /etc/apt/sources.list.d/local.list sudo apt-get update sudo apt-get install -y build-essential linux-headers-$(uname -r)最后一条命令让 apt 从本地源里解析 build-essential 和 linux-headers 的完整依赖树并安装。这里有几个关键细节echo 里的 URL 是 file:///opt/offline-debs三个斜杠漏一个就找不到源[trustedyes] 表示跳过 Release 签名校验离线源没有签名文件不加这个属性 update 时会反复提示仓库没有 Release 文件虽然也能装但报错干扰判断。3.4 清理与恢复本地源用完要记得移出离线源只是临时手段安装完成后如果留着不管后面这台机器一旦重新联网apt 会同时去请求一个已经不存在的本地目录每次 update 都报错。我一般在 /etc/apt/sources.list.d/ 下为离线源单独建文件而不是去改主 sources.list这样事后删除干净。如果目标机原本配置了外网源但内网不可达apt-get update 会长时间卡在超时上可以临时把超时时间调短sudo apt-get -o Acquire::http::Timeout5 update或者直接把外网源注释掉装完再改回来。离线装 Ubuntu gcc 令人印象深刻的失败多数都发生在依赖没收干净或者源配置互相干扰这一步值得多花几分钟把源隔离好。4. 离线编译 r8125 网卡驱动从解压源码到 modprobe 全套命令依赖装好后真正的驱动编译反而简单。r8125 是 Realtek 官方提供的 RTL8125 2.5G 网卡驱动源码包通常是 tar.bz2 或 tar.xz 压缩包里面有 Makefile、src 目录和 autorun.sh 脚本编译目标就是生成能加载进内核的 r8125.ko 模块。动手前先确认网卡确实被系统识别同时看清当前是谁把它绑走了。4.1 先用 lspci 和 ethtool 确认网卡型号与当前驱动归属许多 RTL8125 芯片会被系统自带的 r8169 驱动自动接管这也是新手最容易懵的地方明明驱动装好了lsmod 里也看到 r8125但网卡完全不工作。原因多半是设备早被 r8169 占住r8125 没有绑定机会。先看现状lspci -nn | grep -i realtek ethtool -i enp3s0ethtool -i 输出里的 driver 字段会告诉当前网卡用哪个驱动。如果显示 r8169说明内核通用驱动抢先绑定了这块 Realtek 2.5G 网卡。r8169 不是不能用但它对 RTL8125 的省电、流控和速率协商支持不完整跑 2.5G 时常出现协商不准或速度上不去这也是大家宁可麻烦也要换官方 r8125 驱动的原因。执行 lspci 时注意看设备 ID 是否落在 RTL8125 的范围里有些螃蟹网卡型号接近但走的完全不是同一套驱动装 r8125 没用。4.2 编译安装的最小命令序列与参数含义拿到 r8125 源码包后推荐解压到 /usr/src/r8125-版本号 这类稳定路径。这里有个细节不要在压缩包没解压的目录里直接 make也不要把 Windows 上解压好的目录直接拷过来编行尾符和文件权限都会出问题。最稳妥的一套命令sudo tar -xf r8125-*.tar.bz2 -C /usr/src cd /usr/src/r8125-*/ sudo make clean sudo make KSRC/lib/modules/$(uname -r)/build sudo make KSRC/lib/modules/$(uname -r)/build installmake clean 是为了清掉可能残留的历史编译产物。源码包如果之前在其他内核上编过残留的 .o 和 .ko 会让模块带上旧版本信息加载时报 invalid module format这是很典型的内核模块翻车现场。KSRC 是指向内核头文件目录的变量/lib/modules/$(uname -r)/build 是软链接实际指向 /usr/src/linux-headers-$(uname -r)。显式写这个变量能把路径牢牢固定住避免系统里存在多套内核头文件时选错。install 目标会把编译好的 r8125.ko 拷进 /lib/modules/$(uname -r)/kernel/drivers/net/ethernet/realtek/并更新模块依赖关系。如果只想先编译看结果执行到 make KSRC... 就好模块会落在 src/r8125.ko。官方包的 autorun.sh 本质上就是 make clean、make、install、modprobe 一条龙但离线环境我建议手动分步执行报错时才能判断到底是哪一步挂的。4.3 切换驱动r8169 与 r8125 的设备占用与黑名单编译安装完成后直接 sudo modprobe r8125 往往不够因为 r8169 还占着设备。需要先把 r8169 从内核卸载再让 r8125 绑定sudo modprobe -r r8169 sudo modprobe r8125这两条命令执行期间网卡会短暂消失SSH 连接会立刻断开所以务必通过服务器本地控制台或带外管理IPMI/iDRAC操作。如果通过 SSH 远程执行切驱动瞬间连接就断了人就被锁在门外。等 r8125 加载后再执行 ethtool -i 网卡接口名driver 字段应该变成 r8125。为避免下次重启时 r8169 又把设备抢回去把它加入黑名单echo blacklist r8169 | sudo tee /etc/modprobe.d/blacklist-r8169.conf sudo update-initramfs -uupdate-initramfs 会把黑名单写进 initramfs防止引导阶段就加载 r8169。如果之后想回滚到内核自带的 r8169删掉这个配置文件并重新生成 initramfs再 modprobe r8169 就行。内核自带驱动的模块文件始终在系统里不会被覆盖这条回滚路径是离线服务器上最实用的后悔药。5. 避坑实录离线安装 r8125 的 5 个典型翻车现场5.1 gcc 明明装好了gcc --version 还是旧版本现象用离线源装完新 gcc执行 gcc --version 发现版本没变或者编译时用的还是旧编译器。原因系统里同时存在多个 gcc/usr/bin/gcc 是 alternatives 机制的软链接指向旧版本另一种常见的可能是用户目录 ~/.local/bin 或 /usr/local/bin 里存在自定义 gccPATH 环境变量优先命中了它们。解决先 which gcc 看命中路径再用 update-alternatives 切换which gcc ls -l /usr/bin/gcc sudo update-alternatives --config gcc如果驱动 Makefile 里写死了编译器名还可以用 make CC/usr/bin/gcc-12 直接指定不用动系统全局默认值。这个坑的本质是软链接和目标文件的关系没理清很多“升级 gcc 后还是旧版本”的搜索结果都栽在这里。5.2 make 报错“没有指明目标并且找不到 makefile”现象进入源码目录执行 make立刻报 make: *** No rule to make target...看起来像是 Makefile 不存在。原因常见四种。一是没解压在 .tar.bz2 所在目录里就直接 make二是解压后源码实际在 src 子目录里人还在外层三是从 Windows 拷贝过来文件权限或换行符损坏导致 Makefile 无法被解析四是源码来自 GitHub 仓库而非官方 tar 包需要先跑 autogen.sh 生成 configure 和 Makefile。解决先看当前目录里到底有什么ls -l | grep Makefile find . -name Makefile -maxdepth 2确认 Makefile 存在且文件权限正常再执行 make。官方 tar 包一般自带 Makefile不需要自动生成如果是从仓库克隆的就按 README 的说明先执行 autogen.sh。另外要留意如果报错里带了 makefile:xx 的行号说明 Makefile 是被正确读取的真正的编译失败发生在 gcc 阶段要去更早的日志里找 C 编译器的报错而不是盯着 make 的 exit 1。5.3 报错 kernel header files not in any现象make 过程中出现“*** kernel header files not in any of these directories”停在这个错误上不再继续。原因linux-headers-$(uname -r) 没装或机器上装了多个内核版本当前启动的不是最新那个头文件路径和 uname -r 对不上。Kbuild 需要读取内核头文件里的生成文件来编译模块这条路断了后面全断。解决逐项确认uname -r ls -d /usr/src/linux-headers-$(uname -r) ls -l /lib/modules/$(uname -r)/build如果 /usr/src 下没有对应目录回到第 3 章用本地源补装 linux-headers-$(uname -r)。如果 headers 目录存在但 /lib/modules/$(uname -r)/build 软链接损坏手动重建sudo ln -s /usr/src/linux-headers-$(uname -r) /lib/modules/$(uname -r)/build这里最容易忽视的是重启后内核版本变了离线包是按旧内核准备的机器重启进新内核后 uname -r 变了头文件目录还是旧的模块编译就会失败。所以离线装驱动时要先确认这台机器最终会稳定在哪个内核版本上再按那个版本准备 headers。5.4 dpkg -i *.deb 一个接一个依赖报错现象把离线 deb 包拷贝到目标机执行 sudo dpkg -i *.deb报一堆依赖不满足手工调整安装顺序还是不行。原因不带索引的 dpkg -i 不会自动解析依赖顺序而 build-essential 这类工具链包存在网状依赖关系。同时如果 deb 来源混杂了不同发行版版本的包dpkg 会陷入永远修不完的依赖循环。解决不要 dpkg -i *.deb改用 3.3 节的本地源方式让 apt 自己解析依赖顺序。如果已经把部分包装进去了系统处于半破损状态执行 sudo apt-get -f install 修复。离线下最忌讳反复用 dpkg --force-depends 强装最后 dpkg 数据库损坏还得手工恢复 /var/lib/dpkg/status那时就真的无力回天了。5.5 驱动装上后接口名变了或网卡没起来现象modprobe r8125 后原来的 enp3s0 变成 enp3s0s0或者 ip link 里根本看不到网卡接口。原因切换驱动后设备重新被 probe内核按 PCIe 位置重新生成接口名部分系统还会因为 udev 规则把新设备识别成全新接口原有 IP 配置全部失效。解决切换后用 ip link 查看当前实际接口名把原 IP 配置迁移到新接口上涉及 Netplan 或 /etc/network/interfaces 的都要同步改ip link cat /etc/udev/rules.d/70-persistent-net.rules如果接口名频繁漂移最稳定的做法是按网卡 MAC 写 udev 规则锁定接口名。不要依赖 eth0 这种老式命名在 systemd 环境下每次驱动切换都可能变。操作顺序上先改配置再切驱动比切完再手忙脚乱找接口靠谱得多。6. 验证与固化的收尾操作编译日志、DKMS 和速率测试编译过程建议把输出落到文件里再排查不要靠终端滚动屏翻历史。我一般这么执行sudo make KSRC/lib/modules/$(uname -r)/build 21 | tee /tmp/r8125_make.log21 把标准错误也并入标准输出tee 同时写文件和打到屏幕报错时直接查 /tmp/r8125_make.log搜索 error 或 warning 比人工翻屏高效得多。驱动装好只是第一步下一次内核更新会让 /lib/modules 下对应版本的模块目录失效r8125 没有注册进 DKMS 的话升级内核后又得手动编译一遍。用 DKMS 注册很简单源码包里如果自带 dkms.conf直接执行 dkms add没有就手写一份放在源码根目录典型的 dkms.conf 长这样PACKAGE_NAMEr8125 PACKAGE_VERSION填写你下载到的版本号 BUILT_MODULE_NAME[0]r8125 DEST_MODULE_LOCATION[0]/kernel/drivers/net/ethernet/realtek AUTOINSTALLyes然后执行注册、编译、安装三步sudo dkms add /usr/src/r8125-填写实际目录名 sudo dkms build -m r8125 -v 填写实际版本号 sudo dkms install -m r8125 -v 填写实际版本号注册后内核升级时DKMS 会在新内核上自动重编这个模块不用再手工介入这是离线环境下最值得做的固化步骤。最后验证实际速率ethtool 网卡名查看 Speed 是否为 2500Mb/s再配合 iperf3 双向打流确认吞吐。2.5G 网卡常见的翻车点是协商到 1000Mb/s原因多为网线老化或对端交换机端口不支持这不是驱动问题别在驱动上浪费时间。每台机器装完我都习惯把 uname -r、gcc --version、r8125 版本、DKMS 注册状态记到 /root/install-log.txt 里。下次内核升级或网卡失联时这份记录能直接帮你定位是驱动没了还是配置丢了省掉一大段排查时间。这是我做离线部署多年攒下的习惯希望帮到你。本文还有配套的精品资源点击获取