# VMware ESXi中扩展Home Assistant OS硬盘空间指南

## 概述
本文档介绍如何在VMware ESXi环境中将通过OVA方式安装的Home Assistant OS虚拟机硬盘从32GB扩展到500GB。

## 前提条件
- VMware ESXi 5.5 或更高版本
- 已安装的Home Assistant OS虚拟机
- ESXi主机有足够的存储空间（至少500GB可用）
- 管理员权限访问ESXi Web界面

## 操作步骤

### 步骤1：准备工作
1. **创建虚拟机快照**（强烈建议）
   - 在ESXi Web界面中选择Home Assistant虚拟机
   - 点击"操作" → "创建快照"
   - 输入快照名称：`扩容前备份_YYYY-MM-DD`
   - 点击"创建快照"

2. **完全关闭虚拟机**
   - 在Home Assistant界面中选择"系统" → "重启系统"
   - 选择"关机"选项
   - 或在ESXi界面中选择虚拟机，点击"关闭电源"
   - ⚠️ **重要**：确保是完全关闭，不是挂起状态

### 步骤2：在ESXi中扩展硬盘
1. **进入虚拟机编辑模式**
   - 在ESXi Web界面中右键点击Home Assistant虚拟机
   - 选择"编辑设置"

2. **修改硬盘容量**
   - 在虚拟硬件列表中找到"硬盘1"
   - 当前显示为"32 GB"
   - 将数值改为"500"，单位保持"GB"
   - 点击"保存"

3. **确认更改**
   - 检查虚拟机设置中硬盘容量已显示为500GB
   - 关闭编辑窗口

### 步骤3：启动虚拟机
1. **启动Home Assistant**
   - 点击虚拟机的"开启电源"按钮
   - 等待Home Assistant完全启动
   - 通过Web界面确认系统正常运行

### 步骤4：扩展文件系统
虚拟硬盘已扩展，但操作系统还需要识别并使用新增空间。

#### 方法1：使用Home Assistant内置工具（推荐）
1. **访问Home Assistant终端**
   - 在Home Assistant Web界面中
   - 进入"设置" → "附加组件" → "Advanced SSH & Web Terminal"
   - 如果没有安装，需要先安装SSH附加组件

2. **执行扩展命令**
   ```bash
   # 查看当前磁盘使用情况
   df -h
   
   # 扩展根分区（通常是/dev/sda8）
   resize2fs /dev/sda8
   
   # 再次查看磁盘使用情况，确认扩展成功
   df -h
   ```

#### 方法2：使用SSH连接（备选）
1. **启用SSH**
   - 在Home Assistant Web界面中启用SSH功能
   
2. **通过SSH连接**
   ```bash
   # 连接到Home Assistant
   ssh root@[Home_Assistant_IP]
   
   # 查看磁盘分区
   fdisk -l
   
   # 扩展文件系统
   resize2fs /dev/sda8
   ```

### 步骤5：验证扩展结果
1. **检查存储空间**
   - 通过SSH或终端执行命令：`df -h`
   - 或在Home Assistant Web界面中进入"设置" → "系统" → "存储"
   - 确认可用空间接近500GB

   **成功案例输出示例：**
   ```bash
   ➜  ~ df -h
   Filesystem                Size      Used Available Use% Mounted on
   /dev/sda8               491.4G      5.4G    466.0G   1% /homeassistant
   /dev/sda8               491.4G      5.4G    466.0G   1% /data
   /dev/sda8               491.4G      5.4G    466.0G   1% /backup
   /dev/sda8               491.4G      5.4G    466.0G   1% /media
   /dev/sda8               491.4G      5.4G    466.0G   1% /share
   ```
   可以看到 `/dev/sda8` 分区已成功扩展到 **491.4GB**，可用空间 **466.0GB**。

2. **验证系统稳定性**
   - 重启Home Assistant系统
   - 确认所有功能正常工作
   - 检查日志中无错误信息

## 故障排除

### 问题1：虚拟机无法启动
**解决方案：**
- 检查ESXi主机存储空间是否充足
- 恢复到扩容前的快照
- 重新执行扩容步骤

### 问题2：文件系统扩展失败
**解决方案：**
```bash
# 检查文件系统
fsck /dev/sda8

# 强制扩展
resize2fs -f /dev/sda8
```

### 问题3：扩展后空间未显示
**解决方案：**
- 重启Home Assistant系统
- 检查分区表：`fdisk -l`
- 手动扩展分区：`parted /dev/sda resizepart 8 100%`

## 注意事项

### ⚠️ 安全警告
- **必须**在操作前创建虚拟机快照
- 确保在维护窗口期间执行此操作
- 建议在测试环境中先验证步骤

### 💡 最佳实践
- 定期备份Home Assistant配置
- 监控ESXi主机存储使用情况
- 考虑使用精简配置磁盘以节省空间

### 📋 验证清单
- [ ] 创建虚拟机快照
- [ ] 完全关闭虚拟机
- [ ] 修改虚拟硬盘大小为500GB
- [ ] 启动虚拟机并确认正常运行
- [ ] 执行文件系统扩展命令
- [ ] 验证存储空间显示接近500GB
- [ ] 测试Home Assistant所有功能
- [ ] 删除不需要的快照（可选）

## 相关文档
- [Home Assistant备份和恢复指南](./HomeAssistant备份恢复指南.md)
- [VMware ESXi虚拟机管理指南](./VMware-ESXi虚拟机管理.md)

## 更新记录
- 2025-07-17：初始版本创建
- 2025-07-17：添加成功案例验证，确认32GB→500GB扩展完全成功
- 包含从32GB扩展到500GB的完整步骤和实际验证结果

---
**文档作者**：技术团队  
**最后更新**：2025年7月17日  
**适用版本**：VMware ESXi 5.5+, Home Assistant OS 所有版本