简介面向在 Ubuntu 环境下进行软件开发或 Realtek 网卡驱动安装的用户这份离线资源包整合了 gcc、make、build-essential 等基础编译工具及 r8125 千兆网卡驱动源码解决无网络环境下开发工具链与网卡驱动无法在线获取的问题。压缩包共 42 个文件约 30.01MB以 23 个 deb 安装包为主体涵盖 gcc、g、make、libc 开发库等依赖另含 8 个 h 头文件、6 个 c 源文件、2 个 makefile 及 autorun.sh 脚本与 readme 说明构成 r8125 驱动的完整编译素材。已有 3769 人学习下载。读者可据此在断网机器上一次性补齐编译环境按 Makefile 与脚本完成驱动编译安装并通过 readme 了解模块加载与依赖处理思路适合需要离线部署驱动或搭建基础开发环境的中级 Linux 用户参考。1. 一次装完 gcc、make 和 r8125离线环境里最容易被低估的依赖链机房里有台 Ubuntu 机器网卡是 Realtek 的系统装完ip a只看到一个 lo插着网线灯都不亮。运维同事第一反应是驱动没装第二反应是去apt install结果发现这台机器压根没网——没网卡就没网没网就没法装驱动死循环。这种场景在离线部署、内网机器、老主板换新系统时特别常见标题里这套 gcc、make、build-essential 加 r8125 离线安装包解决的就是这个死结。很多人以为 r8125 驱动装不上是内核版本问题其实十次里有六次是编译工具链没齐make报错的第一行往往不是驱动代码的问题而是gcc: command not found。这篇笔记按我实际踩过的顺序把工具链、依赖、驱动编译、验证和翻车救援一条线走完适合第一次在离线 Ubuntu 上装 Realtek 网卡驱动的开发者也适合想搞清楚 build-essential 到底带了什么的老手。2. 装前把环境盘清楚Ubuntu 版本、内核头文件和工具链三件套离线装驱动最怕的不是命令不会敲是装到一半发现缺东西又没法联网补。所以动手之前先把这台机器的底细摸清楚把该下的包一次性下全。这一章讲的是「装什么、为什么装、版本怎么对」后面几章才是具体敲命令。2.1 先确认 Ubuntu 版本和内核版本对不对得上r8125 是内核模块编译时用的内核头文件必须和当前运行的内核版本严格一致差一个小版本号都可能编译失败或者装上了不加载。先跑这两条# 查看发行版版本决定下载哪个版本的依赖包 lsb_release -a # 查看当前运行内核版本后面下 linux-headers 必须和这个完全一致 uname -rlsb_release -a输出里的Release字段比如 20.04、22.04、24.04决定了你该拿哪个 Ubuntu 代号focal、jammy、noble的 deb 包。uname -r输出的完整版本串比如5.15.0-91-generic就是你要找的linux-headers-5.15.0-91-generic包名后缀。这两个信息记下来后面所有下载都围绕它们转。常见做法是在另一台能联网、同版本 Ubuntu 的机器上用apt-get install --download-only把包下到本地缓存再拷过去。命令长这样# 在联网的同版本机器上只下载不安装包会落在 /var/cache/apt/archives/ sudo apt-get install --download-only -y \ gcc make build-essential \ linux-headers-$(uname -r) \ dkms--download-only是关键参数它让 apt 把依赖解析完整、全部下载但不执行安装这样拷到离线机器上dpkg -i才不会缺依赖。dkms不是必须的但装上它以后内核升级会自动重编驱动省得下次升级又断网我一般会带上。2.2 build-essential 到底装了什么为什么不能只装 gcc新手最容易犯的错是只装gcc然后make一跑就报make: *** /lib/modules/.../build: No such file or directory。这个报错跟 gcc 没关系是缺内核头文件里的构建目录。build-essential 这个元包实际拉进来的东西比名字听起来多包名作用缺了会怎样gccC 编译器编译 .c 文件直接失败gC 编译器部分内核构建脚本需要make构建工具无法执行 Makefilelibc6-devC 标准库头文件报 stdio.h 找不到dpkg-devdeb 打包工具dkms 相关流程报错linux-headers-$(uname -r)内核头文件找不到 /lib/modules/.../build注意最后一行linux-headers严格来说不属于 build-essential但装内核模块时它是硬依赖必须单独装。很多人把这两个概念混在一起以为装了 build-essential 就万事大吉结果卡在头文件上。我的习惯是下载清单里永远把linux-headers-$(uname -r)单独列一行避免漏掉。2.3 r8125 离线包和依赖包的版本对应关系r8125 驱动源码包本身版本号比如 9.011.00、9.012.00 这类和内核版本之间没有强绑定但和内核的兼容性有讲究太老的驱动源码在新内核上编译会报 API 变更错误太新的驱动在老内核上可能用了不存在的宏。判断方法很直接——看驱动包里的README或src/Makefile顶部标注的支持内核范围再对照uname -r。离线环境里我一般准备三样东西放同一个目录r8125 源码压缩包、build-essential 及其依赖的一堆 deb、对应版本的 linux-headers deb。目录结构大概这样offline-pkgs/ ├── r8125-9.011.00.tar.bz2 ├── gcc_*.deb ├── make_*.deb ├── build-essential_*.deb ├── libc6-dev_*.deb ├── linux-headers-5.15.0-91_*.deb └── linux-headers-5.15.0-91-generic_*.deb注意linux-headers通常拆成两个包一个通用部分、一个-generic架构相关部分两个都要下只下其中一个dpkg -i会报依赖不满足。这是离线装驱动翻车率最高的一步血泪经验。3. 离线安装工具链dpkg 批量装 deb 的顺序和依赖处理包下全了接下来是在离线机器上把它们装进去。这一步的核心不是命令多难是顺序和依赖处理装错顺序会连环报错越修越乱。3.1 用 dpkg 批量安装并自动修复依赖顺序最稳的做法不是一个个dpkg -i而是一次性把目录里所有 deb 丢给 dpkg让它自己按依赖关系排# 进入离线包目录 cd /path/to/offline-pkgs # 一次性安装目录下所有 debdpkg 会按包内依赖声明排序处理 sudo dpkg -i *.deb # 如果仍有依赖报错用下面这条补齐离线环境下它只从本地缓存找 sudo apt-get install -f -ydpkg -i *.deb的好处是 dpkg 会读取每个包的Depends字段尽量按依赖顺序安装比手动一个个敲靠谱得多。但它不是万能的——如果依赖包不在当前目录它会报dependency problems prevent configuration。这时候apt-get install -f会尝试修复离线环境下它只能从/var/cache/apt/archives/找包所以前面用--download-only下好的包最好也拷进这个缓存目录修复才能生效。我一般会先跑一遍dpkg -i *.deb看输出里有没有Errors were encountered有的话再跑apt-get install -f两步下来基本能清干净。如果还报错说明确实缺包回联网机器补下。3.2 验证 gcc、make、头文件是否真的就位装完不能直接去编驱动先验证三件事任何一件不通过后面都是白忙# 验证编译器 gcc --version # 验证 make make --version # 验证内核构建目录存在这是编译内核模块的前提 ls -d /lib/modules/$(uname -r)/build前两条输出正常版本号即可。第三条最关键/lib/modules/$(uname -r)/build是一个软链接指向/usr/src/linux-headers-$(uname -r)如果这个目录不存在或者链接断了make一定失败。常见现象是ls报No such file or directory原因就是 linux-headers 没装对版本或者装的是通用包没装-generic包。解决方法是回 2.1 重新确认uname -r和下载的包名是否一字不差。提示uname -r的输出里如果带-generic后缀下载的 headers 包名也必须带这个后缀少一个字符都不行。3.3 把 r8125 源码解压到规范路径工具链就位后解压驱动源码。路径建议放在/usr/src/下和内核源码放一起方便管理也符合惯例# 解压到 /usr/src具体文件名按你下载的版本改 sudo tar -xjf r8125-9.011.00.tar.bz2 -C /usr/src/ # 进入解压后的源码目录 cd /usr/src/r8125-9.011.00-xjf对应.tar.bz2格式-C指定解压目标目录。如果你的包是.tar.gz参数换成-xzf。解压后ls一下应该能看到src/、Makefile、README这些src/里是真正的驱动源码r8125_n.c之类。这一步本身不难但路径别乱放后面dkms或者手动insmod都依赖这个位置。4. 编译并加载 r8125make 参数、模块安装和开机自启工具链和源码都齐了这一章是真正把驱动编出来、装进内核、让它开机自动加载。r8125 的 Makefile 写得比较友好大部分情况直接make就行但离线环境和多网卡场景有几个参数值得说清楚。4.1 直接 make 编译看懂输出里的关键行在源码目录里执行# 编译驱动模块输出 r8125.ko sudo make # 编译并安装到 /lib/modules/$(uname -r)/kernel/drivers/net/ethernet/realtek/ sudo make installmake这一步会调用内核构建系统编译出src/r8125.ko。输出里重点看两处一是有没有error:开头的行有就是编译失败通常是内核 API 不兼容或者头文件缺失二是最后有没有生成.ko文件。make install会把.ko拷到内核模块目录并跑depmod更新模块依赖表这一步不做的话后面modprobe找不到模块。如果make报Makefile:xxx: *** Linux kernel source not found回到 3.2 检查/lib/modules/$(uname -r)/build。如果报某个函数隐式声明多半是驱动版本和内核版本不匹配换一个 r8125 源码版本重试别硬改代码。4.2 加载模块并确认网卡被识别编译安装完加载模块# 加载 r8125 模块 sudo modprobe r8125 # 确认模块已加载 lsmod | grep r8125 # 查看网卡是否出现 ip amodprobe比insmod好用的地方在于它会自动处理模块依赖直接insmod ./src/r8125.ko也行但路径要写全且不更新依赖表。lsmod | grep r8125有输出说明模块进了内核。ip a里应该多出一个enp开头的网卡具体名字看主板有 MAC 地址、状态从DOWN变UP就说明驱动工作了。如果ip a还是只有 lo先看dmesg | tail -30驱动加载失败会在内核日志里留痕常见的是r8125: probe of ... failed with error -X这个错误码是排查方向。4.3 配置开机自动加载避免重启后又断网modprobe只是当前生效重启就没了。要持久化把模块名写进配置文件# 写入开机自动加载配置 echo r8125 | sudo tee /etc/modules-load.d/r8125.conf # 可选如果系统里有冲突的旧驱动如 r8169加入黑名单 echo blacklist r8169 | sudo tee /etc/modprobe.d/blacklist-r8169.conf第一行让系统开机时自动modprobe r8125。第二行是很多人的盲区Realtek 网卡经常被内核自带的r8169驱动先抢走导致 r8125 装了也不生效现象是lsmod里两个都在、网卡却工作不正常。把r8169拉黑后重启让 r8125 独占。改完sudo update-initramfs -u更新一下 initramfs确保早期启动阶段也生效。注意黑名单写错模块名会导致网卡彻底不识别改之前先lsmod | grep r81确认当前加载的是哪个别凭记忆写。5. 避坑与排查离线装 r8125 最常见的五个翻车点这一章是我自己和小团队里反复遇到的坑按「现象 → 原因 → 解决」记下来装的时候对照着看能省不少时间。5.1 make 报找不到 build 目录现象make第一行就报*** /lib/modules/5.15.0-xx-generic/build: No such file or directory. Stop.原因linux-headers 没装或者装的版本和uname -r不一致。离线环境里最常见的是下了linux-headers-5.15.0-91却漏了linux-headers-5.15.0-91-generic。解决dpkg -l | grep linux-headers看装了哪些对照uname -r补齐缺的那个包重新dpkg -i。5.2 驱动装上了但网卡不亮现象lsmod能看到 r8125ip a却没有新网卡网口灯不亮。原因内核自带的 r8169 驱动先加载并占用了设备r8125 抢不到。解决按 4.3 把 r8169 加入黑名单update-initramfs -u后重启。重启后lsmod | grep r8169应该为空。5.3 dpkg 安装报依赖不满足现象dpkg -i *.deb输出一堆dependency problems prevent configuration of ...。原因依赖包没下全或者下的是别的 Ubuntu 版本的包。解决回联网机器用apt-get install --download-only重新下确保lsb_release -a的版本一致。离线机器上把新包拷进同一目录再dpkg -i *.deb最后apt-get install -f收尾。5.4 编译报隐式声明或 API 不匹配现象make输出大量implicit declaration of function或too few arguments to function。原因r8125 源码版本太老和当前内核的 API 对不上。解决换一个更新的 r8125 源码包重编别去改驱动源码里的函数签名改了一处会连锁报错。判断标准是看源码包 README 里标注的支持内核上限。5.5 重启后网卡又消失现象装完当场能用重启后ip a又只剩 lo。原因只跑了modprobe没做持久化或者做了持久化但 initramfs 没更新。解决确认/etc/modules-load.d/r8125.conf内容正确跑sudo update-initramfs -u再重启验证。这一步我吃过亏当时以为写个配置文件就完事结果 initramfs 里还是旧状态。6. 装完怎么验证跑通三步确认法和一个我坚持的习惯驱动装完最怕的是「看起来好了」实际一跑流量就断。我验证 r8125 从来不看单一指标走三步模块层、设备层、链路层三层都过才算真跑通。第一步模块层确认模块加载且没有报错# 模块在不在 lsmod | grep r8125 # 内核日志里有没有 probe 失败 dmesg | grep -i r8125 | tail -20lsmod有输出、dmesg里没有failed或error字样模块层就算过。如果dmesg里有link up之类的字样说明物理链路也协商上了。第二步设备层确认网卡有正常名字和 MACip -br link show输出里应该有一个非 lo 的网卡状态UP后面跟着 MAC 地址。名字可能是enp3s0或eth0取决于系统的命名规则不影响功能。第三步链路层实际配个地址 ping 一下# 临时配地址测试按实际网段改 sudo ip addr add 192.168.1.100/24 dev enp3s0 sudo ip link set enp3s0 up # ping 网关验证连通 ping -c 4 192.168.1.1能 ping 通网关说明驱动、链路、协议栈全通了。这一步别省有些驱动模块加载正常、ip a也显示网卡但一发包就丢只有实际 ping 才暴露。验证通过后把临时地址清掉交给系统的网络管理配置持久化地址别留着临时配置和正式配置打架。从那以后我每次离线装网卡驱动都强制走一遍「模块层 → 设备层 → 链路层」这三步哪怕当场ip a看着正常也不跳过因为翻车往往就藏在第三步。希望这套流程帮到你少走一次断网重装的弯路。本文还有配套的精品资源点击获取
简介面向在 Ubuntu 环境下进行软件开发或 Realtek 网卡驱动安装的用户这份离线资源包整合了 gcc、make、build-essential 等基础编译工具及 r8125 千兆网卡驱动源码解决无网络环境下开发工具链与网卡驱动无法在线获取的问题。压缩包共 42 个文件约 30.01MB以 23 个 deb 安装包为主体涵盖 gcc、g、make、libc 开发库等依赖另含 8 个 h 头文件、6 个 c 源文件、2 个 makefile 及 autorun.sh 脚本与 readme 说明构成 r8125 驱动的完整编译素材。已有 3769 人学习下载。读者可据此在断网机器上一次性补齐编译环境按 Makefile 与脚本完成驱动编译安装并通过 readme 了解模块加载与依赖处理思路适合需要离线部署驱动或搭建基础开发环境的中级 Linux 用户参考。1. 一次装完 gcc、make 和 r8125离线环境里最容易被低估的依赖链机房里有台 Ubuntu 机器网卡是 Realtek 的系统装完ip a只看到一个 lo插着网线灯都不亮。运维同事第一反应是驱动没装第二反应是去apt install结果发现这台机器压根没网——没网卡就没网没网就没法装驱动死循环。这种场景在离线部署、内网机器、老主板换新系统时特别常见标题里这套 gcc、make、build-essential 加 r8125 离线安装包解决的就是这个死结。很多人以为 r8125 驱动装不上是内核版本问题其实十次里有六次是编译工具链没齐make报错的第一行往往不是驱动代码的问题而是gcc: command not found。这篇笔记按我实际踩过的顺序把工具链、依赖、驱动编译、验证和翻车救援一条线走完适合第一次在离线 Ubuntu 上装 Realtek 网卡驱动的开发者也适合想搞清楚 build-essential 到底带了什么的老手。2. 装前把环境盘清楚Ubuntu 版本、内核头文件和工具链三件套离线装驱动最怕的不是命令不会敲是装到一半发现缺东西又没法联网补。所以动手之前先把这台机器的底细摸清楚把该下的包一次性下全。这一章讲的是「装什么、为什么装、版本怎么对」后面几章才是具体敲命令。2.1 先确认 Ubuntu 版本和内核版本对不对得上r8125 是内核模块编译时用的内核头文件必须和当前运行的内核版本严格一致差一个小版本号都可能编译失败或者装上了不加载。先跑这两条# 查看发行版版本决定下载哪个版本的依赖包 lsb_release -a # 查看当前运行内核版本后面下 linux-headers 必须和这个完全一致 uname -rlsb_release -a输出里的Release字段比如 20.04、22.04、24.04决定了你该拿哪个 Ubuntu 代号focal、jammy、noble的 deb 包。uname -r输出的完整版本串比如5.15.0-91-generic就是你要找的linux-headers-5.15.0-91-generic包名后缀。这两个信息记下来后面所有下载都围绕它们转。常见做法是在另一台能联网、同版本 Ubuntu 的机器上用apt-get install --download-only把包下到本地缓存再拷过去。命令长这样# 在联网的同版本机器上只下载不安装包会落在 /var/cache/apt/archives/ sudo apt-get install --download-only -y \ gcc make build-essential \ linux-headers-$(uname -r) \ dkms--download-only是关键参数它让 apt 把依赖解析完整、全部下载但不执行安装这样拷到离线机器上dpkg -i才不会缺依赖。dkms不是必须的但装上它以后内核升级会自动重编驱动省得下次升级又断网我一般会带上。2.2 build-essential 到底装了什么为什么不能只装 gcc新手最容易犯的错是只装gcc然后make一跑就报make: *** /lib/modules/.../build: No such file or directory。这个报错跟 gcc 没关系是缺内核头文件里的构建目录。build-essential 这个元包实际拉进来的东西比名字听起来多包名作用缺了会怎样gccC 编译器编译 .c 文件直接失败gC 编译器部分内核构建脚本需要make构建工具无法执行 Makefilelibc6-devC 标准库头文件报 stdio.h 找不到dpkg-devdeb 打包工具dkms 相关流程报错linux-headers-$(uname -r)内核头文件找不到 /lib/modules/.../build注意最后一行linux-headers严格来说不属于 build-essential但装内核模块时它是硬依赖必须单独装。很多人把这两个概念混在一起以为装了 build-essential 就万事大吉结果卡在头文件上。我的习惯是下载清单里永远把linux-headers-$(uname -r)单独列一行避免漏掉。2.3 r8125 离线包和依赖包的版本对应关系r8125 驱动源码包本身版本号比如 9.011.00、9.012.00 这类和内核版本之间没有强绑定但和内核的兼容性有讲究太老的驱动源码在新内核上编译会报 API 变更错误太新的驱动在老内核上可能用了不存在的宏。判断方法很直接——看驱动包里的README或src/Makefile顶部标注的支持内核范围再对照uname -r。离线环境里我一般准备三样东西放同一个目录r8125 源码压缩包、build-essential 及其依赖的一堆 deb、对应版本的 linux-headers deb。目录结构大概这样offline-pkgs/ ├── r8125-9.011.00.tar.bz2 ├── gcc_*.deb ├── make_*.deb ├── build-essential_*.deb ├── libc6-dev_*.deb ├── linux-headers-5.15.0-91_*.deb └── linux-headers-5.15.0-91-generic_*.deb注意linux-headers通常拆成两个包一个通用部分、一个-generic架构相关部分两个都要下只下其中一个dpkg -i会报依赖不满足。这是离线装驱动翻车率最高的一步血泪经验。3. 离线安装工具链dpkg 批量装 deb 的顺序和依赖处理包下全了接下来是在离线机器上把它们装进去。这一步的核心不是命令多难是顺序和依赖处理装错顺序会连环报错越修越乱。3.1 用 dpkg 批量安装并自动修复依赖顺序最稳的做法不是一个个dpkg -i而是一次性把目录里所有 deb 丢给 dpkg让它自己按依赖关系排# 进入离线包目录 cd /path/to/offline-pkgs # 一次性安装目录下所有 debdpkg 会按包内依赖声明排序处理 sudo dpkg -i *.deb # 如果仍有依赖报错用下面这条补齐离线环境下它只从本地缓存找 sudo apt-get install -f -ydpkg -i *.deb的好处是 dpkg 会读取每个包的Depends字段尽量按依赖顺序安装比手动一个个敲靠谱得多。但它不是万能的——如果依赖包不在当前目录它会报dependency problems prevent configuration。这时候apt-get install -f会尝试修复离线环境下它只能从/var/cache/apt/archives/找包所以前面用--download-only下好的包最好也拷进这个缓存目录修复才能生效。我一般会先跑一遍dpkg -i *.deb看输出里有没有Errors were encountered有的话再跑apt-get install -f两步下来基本能清干净。如果还报错说明确实缺包回联网机器补下。3.2 验证 gcc、make、头文件是否真的就位装完不能直接去编驱动先验证三件事任何一件不通过后面都是白忙# 验证编译器 gcc --version # 验证 make make --version # 验证内核构建目录存在这是编译内核模块的前提 ls -d /lib/modules/$(uname -r)/build前两条输出正常版本号即可。第三条最关键/lib/modules/$(uname -r)/build是一个软链接指向/usr/src/linux-headers-$(uname -r)如果这个目录不存在或者链接断了make一定失败。常见现象是ls报No such file or directory原因就是 linux-headers 没装对版本或者装的是通用包没装-generic包。解决方法是回 2.1 重新确认uname -r和下载的包名是否一字不差。提示uname -r的输出里如果带-generic后缀下载的 headers 包名也必须带这个后缀少一个字符都不行。3.3 把 r8125 源码解压到规范路径工具链就位后解压驱动源码。路径建议放在/usr/src/下和内核源码放一起方便管理也符合惯例# 解压到 /usr/src具体文件名按你下载的版本改 sudo tar -xjf r8125-9.011.00.tar.bz2 -C /usr/src/ # 进入解压后的源码目录 cd /usr/src/r8125-9.011.00-xjf对应.tar.bz2格式-C指定解压目标目录。如果你的包是.tar.gz参数换成-xzf。解压后ls一下应该能看到src/、Makefile、README这些src/里是真正的驱动源码r8125_n.c之类。这一步本身不难但路径别乱放后面dkms或者手动insmod都依赖这个位置。4. 编译并加载 r8125make 参数、模块安装和开机自启工具链和源码都齐了这一章是真正把驱动编出来、装进内核、让它开机自动加载。r8125 的 Makefile 写得比较友好大部分情况直接make就行但离线环境和多网卡场景有几个参数值得说清楚。4.1 直接 make 编译看懂输出里的关键行在源码目录里执行# 编译驱动模块输出 r8125.ko sudo make # 编译并安装到 /lib/modules/$(uname -r)/kernel/drivers/net/ethernet/realtek/ sudo make installmake这一步会调用内核构建系统编译出src/r8125.ko。输出里重点看两处一是有没有error:开头的行有就是编译失败通常是内核 API 不兼容或者头文件缺失二是最后有没有生成.ko文件。make install会把.ko拷到内核模块目录并跑depmod更新模块依赖表这一步不做的话后面modprobe找不到模块。如果make报Makefile:xxx: *** Linux kernel source not found回到 3.2 检查/lib/modules/$(uname -r)/build。如果报某个函数隐式声明多半是驱动版本和内核版本不匹配换一个 r8125 源码版本重试别硬改代码。4.2 加载模块并确认网卡被识别编译安装完加载模块# 加载 r8125 模块 sudo modprobe r8125 # 确认模块已加载 lsmod | grep r8125 # 查看网卡是否出现 ip amodprobe比insmod好用的地方在于它会自动处理模块依赖直接insmod ./src/r8125.ko也行但路径要写全且不更新依赖表。lsmod | grep r8125有输出说明模块进了内核。ip a里应该多出一个enp开头的网卡具体名字看主板有 MAC 地址、状态从DOWN变UP就说明驱动工作了。如果ip a还是只有 lo先看dmesg | tail -30驱动加载失败会在内核日志里留痕常见的是r8125: probe of ... failed with error -X这个错误码是排查方向。4.3 配置开机自动加载避免重启后又断网modprobe只是当前生效重启就没了。要持久化把模块名写进配置文件# 写入开机自动加载配置 echo r8125 | sudo tee /etc/modules-load.d/r8125.conf # 可选如果系统里有冲突的旧驱动如 r8169加入黑名单 echo blacklist r8169 | sudo tee /etc/modprobe.d/blacklist-r8169.conf第一行让系统开机时自动modprobe r8125。第二行是很多人的盲区Realtek 网卡经常被内核自带的r8169驱动先抢走导致 r8125 装了也不生效现象是lsmod里两个都在、网卡却工作不正常。把r8169拉黑后重启让 r8125 独占。改完sudo update-initramfs -u更新一下 initramfs确保早期启动阶段也生效。注意黑名单写错模块名会导致网卡彻底不识别改之前先lsmod | grep r81确认当前加载的是哪个别凭记忆写。5. 避坑与排查离线装 r8125 最常见的五个翻车点这一章是我自己和小团队里反复遇到的坑按「现象 → 原因 → 解决」记下来装的时候对照着看能省不少时间。5.1 make 报找不到 build 目录现象make第一行就报*** /lib/modules/5.15.0-xx-generic/build: No such file or directory. Stop.原因linux-headers 没装或者装的版本和uname -r不一致。离线环境里最常见的是下了linux-headers-5.15.0-91却漏了linux-headers-5.15.0-91-generic。解决dpkg -l | grep linux-headers看装了哪些对照uname -r补齐缺的那个包重新dpkg -i。5.2 驱动装上了但网卡不亮现象lsmod能看到 r8125ip a却没有新网卡网口灯不亮。原因内核自带的 r8169 驱动先加载并占用了设备r8125 抢不到。解决按 4.3 把 r8169 加入黑名单update-initramfs -u后重启。重启后lsmod | grep r8169应该为空。5.3 dpkg 安装报依赖不满足现象dpkg -i *.deb输出一堆dependency problems prevent configuration of ...。原因依赖包没下全或者下的是别的 Ubuntu 版本的包。解决回联网机器用apt-get install --download-only重新下确保lsb_release -a的版本一致。离线机器上把新包拷进同一目录再dpkg -i *.deb最后apt-get install -f收尾。5.4 编译报隐式声明或 API 不匹配现象make输出大量implicit declaration of function或too few arguments to function。原因r8125 源码版本太老和当前内核的 API 对不上。解决换一个更新的 r8125 源码包重编别去改驱动源码里的函数签名改了一处会连锁报错。判断标准是看源码包 README 里标注的支持内核上限。5.5 重启后网卡又消失现象装完当场能用重启后ip a又只剩 lo。原因只跑了modprobe没做持久化或者做了持久化但 initramfs 没更新。解决确认/etc/modules-load.d/r8125.conf内容正确跑sudo update-initramfs -u再重启验证。这一步我吃过亏当时以为写个配置文件就完事结果 initramfs 里还是旧状态。6. 装完怎么验证跑通三步确认法和一个我坚持的习惯驱动装完最怕的是「看起来好了」实际一跑流量就断。我验证 r8125 从来不看单一指标走三步模块层、设备层、链路层三层都过才算真跑通。第一步模块层确认模块加载且没有报错# 模块在不在 lsmod | grep r8125 # 内核日志里有没有 probe 失败 dmesg | grep -i r8125 | tail -20lsmod有输出、dmesg里没有failed或error字样模块层就算过。如果dmesg里有link up之类的字样说明物理链路也协商上了。第二步设备层确认网卡有正常名字和 MACip -br link show输出里应该有一个非 lo 的网卡状态UP后面跟着 MAC 地址。名字可能是enp3s0或eth0取决于系统的命名规则不影响功能。第三步链路层实际配个地址 ping 一下# 临时配地址测试按实际网段改 sudo ip addr add 192.168.1.100/24 dev enp3s0 sudo ip link set enp3s0 up # ping 网关验证连通 ping -c 4 192.168.1.1能 ping 通网关说明驱动、链路、协议栈全通了。这一步别省有些驱动模块加载正常、ip a也显示网卡但一发包就丢只有实际 ping 才暴露。验证通过后把临时地址清掉交给系统的网络管理配置持久化地址别留着临时配置和正式配置打架。从那以后我每次离线装网卡驱动都强制走一遍「模块层 → 设备层 → 链路层」这三步哪怕当场ip a看着正常也不跳过因为翻车往往就藏在第三步。希望这套流程帮到你少走一次断网重装的弯路。本文还有配套的精品资源点击获取
