ESXi 6.7 U3自定义镜像封装网卡驱动详细教程

前阵子帮朋友处理一批新采购的服务器，板载网卡是Realtek RTL8125BG 2.5G。我拿着ESXi 6.7 U3官方ISO过去装机，加载到网络配置那一步直接卡住——集合管理网络的界面里根本看不到网卡。朋友在旁边问："是不是你镜像没写对？"我反复确认了写盘无误，问题就在镜像本身：2.5G网卡这种近几年的硬件，在vSphere 6.7 U3标准镜像里根本没有内置驱动。最后是靠把网卡驱动封装进安装镜像，做了个自定义ISO才顺利装完。这篇博文就把整个封装流程、环境准备、报错排查完整记录下来，给还在维护vSphere 6.7生产环境的同行一个可以直接照做的参考。

这事想解决的核心就一件事：ESXi不是Linux，驱动必须预置在镜像里，系统装完通过esxcli注入是另一个路子，但解决不了安装阶段识别网卡的问题。如果你正被"安装时找不到网卡""网卡在HCL里没有""想批量部署新机器但镜像不认硬件"这类问题困扰，这篇文章拆出来的方法可以直接复用。下面我按实际操作的顺序来写，从原理讲到命令再讲到踩坑，尽量把该说的说透。

1. 为什么ESXi 6.7 U3的官方镜像里就是缺这块驱动

1.1 ESXi的驱动机制和常规Linux发行版不一样

很多人第一次碰到ESXi不识别网卡时，第一反应是"装完系统之后装个Linux驱动不就行了"。这个思路在Linux上没错，在ESXi上行不通。ESXi不是跑在通用内核之上的常规系统，它的体系结构是一个叫VMkernel的微内核，所有硬件驱动必须以VIB包（VMware Installation Bundle）的形式在系统镜像里预先打包好，开机时由VMkernel加载。

也就是说，驱动不在镜像里，系统在安装阶段就无法生成管理网络，连安装后的配置界面都进不去。ESXi安装向导里"配置管理网络"那一步就是硬性依赖网卡驱动的，找不到vmnic，安装流程直接卡住。这跟Linux下"系统装完再装驱动"的玩法是两回事。

另外一个特点是，ESXi内核模块不能像Windows那样允许厂商随便发布一个exe安装程序。驱动必须打包成符合VMware规范的结构，包含VIB元数据、签名信息、以及对应ESXi版本的构建标记。这也是为什么你去网卡厂商官网下载ESXi驱动时，看到的往往是offline bundle zip文件或者单个vib文件，而不是一个setup.exe。

1.2 官方镜像覆盖的是"认证过的硬件"，不是所有网卡

VMware对硬件的支持有一套很严格的HCL（硬件兼容性列表）认证流程。厂商要把网卡送到VMware做兼容性验证，验证通过后才可能被纳入后续版本的驱动库。问题在于：

• 服务器网卡更新迭代速度快，一款新网卡从发布到通过HCL认证，中间有几个月甚至更长的周期。
• 很多消费级或半白牌设备用的网卡（比如Realtek 8125系列、Intel I225-V这类2.5G网卡）根本不会进入服务器级HCL认证流程。
• 官方ISO发布后就冻结了驱动集，后续补丁版本虽然会增加一些驱动，但不可能覆盖所有市面上出现的网卡。

所以"官方最新版本"不等于"支持所有网卡"。尤其是6.7 U3这个版本，发布于2019年，后来虽然有补丁更新，但主打稳定性，新增硬件驱动非常有限。你现在拿一台用2.5G网卡或较新万兆网卡的机器去装，识别不了太正常了。

1.3 为什么还要守着6.7 U3折腾

我问过自己一个问题：都vSphere 8的时代了，为什么不直接换新版本？现实原因是很多生产环境没法平滑升级。例如：

• 老一代CPU（Haswell、Broadwell等）在vSphere 8里已经不在支持列表内，但跑虚拟化业务完全够用。
• 现有的vCenter版本、第三方备份软件、监控Agent都绑定在6.7上，升级涉及一大圈兼容性验证。
• vSphere 6.7 U3是6.7分支的最终大版本，生命周期拉到了很长时间，存量环境非常巨大。

在这些约束下，给6.7 U3做一个附带新网卡驱动的自定义镜像，是投入最小、见效最快的方案。用同一套ISO还能做PXE批量部署，后续装机都走这个镜像，一劳永逸。

2. 封装前先搞清楚工具选型和驱动来源

2.1 ESXi-Customizer和PowerCLI两条路线怎么选

