掌握课程导论在课程导论中的定位、故障信号与验证顺序。
课程导论只有在出现源码、函数、脚本或 API 证据时，才需要进入代码层核对。
本节把课程导论对应的调用关系、异常状态和复测证据放在一起检查。
在数据中心或高性能计算（HPC）环境中，Mellanox ConnectX 系列网卡因其低延迟、高吞吐特性被广泛用于存储网络（如 NFS、iSCSI）或虚拟机直通（Passthrough）。然而，不少运维工程师在将 Mellanox 网卡安装到 ESXi 主机后，发现 esxcfg-nics -l 或 vSphere Client 的“网络适配器”列表中根本找不到该设备。这不是硬件损坏，而是 ESXi 驱动链与网卡固件之间的“握手失败”
某金融科技公司为提升交易系统响应速度，采购了一批 Mellanox ConnectX-5 双端口 25GbE 网卡。运维团队按标准流程安装到 Dell R750 服务器，并升级 ESXi 8.0 U2。重启后，lspci -v 能看到 PCIe 设备，但 esxcfg-nics -l 输出为空。尝试手动加载驱动 vmkload_mod 核心 报错“Module version mismatch”。该问题导致业务上线延迟 3 天，最终通过回退固件版本并安装特定 vib 包解决
本课程正是为解决此类“识别失败”场景而设计。课程覆盖 ESXi 7.0 U3 至 8.0 U3 版本，以及 Mellanox ConnectX-4 Lx、ConnectX-5、ConnectX-6 Dx 三款主流网卡型号。我们将从驱动栈原理出发，拆解识别失败的典型原因：固件不兼容、驱动 vib 缺失、PCIe ACS 限制、以及 UEFI 安全引导导致的驱动签名拒绝
ESXi 识别 Mellanox 网卡的核心障碍不是硬件损坏，而是 核心 驱动版本与网卡固件（FW）的匹配关系。ESXi 8.0 起强制驱动签名，未签名的社区驱动（如旧版 nmlx5-rdma）会被直接拦截
本课程按“识别→配置→验证”三阶段组织，每阶段对应一个工程检查点。第一阶段（本节及后续 2 节）聚焦于驱动栈的可见性：通过 lspci 确认 PCIe 设备、esxcli software vib list 检查驱动包、vmkload_mod -l 验证模块加载状态。第二阶段进入配置层，包括网卡固件升级、ESXi 原生驱动（Inbox Driver）与 OEM 驱动（Out-of-box Driver）的选型决策，以及 esxcli network nic 命令的参数调优。第三阶段以生产验收收尾，覆盖链路聚合（LACP）、SR-IOV 虚拟功能分配和 RDMA over Converged Ethernet（RoCE）的连通性测试
整个路径围绕一个核心工具链：vib 包管理 + 固件同步 + 驱动签名校验。我们不会泛泛讲解网络原理，而是直接操作真实命令和配置文件。例如，在驱动选型环节，你将学会用以下命令对比 Inbox 与 OEM 驱动的差异：
上述命令中，vsish 是 ESXi 的底层诊断接口，直接读取 PCIe 配置空间；esxcli software vib 则是驱动包管理的标准入口。两者结合能快速定位“驱动已装但固件不匹配”或“固件新但驱动旧”两类典型故障
拿到新网卡后，第一步不是插槽安装，而是登录 Broadcom（原 Mellanox）支持门户，下载对应 ESXi 版本的 nmlx5-rdma vib 包。同时记录网卡当前固件版本（通过 flint -d /dev/mst/mt4123_pciconf0 query 在 Linux 下读取），确保与 ESXi 驱动兼容矩阵匹配
完成本节及后续实战后，你将获得以下可复用的工程能力：
lspci -v 输出中的“Class”字段（如 0200 表示以太网控制器）和“Vendor ID”（15b3 为 Mellanox）快速判断设备是否被 ESXi 内核枚举esxcli software vib install -d /vmfs/volumes/datastore1/vib/ 离线安装esxcli network nic firmware update（仅限 ESXi 8.0+）或通过 Linux 工具 mstflint 在维护窗口升级固件，避免因固件版本滞后导致驱动加载失败不要认为“ESXi 自带驱动就能识别所有网卡”。Mellanox ConnectX-6 Dx 在 ESXi 7.0 U3 中需要额外安装 nmlx5-rdma vib，否则只能识别为标准以太网卡，无法启用 RoCE 和 SR-IOV。同样，不要盲目升级固件——ESXi 8.0 对 FW 18.x 的支持尚在验证阶段，生产环境建议锁定 FW 16.x 系列
本节作为课程导论，已为你划定了 ESXi 与 Mellanox 网卡交互的“可见性”边界。下一节将直接进入实战：通过 esxcfg-nics 和 vsish 工具，逐行解析网卡识别失败的日志信号，并给出可复现的修复步骤