MacOS使用UTM安装HomeAssistant

Home Assistant

Home Assistant‌ 是一个开源、本地优先的家庭自动化平台，旨在将各类智能家居设备统一管理与控制，同时保障用户隐私和数据安全。

HAOS

HAOS下载路径：Home Assistant‌ OS

选择最新版OS即可，选择后缀为*.qcow2.xz

解压下载的文件，解压后后缀为*.qcow2

在UTM中创建虚拟机

选择 -> “虚拟化”

选择 -> “其他”

启动设备选择 -> “无”

硬件根据实际情况选择

存储空间默认64GB，我这里选32GB，16GB实际就够用了

打开虚拟机设置

显示选择virtio-gpu-pci

网络默认共享或者选择桥接，能科学上网就行(安装插件时需要)

驱动器这里删除默认的

然后新建导入

选择下载解压的qcow2文件

然后存储保存配置，启动虚拟机

出现这个说明启动成功
通过IP和端口8123访问服务
等待完成即可：

这里等待是在下载docker镜像，等待时间和网速有关

出现这个界面就可以了

创建账户即可：

这里用的google地图，需科学上网，输入地址搜索就行

然后一直下一步，完成即可

HAOS安装应用

安装应用之前先关闭虚拟机，然后选择建立的虚拟机，右键编辑：

然后选中新建的驱动器，调整空间大小，我这里选择18GB，不调整大小，后续安装应用会失败，报空间不足(在新建驱动导入OS文件的时候直接调整大小没用)

调整之后，启动虚拟机，登陆用户，然后开启”高级模式”

“设置” -> “应用” -> “安装应用”

安装 Terminal & SSH

然后选择在侧边栏显示，点击启动

点击侧边栏Terminal按钮进入

安装 HACS

1	wget -q -O - https://install.hacs.xyz \| bash -

reboot重启

然后安装HACS集成

“设置” -> “设备与服务” -> “添加集成”

“提交”

登陆github

输入key

授权完成✅

跳过并完成即可

左侧导航栏新增HACS，点击进入搜索安装软件或者主题即可

安装小米集成(当前安装通过脚本方式)，导入米家设备

PS: 建议通过HACS安装，方便管理和升级，HACS安装时搜索xiaomi，会出现多个选项，安装xiaomi home即可。

小米集成地址：ha_xiaomi_home

根据所示方法一安装即可

cd config
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config

然后reboot重启系统即可

重启后，查看”设置” -> “设备与服务” -> “添加集成”

选择”Xiaomi Home”，勾选，下一步

下一步：

选择这里登陆

导入设备

查看概览，卧室

安装 HomeKit Bridge 使用iPhone家庭也可以控制小米设备

“设置” -> “设备与服务” -> “添加集成”，搜索apple

选择HomeKit Bridge

方便演示，这里就只选择Camera和Light

提交

在通知中找到二维码配对

完成

然后关闭虚拟机，修改网络为桥接模式

桥接接口根据实际情况选择，然后启动虚拟机

IP已变成和宿主机同一个网段了

此演示HAOS版本有bug(Home Assistant Core: 2026.2.0)，小米集成灯实体找不到，所以选择 “设置” -> “设备与服务” 修改HomeKit Bridge

选择exclude，删除所有选择的域(为了验证是否能添加到家庭成功)

查看通知消息，使用iPhone的家庭扫描二维码导入设备