网上关于ESXi封装网卡驱动的教程并不少，常见的是用ESXi-Customizer这个GUI小工具。这个工具在ESXi 5.x、6.0时代确实好用，把官方ISO和驱动zip拖进去点一下就能生成新ISO。但在6.7 U3较新的build上，我实测会碰到解析不了ISO结构、界面卡死、生成出来的镜像引导失败等一堆问题。原因很简单：这个社区工具更新滞后，对新版ESXi镜像格式的支持不完整。

相比之下，VMware官方PowerCLI里封装了一套完整的Image Profile管理命令，专门用来做自定义镜像。这一步推荐用PowerCLI，原因有三：

• 官方持续维护，兼容性有保障。
• 命令流程清晰，可以脚本化，同样的操作在几十台不同型号的服务器上能复用。
• 出错时能拿到详细报错信息，排查效率高。

当然PowerCLI也有个学习门槛，但我下面会把关键命令一条条写清楚，照着执行就行。

2.2 网卡驱动文件从哪下载才靠谱

做封装之前，先得拿到正确的驱动包。我建议按优先级从这几个渠道获取：

1. 网卡芯片厂商官网。比如Realtek官网提供ESXi驱动的下载页面，Intel的下载中心也能按"ESXi 6.7"过滤驱动。厂商标明支持6.7的驱动，封装后兼容性最可靠。
2. 服务器OEM厂商支持页面。如果是品牌服务器（戴尔、惠普、联想等），它们会对自家网卡提供专门的VIB包，这类驱动经过OEM测试，稳定性也不错。
3. 虚拟化社区整合包。这类包覆盖面广，但VIB的Acceptance Level通常是CommunitySupported，签名级别低，生产环境使用前要自己评估风险。

不管从哪个渠道下载，一定要看清驱动包支持的ESXi版本。6.7用的VIB不能拿8.0的去塞，反之也同理。下载下来的文件通常是zip格式，里面是offline bundle，包含一个或多个vib文件。下面所有操作都以这种offline bundle zip为输入。

2.3 封装环境的版本搭配建议

封装ESXi镜像的操作本质上是在PowerCLI里对软件depot做离线处理，不需要连接vCenter或ESXi主机，这点很多人会误解。我用的环境组合是Windows 10 + PowerShell 5.1 + VMware PowerCLI 12.x，全程跑下来很稳。新版PowerCLI 13在Windows上也兼容，但个别命令的模块加载方式有调整。

PowerShell版本建议5.1或以上，PowerCLI版本建议11以上，太老版本的PowerCLI对6.7 U3后期build的识别会出问题。

3. 实战过程：PowerCLI命令行封装自定义ISO

3.1 先把PowerCLI环境跑起来

以管理员身份打开PowerShell，先确认执行策略，再安装PowerCLI模块：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser Install-Module -Name VMware.PowerCLI -Scope CurrentUser

安装完成后导入模块：

Import-Module VMware.PowerCLI

提示是否开启CEIP、是否允许自动更新等交互，直接用Set-PowerCLIConfiguration关掉，避免干扰：

Set-PowerCLIConfiguration -ParticipateInCEIP $false -Confirm:$false

这里有人会习惯性地去Connect-VIServer，我再说一遍：创建自定义镜像不需要连接任何服务器，完全是离线操作，别在连接服务器上浪费时间。

3.2 导入官方offline bundle和网卡驱动bundle

做ESXi镜像封装，官方镜像建议下载ZIP格式的offline bundle，而不是直接拿ISO文件去导入。官方下载页提供两种格式：ISO镜像和Offline Bundle ZIP。PowerCLI的Add-EsxSoftwareDepot命令能直接加载zip离线包，拿ISO反而要多一步转换。

Add-EsxSoftwareDepot -DepotUrl C:\ESXi-Image\VMware-VMvisor-Installer-6.7.0-update03-14320384-x86_64.zip

接着导入网卡驱动offline bundle：

Add-EsxSoftwareDepot -DepotUrl C:\ESXi-Image\RTL8125-ESXi6.7-offline_bundle.zip

导入成功后，用Get-EsxSoftwareDepot能看到当前内存里的depot列表，用Get-EsxSoftwarePackage可以列出depot里所有的VIB包，过滤出网卡相关的：

Get-EsxSoftwarePackage | Where-Object {$_.Name -like "*net*"}

这一步很有用，能确认驱动VIB在depot里的准确名称。比如Realtek的驱动包，VIB名字可能是net-r8125，Intel的可能是net-i40e或net-ixgbe，不同厂商命名风格差异很大，先查一遍再添加，避免后面写错软件包名。

3.3 克隆镜像Profile并添加驱动VIB

