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. 创建虚拟机快照（强烈建议）
  2. 在ESXi Web界面中选择Home Assistant虚拟机
  3. 点击"操作" → "创建快照"
  4. 输入快照名称：扩容前备份_YYYY-MM-DD

  5. 点击"创建快照"

  6. 完全关闭虚拟机

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

步骤2：在ESXi中扩展硬盘

  1. 进入虚拟机编辑模式
  2. 在ESXi Web界面中右键点击Home Assistant虚拟机

  3. 选择"编辑设置"

  4. 修改硬盘容量

  5. 在虚拟硬件列表中找到"硬盘1"
  6. 当前显示为"32 GB"
  7. 将数值改为"500"，单位保持"GB"

  8. 点击"保存"

  9. 确认更改

  10. 检查虚拟机设置中硬盘容量已显示为500GB
  11. 关闭编辑窗口

步骤3：启动虚拟机

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

步骤4：扩展文件系统

虚拟硬盘已扩展，但操作系统还需要识别并使用新增空间。

方法1：使用Home Assistant内置工具（推荐）

  1. 访问Home Assistant终端
  2. 在Home Assistant Web界面中
  3. 进入"设置" → "附加组件" → "Advanced SSH & Web Terminal"

  4. 如果没有安装，需要先安装SSH附加组件

  5. 执行扩展命令 ```bash # 查看当前磁盘使用情况 df -h

# 扩展根分区（通常是/dev/sda8） resize2fs /dev/sda8

# 再次查看磁盘使用情况，确认扩展成功 df -h ```

方法2：使用SSH连接（备选）

  1. 启用SSH

  2. 在Home Assistant Web界面中启用SSH功能

  3. 通过SSH连接 ```bash # 连接到Home Assistant ssh root@[Home_Assistant_IP]

# 查看磁盘分区 fdisk -l

# 扩展文件系统 resize2fs /dev/sda8 ```

步骤5：验证扩展结果

  1. 检查存储空间
  2. 通过SSH或终端执行命令：df -h
  3. 或在Home Assistant Web界面中进入"设置" → "系统" → "存储"
  4. 确认可用空间接近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。

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

故障排除

问题1：虚拟机无法启动

解决方案： - 检查ESXi主机存储空间是否充足 - 恢复到扩容前的快照 - 重新执行扩容步骤

问题2：文件系统扩展失败

解决方案：

# 检查文件系统
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所有功能
  • 删除不需要的快照（可选）

相关文档

更新记录

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

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