终极指南：如何快速为ESXi 6.7安装Realtek RTL8125网卡驱动 🚀

Realtek RTL8125网卡驱动是专为VMware ESXi 6.7系统开发的网络接口卡驱动程序，基于Realtek官方源码与VMware开源组件构建，帮助用户解决ESXi环境下RTL8125网卡的兼容性问题，实现稳定高效的网络连接。

📋 准备工作：构建环境要求与清单

核心环境配置

• 操作系统：CentOS 7（推荐最小化安装）
• 权限要求：root管理员权限（确保完整系统操作权限）
• 硬件空间：至少10GB空闲磁盘空间（用于工具链与源码编译）

必备工具链

• gcc-4.8.0编译器
• binutils-2.22工具集
• glibc-2.3.4-2.41库文件
• VMware ESXi 6.7 ODP源码包（含vmkdrivers-gpl组件）

🔧 超详细环境搭建步骤（新手友好）

1. 创建专用工作目录

登录CentOS 7系统后，执行以下命令创建标准化工作目录结构：

# 切换至root用户
su - root

# 创建核心构建目录
mkdir -p /build/{toolchain/src,vsphere}

提示：-p参数可自动创建多级目录，避免手动逐级创建的繁琐

2. 部署编译工具链

将下载的工具链压缩包复制到/build/toolchain/src目录，执行解压与编译：

# 进入源码目录
cd /build/toolchain/src

# 解压工具链文件（以gcc为例）
tar -xzf gcc-4.8.0.tar.gz

# 编译并安装gcc（目标路径：/build/toolchain/lin64）
cd gcc-4.8.0
./configure --prefix=/build/toolchain/lin64
make -j4  # 使用4核并行编译加速
make install

注意：binutils与glibc需按相同步骤依次编译安装

3. 配置VMware源码环境

将ESXi ODP包中的vmkdrivers-gpl组件解压至指定目录：

# 解压VMware源码包
tar -xzf VMware-ESXI-67U3-ODP.tar.gz -C /build/vsphere

# 验证目录结构
ls /build/vsphere/vmkdrivers-gpl/vmkdrivers/src_9/drivers/net

正常情况下会显示网络驱动相关的源码目录列表。

🚀 驱动编译与安装全流程

1. 准备驱动源码

将项目源码中的核心驱动目录复制到VMware源码树：

# 克隆项目仓库（国内加速地址）
git clone https://gitcode.com/gh_mirrors/r8/r8125-esxi

# 复制驱动源码至编译目录
cp -r r8125-esxi/r8125 /build/vsphere/vmkdrivers-gpl/vmkdrivers/src_9/drivers/net/

2. 执行自动化构建脚本

项目提供的build-r8125.sh脚本可一键完成驱动编译：

# 复制构建脚本到工作目录
cp r8125-esxi/build-script/build-r8125.sh /build/vsphere/vmkdrivers-gpl/

# 赋予执行权限并运行
cd /build/vsphere/vmkdrivers-gpl/
chmod +x build-r8125.sh
./build-r8125.sh

脚本会自动设置环境变量、执行编译并生成r8125.ko驱动模块。

3. 部署驱动至ESXi系统

编译完成后，将生成的驱动文件复制到ESXi主机：

# 通过SCP传输驱动（替换为实际ESXi主机IP）
scp r8125.ko root@esxi-host-ip:/lib/modules/$(uname -r)/kernel/drivers/net/

# 在ESXi主机上更新模块依赖
esxcli software vib install -v /path/to/r8125.vib
esxcli system module load -m r8125

🛠️ 核心源码文件说明

文件路径	功能描述
r8125/r8125.h	驱动核心数据结构定义
r8125/r8125_n.c	网卡设备驱动主逻辑
r8125/rtl_eeprom.c	EEPROM配置管理模块
r8125/r8125_ptp.c	精确时间同步(PTP)实现
build-script/build-r8125.sh	自动化编译脚本

💡 常见问题解决指南

编译失败：缺少依赖库

症状：make命令提示"xxx.h: No such file or directory"
解决：检查glibc开发包是否完整安装：

yum install glibc-devel.i686  # 安装32位兼容库

ESXi加载失败：版本不匹配

症状：esxcli system module load返回"module not found"
解决：确认驱动编译时使用的ESXi源码版本与目标主机版本一致（必须为6.7 Update 3）。

📝 项目许可与致谢

本项目基于Realtek官方源码与VMware开源组件构建，遵循GPLv2开源许可协议（完整许可文本见项目根目录LICENSE文件）。特别感谢VMware ODP项目提供的ESXi驱动开发框架支持。

通过以上步骤，您已成功在ESXi 6.7系统中部署Realtek RTL8125网卡驱动。如有功能需求或问题反馈，欢迎查阅项目源码中的r8125/rtltool.c工具源码进行二次开发。