ESXi官方镜像里的设备和驱动配置，在PowerCLI里体现为Image Profile。我们不能直接在系统自带的profile上改，而是克隆一份出来，在自己的profile上做增减，这样出现问题随时可以重新克隆，不会污染原配置。

先用Get-EsxImageProfile查看当前depot里有哪些profile：

Get-EsxImageProfile

6.7 U3对应的标准profile通常是ESXi-6.7.0-201908001-standard，或者带no-tools后缀的变体。确认名字后克隆：

New-EsxImageProfile -CloneProfile "ESXi-6.7.0-201908001-standard" -Name "ESXi-6.7U3-RTL8125-Custom" -Vendor "myself"

-Vendor参数可以随便写，它只是标记自定义profile的厂商信息，最终会显示在镜像信息里，方便区分。

然后把之前查到的网卡驱动VIB加进去：

Add-EsxSoftwarePackage -ImageProfile "ESXi-6.7U3-RTL8125-Custom" -SoftwarePackage "net-r8125"

如果驱动offline bundle里有多个依赖VIB需要一并添加，继续重复上面的命令即可。

3.4 导出ISO并核对生成结果

驱动加完后，导出ISO：

Export-EsxImageProfile -ImageProfile "ESXi-6.7U3-RTL8125-Custom" -ExportToIso -FilePath C:\ESXi-Image\ESXi-6.7U3-RTL8125-Custom.iso

命令执行完后会显示ISO生成路径。我建议顺手做两个核对动作：

1. 用Get-EsxImageProfile -Name "ESXi-6.7U3-RTL8125-Custom"确认profile里已经有网卡驱动VIB。
2. 到文件系统里看ISO文件大小是否正常。ESXi的完整安装ISO通常有几百MB，如果生成出来的ISO只有几十MB甚至几MB，说明中间出问题了，重新走一遍流程。

还有个最笨但最稳的验证方法：把ISO挂载到虚拟机或直接用UltraISO打开，看里面VMWARE.BOM文件以及vib目录结构是否完整。不过多数情况下，导出完成后文件大小正常就没问题。

4. 实际封装过程中最容易翻车的几个点

4.1 VIB签名级别导致的拒绝安装

第一次封装时我遇到过一个很经典的报错：

A specified acceptance level of the package is not accepted by the image profile.

这句话的意思是：驱动VIB的Acceptance Level（接受级别）比当前镜像profile的级别要求更宽松，系统出于安全性考虑拒绝了添加操作。

VMware对VIB有个四级签名体系：VMwareCertified（最严格）、VMwareAccepted、PartnerSupported、CommunitySupported（最宽松）。ESXi官方镜像默认的profile接受级别通常是VMwareAccepted。社区版网卡驱动一般只做到PartnerSupported甚至CommunitySupported，就会触发这个报错。

解决办法是把自定义profile的接受级别调整成对应的级别。比如驱动是CommunitySupported，就执行：

Set-EsxImageProfile -ImageProfile "ESXi-6.7U3-RTL8125-Custom" -AcceptanceLevel CommunitySupported

然后再重新添加VIB。

这里我必须提醒一句：把Acceptance Level降到CommunitySupported意味着绕过了VMware的签名校验，这是社区驱动的必然代价。在测试环境随便玩无所谓，生产环境要评估驱动来源的可信度，至少确认是从官网或可靠渠道下载的，别把网上随便来的vib塞进生产镜像。

4.2 报依赖包缺失时怎么办

有次我封装一个万兆网卡驱动，添加VIB时弹出一长串依赖错误。原因是那个驱动包依赖了别的内核模块或公共库，而我只手动添加了核心VIB，没有把依赖也加进去。

遇到这种情况，我的处理顺序是：

1. 先看报错信息里列出的缺失依赖包名称。
2. 回到Get-EsxSoftwarePackage的输出里查找这些依赖包是否在同一个offline bundle里。
3. 如果存在，用Add-EsxSoftwarePackage依次添加。
4. 如果不存在，说明驱动离线包本身不完整，需要去厂商官网找完整的bundle，或换一个驱动版本。

PowerCLI的Add-EsxSoftwarePackage不会自动递归安装依赖，这一点跟Linux的yum/apt不太一样。手动添加时要有耐心，按依赖关系一层层加完。

4.3 同一个Profile名字反复报已存在

封装过程中如果修改了方案，想重新创建一个同名profile，会报"profile already exists"。原因很简单：PowerCLI当前会话里还留着上一次创建的profile对象。

处理方法是用Remove-EsxImageProfile清理：

Remove-EsxImageProfile -ImageProfile "ESXi-6.7U3-RTL8125-Custom" -Force

