Windows 安装 Hass.io：从零搭建 Home Assistant 的完整教程

一、先说清楚：Windows 上装的不是传统“软件版 Hass.io”

很多人搜索“Windows 安装 Hass.io”，其实真正要找的是在 Windows 电脑上运行 Home Assistant。
严格来说，Hass.io 这个名字已经逐渐被 Home Assistant OS / Home Assistant Container / Home Assistant Core 这些方案替代了。

如果你是 Windows 用户，最常见、最稳妥的安装方式有两种：

用虚拟机安装 Home Assistant OS
这是最接近 Hass.io 的完整方案，功能最全，适合想长期使用、接入智能家居设备的人。
用 Docker 安装 Home Assistant Container
适合有一定基础、想轻量运行的人，但一些系统级功能不如 HA OS 完整。

如果你是新手，最推荐：Windows + VMware/VirtualBox + Home Assistant OS。
下面就按这个方案来讲，简单、稳定、可落地。

二、安装前准备

1. 需要什么电脑配置

Home Assistant 本身不算吃配置，但虚拟机还是要留一点资源：

CPU：双核以上，支持 VT-x / AMD-V
内存：建议 8GB 起步，最好 16GB
硬盘：至少预留 32GB，推荐 64GB 以上
系统：Windows 10 / Windows 11 都可以

2. 开启 CPU 虚拟化

这个很关键，不开虚拟化，虚拟机可能跑不起来或者很卡。

检查方法

按 Ctrl + Shift + Esc 打开任务管理器
点“性能”
看右下角是否显示 “虚拟化：已启用”

如果没启用，需要进 BIOS 打开：

开机时连续按 Del、F2、F10 或 Esc
找到类似这些选项：
- Intel Virtualization Technology
- VT-x
- SVM Mode
- AMD-V
设为 Enabled
保存退出

3. 下载虚拟机软件

推荐二选一：

VMware Workstation Player：更稳定，体验更好
VirtualBox：免费开源，够用

如果你是小白，建议优先装 VMware。
如果你想完全免费，也可以用 VirtualBox。

4. 下载 Home Assistant OS 镜像

去 Home Assistant 官方下载对应的 Virtual Machine 镜像，一般是：

.qcow2
.vmdk
.vdi

Windows 下用 VMware 的话，优先选 VMDK 格式；
用 VirtualBox 的话，优先选 VDI 格式。

三、Windows 下安装 Hass.io 的推荐方案：VMware + Home Assistant OS

四、详细安装步骤

第一步：安装 VMware

下载并安装 VMware Workstation Player
安装过程一路下一步即可
安装完成后重启电脑更稳妥

第二步：获取 Home Assistant OS 镜像

下载官方提供的虚拟机镜像
解压后，你通常会看到一个虚拟磁盘文件，比如：
- haos_ova-xx.x.vmdk
记住这个文件位置，后面要用

第三步：新建虚拟机

打开 VMware，按下面做：

选择 创建新虚拟机
选“我稍后安装操作系统”
客户机操作系统选：
- Linux
- 其他 Linux 5.x 或更高版本（看 VMware 版本）
给虚拟机命名，比如：
- Home Assistant
选择安装位置，建议放在 SSD 盘
设定磁盘容量时可以先随便建一个占位磁盘，后面再替换

第四步：把虚拟机硬盘换成 Home Assistant 的镜像

这是最关键的一步。

做法：

关闭刚建好的虚拟机
找到虚拟机目录里的 .vmdk 文件
用下载好的 Home Assistant 镜像文件替换默认磁盘文件
或者在虚拟机设置里，把现有硬盘删除，再添加已有磁盘文件

如果你是新手，最简单的理解就是：

虚拟机相当于一个空电脑
Home Assistant 镜像相当于系统盘
你要把这个系统盘挂到虚拟机里

第五步：调整虚拟机硬件配置

建议这样配：

CPU：2 核
内存：2GB 起步，推荐 4GB
硬盘：默认即可
网络适配器：建议桥接模式或 NAT 模式
USB 控制器：保留，方便后续接 USB 设备
启动项：光驱优先可以不管，直接启动硬盘

网络模式怎么选

NAT：最简单，适合新手，能上网但局域网访问有时不方便
桥接：更适合智能家居，局域网设备更容易发现 Home Assistant

如果你要接米家、Zigbee 网关、局域网智能设备，优先桥接模式。

第六步：启动虚拟机

点击开机后，第一次启动会比较慢，等几分钟。

如果一切正常，你会看到类似这样的启动日志：

初始化系统
加载服务
获取 IP 地址
准备 Web 管理页面

等它启动完成后，就可以在浏览器访问了。

第七步：访问 Home Assistant 页面

在浏览器输入：

http://homeassistant.local:8123

如果打不开，就用虚拟机的 IP 地址访问，例如：

http://192.168.1.100:8123

IP 地址可以在虚拟机控制台里查看，也可以到路由器管理页里找 DHCP 分配记录。

五、首次配置 Home Assistant

第一次进入页面后，会进入初始化向导：

1. 创建账号

设置管理员用户名和密码，建议密码复杂一点。

2. 设置地区和时区

中国用户建议：

时区：Asia/Shanghai
语言：中文（简体）

3. 自动发现设备

Home Assistant 会自动扫描局域网里的部分设备，比如：

小米设备
华为设备
TP-Link 插座
智能灯
摄像头
NAS
路由器

如果你的设备支持局域网发现，后续接入会很方便。

六、Windows 上安装 Hass.io 常见问题

问题 1：虚拟机启动黑屏或卡在开机界面

原因分析

一般是这几个原因：

虚拟化没开
镜像文件没挂对
BIOS/UEFI 设置不兼容
虚拟机内存分配太少

解决方法

检查 BIOS 里是否开启 VT-x / AMD-V
确认虚拟磁盘文件是否正确替换
内存调到 2GB 或 4GB
换成桥接网络再试
重新导入官方镜像

问题 2：浏览器打不开 `homeassistant.local`

原因分析

这是局域网名字解析问题，不一定是系统坏了。

解决方法

直接用 IP 地址访问
确认虚拟机已经获取到正确 IP
检查 Windows 防火墙是否拦截
检查路由器是否分配了地址

问题 3：Home Assistant 很卡

原因分析

常见是资源不够或者硬盘慢。

解决方法

虚拟机内存提升到 4GB
CPU 提升到 2 核或 4 核
把虚拟机文件放在 SSD
关闭 Windows 不必要的后台程序
不要同时开太多虚拟机

问题 4：局域网设备发现不了

原因分析

多数是网络模式问题。

解决方法

把虚拟机网卡改成 桥接模式
确保 Home Assistant 和设备在同一网段
路由器不要开启过强的 AP 隔离
某些设备需要手动添加集成

七、如果你想用 Docker 安装，也可以这样做

如果你不想折腾虚拟机，Windows 上还能用 Docker 跑 Home Assistant 容器版。

优点

占用资源少
启动快
适合开发和测试

缺点

功能完整性不如 HA OS
插件、Supervisor 这类能力不完整
新手上手门槛更高

简单命令示例

前提是你已经装好 Docker Desktop：

docker run -d \
  --name homeassistant \
  --privileged \
  --restart=unless-stopped \
  -e TZ=Asia/Shanghai \
  -v C:\homeassistant\config:/config \
  --network=host \
  ghcr.io/home-assistant/home-assistant:stable

不过要注意，Windows 原生 Docker 对 --network=host 的支持有限，所以这条命令在 Windows 上未必完全照搬可用。
所以对普通用户来说，还是更建议用 虚拟机方案。