在部署 VMware Cloud Foundation(VCF)5.x 版本时，若选择 vSAN 快速存储架构(ESA)作为主存储，系统会强制进行硬件兼容性列表(HCL)校验，非认证硬件将直接阻断部署。这一机制虽能保障生产环境稳定，但在实验室测试、POC 验证等非生产场景中，却因硬件限制带来诸多不便。VCF 5.2.2 版本新增专属配置参数，无需修改 ESXi 主机配置，即可轻松绕过该校验，将错误提示转为警告并继续部署流程。本文将详细拆解部署阶段与主机添加阶段的操作步骤，帮助用户高效完成非生产环境搭建。
一、功能背景与核心优势
vSAN ESA 作为 VMware 新一代快速存储架构，凭借高效性能成为 VCF 部署的优选存储方案。按照官方设计，生产环境部署时会强制校验硬件是否符合 vSAN ESA HCL 标准，避免因硬件不兼容导致系统故障、数据丢失等问题。但在非生产场景中，用户常需使用未认证硬件进行功能测试或方案验证，传统解决方式需为每台 ESXi 主机安装 vSAN ESA Hardware Mock VIB 插件，步骤繁琐且易出错，重启后配置还可能失效。
VCF 5.2.2 版本的优化方案彻底解决了这一痛点：通过添加简单配置参数，即可将 HCL 校验错误转为警告，无需额外安装插件，也无需修改 ESXi 主机任何设置，操作仅需两步即可完成，大幅提升非生产环境的部署效率与灵活性。
二、部署阶段：Cloud Builder 绕过 HCL 检查操作
当使用 Cloud Builder 部署 VCF 5.2.2 实例时，默认仍会执行 vSAN ESA HCL 校验，按以下步骤可快速绕过：
1. 远程连接 Cloud Builder 设备
准备 SSH 工具(如 Xshell、Putty、FinalShell 等)，输入 Cloud Builder Appliance 的 IP 地址、管理员账号(默认 admin)及登录密码。
登录成功后，切换至 root 用户权限(部分环境需执行sudo -i命令)，确保具备修改系统配置文件的权限。
2. 配置参数并重启服务
在 SSH 命令行中依次执行以下两条命令，完成参数配置与服务重启：
# 向配置文件追加绕过校验参数 echo "vsan.esa.sddc.managed.disk.claim=true" >> /etc/vmware/vcf/bringup/application.properties # 重启VCF部署核心服务 systemctl restart vcf-bringup命令执行后，等待 30 秒左右让服务完全重启(可通过systemctl status vcf-bringup命令检查服务状态，显示 "active" 即表示重启成功)。
此时返回 Cloud Builder 部署界面，原有的 HCL 校验错误已转为警告提示，无需额外操作即可继续推进 VCF 部署流程。
三、部署后：添加主机阶段绕过 HCL 检查操作
当 VCF 实例部署完成后，向现有管理域添加新 ESXi 主机，或创建使用 vSAN ESA 的工作负载域时，会再次触发 HCL 校验。需通过修改 SDDC Manager 配置实现绕过，步骤如下：
1. 远程连接 SDDC Manager 设备
同样使用 SSH 工具，输入 SDDC Manager Appliance 的 IP 地址、管理员账号及密码，完成登录并切换至 root 用户。
2. 配置参数并重启 SDDC Manager 服务
在 SSH 命令行中依次执行以下三条命令，向两个核心配置文件添加参数并重启服务：
# 向域管理配置文件添加参数 echo "vsan.esa.sddc.managed.disk.claim=true" >> /etc/vmware/vcf/domainmanager/application-prod.properties # 向操作管理配置文件添加参数 echo "vsan.esa.sddc.managed.disk.claim=true" >> /etc/vmware/vcf/operationsmanager/application-prod.properties # 重启SDDC Manager所有相关服务(自动确认重启操作) echo 'y' | /opt/vmware/vcf/operationsmanager/scripts/cli/sddcmanager_restart_services.sh服务重启过程约需 1-2 分钟，可通过 SDDC Manager 管理界面查看服务状态，或执行专属状态检查命令确认重启成功。
配置完成后，即可正常完成新 ESXi 主机的 commissioning 操作，以及工作负载域的创建，HCL 校验将不再阻断流程。
四、重要注意事项
适用场景限制：本教程的配置方法仅适用于非生产环境(实验室测试、POC 验证等)。生产环境部署时，必须使用 vSAN ESA HCL 认证硬件，严格遵守官方兼容性要求，避免因硬件不兼容引发系统稳定性问题、数据安全风险或失去官方技术支持。
操作权限要求：修改配置文件和重启服务的操作需具备 root 或管理员权限，建议操作前备份相关配置文件(如执行cp /etc/vmware/vcf/bringup/application.properties /etc/vmware/vcf/bringup/application.properties.bak)，避免误操作导致系统故障。
服务状态核查：执行重启命令后，务必通过命令行或管理界面确认服务正常启动。若服务启动失败，可查看日志文件(如 Cloud Builder 的/var/log/vmware/vcf/bringup/vcf-bringup.log)排查错误原因，必要时恢复备份的配置文件后重新操作。
版本兼容性：该绕过功能仅适用于 VCF 5.2.2 版本，低版本用户需先升级至 5.2.2 后再执行上述操作，升级前请做好数据备份与环境评估。
本文已详细覆盖 VCF 5.2.2 版本绕过 vSAN ESA HCL 检查的全场景操作，步骤清晰且无需复杂技术储备。若你在实操过程中遇到命令执行失败、服务重启异常等问题，或需要了解低版本 VCF 的兼容方案、生产环境硬件选型建议，欢迎随时告知具体情况，我会为你提供进一步的技术支持。