如果不想删除，也可以每次换一个带序号的名字，比如ESXi-6.7U3-RTL8125-Custom-2。我自己的习惯是用日期后缀，避免旧profile堆积，也方便回溯不同时间点的封装版本。

4.4 封装出来的ISO引导失败的教训

有一段时间我用ESXi-Customizer封装，生成的ISO在服务器上引导直接报错，卡在bootloader阶段。排查下来的结论是：旧工具生成的ISO在UEFI引导路径上不完整。新出的服务器很多默认UEFI启动，而老工具生成的镜像可能只处理了BIOS引导文件，导致UEFI模式下找不到引导项。

后来换PowerCLI导出ISO后，这种问题彻底消失。所以如果你手里的机器必须UEFI引导，建议直接走PowerCLI，别在GUI工具上纠结。另外注意下载驱动包时，有的厂商会分"for ESXi 6.x"和"for ESXi 7.x/8.x"，一定要选对应版本，不然VIB在6.7镜像里连签名校验都过不去。

5. 自定义ISO装完系统后的验证与日常维护

5.1 安装阶段如何判断驱动已经生效

用自定义ISO启动服务器后，走到"Configure Management Network"这一步，正常情况下能在网卡列表里看到之前的vmnic0、vmnic1等设备。如果还是看不到网卡，问题大概率出在驱动VIB没真正加进镜像里，回到第2、3步重新检查。

还有个小技巧：在安装引导界面按Shift+O可以追加内核参数，但ESXi不是Linux，调试手段有限。最直接的方式还是确认镜像profile里有驱动VIB，然后看安装向导能不能看到管理网络。我的经验里，只要安装向导能看到网卡并配置IP，后面基本就顺了。

5.2 用esxcli检查驱动加载状态

系统装完、能ping通管理IP后，建议登录到ESXi的console或者通过SSH确认驱动加载情况。

先看网卡列表：

esxcli network nic list

输出里能看到每个vmnic的名称、速率、驱动名称。如果我封装的RTL8125驱动正常加载，这里会显示驱动名比如r8125，速率显示2500Mbps。

再看VIB安装列表：

esxcli software vib list | grep -i "net-r8125"

确认VIB名字、版本号、是否处于vib Installed状态。

另外检查驱动对应的内核模块是否加载：

vmkload_mod -l | grep -i r8125

这几条命令组合下来，驱动状态一目了然。

5.3 已经装好ESXi但没驱动时，可以直接注入VIB

如果你的环境里ESXi系统本身已经装好了，但网卡后来换了一块新的、当前系统里没有驱动，不需要重装系统，也不需要重新封装ISO，直接用esxcli把驱动离线包打进去即可。

把离线bundle zip上传到ESXi可访问的数据存储后，执行：

esxcli software vib install -d /vmfs/volumes/datastore1/drivers/net-r8125-offline_bundle.zip

如果VIB签名级别不匹配，加上强制参数：

esxcli software vib install -d /vmfs/volumes/datastore1/drivers/net-r8125-offline_bundle.zip --no-sig-check -f

装完后重启主机让驱动加载。

这种方式适合单台机器应急，但如果要做批量部署、PXE安装，还是我上面讲的封装ISO路线更高效。两条路都掌握，应对不同场景才游刃有余。

5.4 后续补丁版本怎么跟进

自定义ISO封装好之后，不等于永远管用。ESXi 6.7虽然进入了生命周期末期，但VMware仍会不定期发布补丁更新（安全补丁、bug fix）。如果你长期维护这个环境，建议关注两个维度：

1. 镜像版本跟进：当官方发布新的6.7补丁zip时，重新下载offline bundle，用同样的PowerCLI命令克隆新版本的profile，把网卡驱动VIB再添加进去，重新导出ISO。这样能保证新部署的机器既带最新补丁，又带自定义驱动。
2. 驱动版本跟进：网卡厂商如果发布修复bug或提升性能的新版驱动，同样可以更新到Image Profile里。更新前先看驱动发布说明，确认是否修复了你遇到过的问题，没必要频繁升级。

封装驱动的整体思路并不复杂，难点在于环境匹配和细节处理。我实际操作时踩过不少坑，最深的体会是：做这种事情一定要用官方工具链，尽量少依赖第三方小工具。PowerCLI虽然命令多、上手稍麻烦，但每一个操作都有明确反馈，出问题能追根溯源。ESXi 6.7 U3作为生产环境里的常青树，合理封装驱动后，在新硬件上继续服役几年完全没问题。如果你也碰到网卡不识别、安装卡在网络配置这类情况，按上面这套流程走一遍，基本都能解决。