核心用法
vmware-harden 是一款面向 vSphere/ESXi/NSX 环境的 AI-native 合规审计工具，专用于基线检查、合规扫描与配置漂移检测。用户通过 uv tool install vmware-harden 安装后，可执行六大类操作：
1. 基线管理：内置 6 套权威基线（CIS ESXi 8.0、vSphere SCG v8、等保 2.0 三级、PCI-DSS 4.0、BSI ITGS、EU NIS2），同时支持自定义 YAML 基线导入与验证
2. 合规扫描：多采集器聚合（vCenter、ESXi、NSX、vSAN、K8s）→ 写入本地 Twin DuckDB，生成结构化违规报告
3. 漂移检测：快照对比算法，识别 per-node 的新增/删除/变更字段，支持跨时间线追踪配置演变
4. 修复建议：集成 Anthropic Claude API，为每条违规生成上下文感知的修复步骤；无 API Key 时回退至模板化建议
5. Web 仪表板：FastAPI + Jinja2 构建的只读可视化界面，支持违规排序、漂移时间线浏览
6. MCP 集成：6 个只读工具（list_baselines、scan_target、get_remediation 等），专为 AI Agent 设计
典型工作流：先确保 vmware-aiops 采集器就绪 → vmware-harden baseline list 确认基线 → scan --baseline dengbao-2.0-level3-vmware --target prod-vcenter 执行扫描 → web 启动仪表板审阅结果，或由 AI Agent 通过 MCP 查询违规详情。
显著优点
- 权威基线开箱即用：覆盖国际主流标准（CIS、DISA STIG、PCI-DSS）与国内等保 2.0 三级，减少合规研究成本
- 架构安全隔离：全程只读扫描，修复执行被强制解耦至
vmware-pilot（带审批门控），避免误操作 - AI 驱动建议质量：LLM 基于实际证据（Typed Twin 查询结果）生成修复步骤，非通用模板；输入经
_sanitize()处理（截断 500 字符、剥离控制字符），降低提示注入风险 - 多模态使用场景：CLI 适合 CI/CD 门禁，Web 适合人工审阅，MCP 适合 Agent 自动化，三者共享同一 DuckDB 状态
- 开源可审计：MIT 许可证，源码托管于 GitHub，无黑盒逻辑
潜在缺点与局限性
- 依赖上游采集器：无法独立连接 vCenter/NSX，必须预先配置
vmware-aiops采集目标；采集器失效则扫描中断 - 等保基线覆盖率受限：等保 2.0 三级规则引用多类节点（vCenter 高级设置 + ESXi NTP + NSX DFW），若未启用全部采集器，对应规则会被标记为 "skipped"
- 修复建议非即时生效：LLM 建议仅为文本，实际变更需人工通过
vmware-pilot执行，自动化程度受限 - 外部 API 依赖：高质量建议依赖
ANTHROPIC_API_KEY，无 Key 时降级为模板化输出，可能降低实用价值 - 本地状态单点：Twin DuckDB 为本地文件，多节点部署时需自行同步或指定
VMWARE_HARDEN_DB环境变量
适合人群
- 安全合规团队：需定期输出 CIS/等保/PCI-DSS 合规报告的企业安全工程师
- vSphere 运维工程师：负责基线加固、配置漂移追踪的虚拟化管理员
- DevSecOps 工程师：寻求将 VMware 合规检查集成至 CI/CD 流水线的自动化实践者
- AI Agent 开发者：需要结构化合规数据作为 RAG 上下文或决策输入的 Agent 构建者
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 误报风险 | 等保规则因采集器缺失证据而跳过，可能被误判为合规 | 扫描前运行 `vmware-aiops doctor` 确认全量采集器就绪 |
| 数据一致性风险 | `VMWARE_HARDEN_DB` 环境变量不一致导致 CLI 写入与 Web 读取分离 | 使用绝对路径，systemd/launchd 单元中显式注入变量 |
| 建议时效性风险 | LLM 建议基于某次扫描快照，目标环境已变更后建议可能过时 | 建立定期扫描 CronJob，漂移检测触发重新建议 |
| 供应链风险 | `uvx` 在企业 TLS 代理环境可能触发 UnknownIssuer | 改用 `uv tool install` 后的入口点 `vmware-harden-mcp`，或设置 `UV_NATIVE_TLS=true` |
| 权限扩散风险 | 虽 MCP 工具只读，但 DuckDB 文件权限若配置不当可能被非授权读取 | 确保 `~/.vmware-harden/` 目录权限为 700，审计日志启用 `vmware-policy` |