一、问题背景与驱动识别

在Ubuntu 24.04系统部署过程中，部分用户会遇到有线网络无法自动识别的问题。这类情况通常出现在使用Realtek RTL8111/8168/8211/8411系列网卡的新硬件上，尽管系统能通过PCI总线识别设备，但缺少对应的内核驱动模块导致网络功能失效。

1.1 硬件识别验证

通过以下命令确认网卡硬件信息：

lspci | grep -i ethernet

典型输出示例：

04:00.0 Ethernet controller: Realtek Semiconductor Co., Ltd. RTL8111/8168/8211/8411 PCI Express Gigabit Ethernet Controller (rev 10)

该输出表明系统已检测到千兆网卡，但需进一步验证驱动状态。

1.2 驱动模块检查

使用以下命令检查已加载的驱动模块：

lsmod | grep -E 'r8168|r8169'

若命令无输出，则说明系统未加载任何Realtek网卡驱动模块。此时需要确认内核是否包含这些模块：

find /lib/modules/$(uname -r) -name '*r816*'

若搜索结果为空，则必须进行手动安装。

二、离线安装方案设计

由于目标系统缺乏网络连接，需采用”交叉下载-介质传输-本地安装”的三步策略。该方案利用另一台同版本Ubuntu系统完成依赖下载，通过可移动存储设备传输安装包。

2.1 依赖关系分析

Realtek网卡驱动安装需要以下核心组件：

内核头文件：提供模块编译所需的头文件和符号链接
DKMS框架：动态内核模块支持系统，用于管理驱动生命周期
驱动源码包：包含r8168-dkms驱动实现

2.2 交叉下载实施

在具备网络连接的Ubuntu 24.04系统上执行：

# 创建工作目录
mkdir ~/rtl_driver_pkg && cd ~/rtl_driver_pkg
# 下载核心依赖包（按顺序执行）
sudo apt download linux-hwe-6.14-headers-$(uname -r)
sudo apt download linux-headers-$(uname -r)-generic
sudo apt download dkms
sudo apt download r8168-dkms
# 验证文件完整性
ls -l *.deb

建议将下载的.deb文件复制到FAT32格式的U盘，确保跨系统兼容性。

三、本地安装详细步骤

在目标系统上执行以下操作，需root权限或sudo权限：

3.1 依赖包安装

# 切换到安装包目录
cd /media/$USER/USB_DRIVE/rtl_driver_pkg
# 按依赖顺序安装（使用通配符简化命令）
sudo dpkg -i linux-hwe-6.14-headers*.deb
sudo dpkg -i linux-headers-$(uname -r)-generic*.deb
sudo dpkg -i dkms*.deb
sudo dpkg -i r8168-dkms*.deb
# 修复可能的依赖问题
sudo apt --fix-broken install

3.2 驱动模块加载

DKMS会自动完成以下操作：

将驱动源码复制到/usr/src/r8168-
根据当前内核版本编译模块
将生成的r8168.ko安装到/lib/modules/$(uname -r)/updates/dkms/

手动验证模块状态：

dkms status | grep r8168
lsmod | grep r8168

3.3 网络服务重启

完成驱动安装后，需重启网络服务使配置生效：

sudo systemctl restart NetworkManager
# 或使用传统ifupdown方式
sudo systemctl restart networking

四、故障排查与高级技巧

4.1 常见问题处理

问题1：安装过程中出现”Unmet dependencies”错误
解决方案：

# 先安装基础依赖
sudo apt install -f
# 重新尝试安装
sudo dpkg -i *.deb

问题2：驱动加载后仍无网络连接
解决方案：

检查物理连接和网线状态
验证接口是否被识别：
```
ip link show
```

手动启用接口：

sudo ip link set eth0 up
sudo dhclient eth0

4.2 内核升级后的维护

当系统执行内核升级后，需重新编译驱动模块：

# 清理旧版本
sudo dkms remove r8168/$(dkms status | awk '{print $2}' | head -1) --all
# 重新构建模块
sudo dkms build -m r8168 -v $(dkms status | awk '{print $2}' | head -1)
sudo dkms install -m r8168 -v $(dkms status | awk '{print $2}' | head -1)

4.3 编译日志分析

若驱动编译失败，可通过以下路径获取详细日志：

cat /var/lib/dkms/r8168/*/build/make.log

常见编译错误包括：

缺少内核头文件（需安装对应版本headers）
GCC版本不兼容（需使用系统默认编译器）
配置选项冲突（检查/etc/dkms/r8168.conf）

五、最佳实践建议

版本匹配原则：确保下载的驱动包与目标系统内核版本完全一致
介质管理：使用多个存储设备备份安装包，防止传输失败
安装顺序：严格遵循”headers→dkms→驱动”的安装顺序
日志记录：建议将安装过程输出重定向到日志文件：
```
sudo script -a /root/driver_install.log
# 执行安装命令...
exit
```

通过本方案实施，用户可在完全离线环境下完成Realtek有线网卡驱动部署，解决新硬件适配和网络初始化问题。该方法不仅适用于Ubuntu 24.04，经过适当调整也可应用于其他基于Debian的发行版。对于企业级部署场景，建议将驱动安装流程纳入自动化配置管理系统，提升大规模部署效率。

Ubuntu 24.04系统下Realtek有线网卡驱动离线安装指南