ESXI连接和虚拟机清单整理经验

# ESXI连接和虚拟机清单整理经验

## 背景

双流线下机房有多台 ESXI 宿主机，需要用命令行批量连接、导出虚拟机清单，并把物理机和虚拟机整理进知识库。

## 连接方式

| 方式 | 适用场景 | 本次结论 |
| --- | --- | --- |
| Web UI | 日常登录、查看虚拟机、调整配置 | 7 台 ESXI 的 `443` 管理口可用 |
| govc | 批量查询、自动化导出虚拟机清单 | 推荐方式 |
| SSH | 主机命令行维护 | 仅部分宿主机开启 |
| 远程控制页面 | 带外管理、重启、进 BIOS | 按单机页记录 |

详细连接信息见 [[02-系统运维/运维系统/esxi/双流_esxi_连接方式]]。

## govc 安装与验证

本机 govc：

```shell
command -v govc
govc version
```

本次结果：

| 项目 | 内容 |
| --- | --- |
| govc 路径 | `/opt/homebrew/bin/govc` |
| govc 版本 | `0.55.1` |

## govc 连接方式

不要把账号密码直接拼在 URL 里，尤其密码包含 `#` 时会被当作 URL fragment。建议用环境变量分开传：

```shell
export GOVC_INSECURE=1
export GOVC_URL='https://10.2.8.165/sdk'
export GOVC_USERNAME='root'
export GOVC_PASSWORD='Linux@123.0#'

govc about
govc host.info
govc ls
govc find / -type m
```

判断标准：

- `govc about` 能返回 VMware ESXi 版本，说明认证和 API 可用。
- `govc host.info` 能返回宿主机硬件信息。
- `govc find / -type m` 能列出虚拟机路径。

## 本次验证过的 ESXI

| ESXI | govc 状态 | 版本 |
| --- | --- | --- |
| `10.2.8.21` | 正常 | VMware ESXi 7.0.1 build-16850804 |
| `10.2.8.30` | 正常 | VMware ESXi 7.0.3 build-20328353 |
| `10.2.8.94` | 正常 | VMware ESXi 8.0.0 build-20513097 |
| `10.2.8.165` | 正常 | VMware ESXi 8.0.0 build-20513097 |
| `10.2.8.215` | 正常 | VMware ESXi 8.0.0 build-20513097 |
| `10.2.8.246` | 正常 | VMware ESXi 6.7.0 build-11675023 |
| `10.2.9.169` | 正常 | VMware ESXi 8.0.0 build-20513097 |

## 虚拟机清单导出思路

### 1. 列出虚拟机路径

```shell
govc find / -type m
```

### 2. 查询虚拟机详情

```shell
govc vm.info -json '<vm-path>'
```

重点字段：

| 字段 | 用途 |
| --- | --- |
| `Name` | 虚拟机名称 |
| `Runtime.PowerState` | 电源状态 |
| `Guest.IpAddress` | VMware Tools 上报 IP |
| `Guest.GuestFullName` | 操作系统 |
| `Config.Hardware.NumCPU` | CPU |
| `Config.Hardware.MemoryMB` | 内存 |
| `Guest.ToolsStatus` | VMware Tools 状态 |
| `InventoryPath` | VM 路径 |

### 3. 汇总到 CSV

本次导出目录：

```text
temp/esxi-vm-export/
└── esxi-vm-summary.csv
```

总清单写入：

- [[02-系统运维/运维系统/esxi/双流_esxi_虚拟机清单]]
- [[03-平台管理/双流线下机房/虚拟服务器/虚拟服务器清单]]

## 知识库落档规则

### 物理机

每台 ESXI 宿主机写一篇物理机档案：

```text
03-平台管理/双流线下机房/物理服务器/10.2.8.30.md
```

物理机档案至少包含：

- 基本信息：型号、用途、CPU、内存、磁盘、GPU。
- ESXI 登录信息。
- 承载虚拟机表。
- 到运维系统 ESXI 页面的链接。

### 虚拟机

每台虚拟机写一篇虚拟机档案。优先用 IP 命名：

```text
03-平台管理/双流线下机房/虚拟服务器/虚拟机/10.2.8.222.md
```

无 IP 的虚拟机用 `无IP-宿主机IP-虚拟机名.md` 命名：

```text
03-平台管理/双流线下机房/虚拟服务器/虚拟机/无IP-10.2.8.21-bigdata-test-01.md
```

虚拟机档案至少包含：

- 虚拟机名称。
- IP。
- 电源状态。
- 操作系统。
- CPU / 内存。
- VMware Tools 状态。
- 所在宿主机。
- VM 路径。

## 双链规则

- 物理机档案里列出承载虚拟机。
- 虚拟机档案里链接回所在宿主机。
- `双流_esxi_虚拟机清单` 同时链接物理机和虚拟机。
- `双流线下机房总览` 链接物理服务器清单和虚拟服务器清单。

注意：Markdown 表格里尽量不要使用“路径加 alias 的双链写法”，容易让表格列被 `|` 打断。建议写成：

```markdown
[[03-平台管理/双流线下机房/物理服务器/10.2.8.30]]（10.2.8.30）
```

## SSH 经验

只有部分宿主机开放 SSH。本次记录：

| ESXI | SSH |
| --- | --- |
| `10.2.8.165` | 可用 |
| `10.2.9.169` | 可用 |
| 其他宿主机 | 多数拒绝连接 |

示例：

```shell
sshpass -p 'Linux@123.0#' ssh root@10.2.8.165 'vmware -v; hostname'
```

SSH 适合少量主机命令行维护，批量资产采集仍优先使用 govc。

## 经验结论

- ESXI 批量整理优先走 govc，不依赖 SSH 是否开启。
- 密码包含特殊字符时，使用 `GOVC_USERNAME` / `GOVC_PASSWORD` 分开传。
- 虚拟机能取到 IP 就用 IP 命名，取不到 IP 就用 `无IP-宿主机IP-虚拟机名` 命名。
- 物理机与虚拟机必须双向链接，否则后续排查“这台 VM 跑在哪个宿主机上”会很痛苦。
- 导出完成后要做一次链接检查和表格检查。

## 适用位置

- [[02-系统运维/运维系统/esxi/双流_esxi]]
- [[02-系统运维/运维系统/esxi/双流_esxi_连接方式]]
- [[02-系统运维/运维系统/esxi/双流_esxi_虚拟机清单]]
- [[03-平台管理/双流线下机房/双流线下机房总览]]
- [[03-平台管理/双流线下机房/物理服务器/ESXI物理服务器清单]]
- [[03-平台管理/双流线下机房/虚拟服务器/虚拟服务器清单]]