HomeAssistant OS 安装教程

断断续续调试了两个月，终于把满血的 HomeAssistant OS 移植到懒猫微服了。HomeAssistant 一共有四种版本：HA OS, HA Container, HA Core, HA Supervisored。

目前 HA 的官方只推荐 HA OS 和 HA Container 两种形式的安装，另外两种已经不再推荐。

HA OS 和 HA Container 的区别点见下：

|                   | HA OS | Container |
| ----------------- | :---: | :-------: |
| Automations       |  ✔️   |    ✔️     |
| Dashboards        |  ✔️   |    ✔️     |
| Integrations      |  ✔️   |    ✔️     |
| Add-ons           |  ✔️   |     ❌     |
| Blueprints        |  ✔️   |    ✔️     |
| One-click updates |  ✔️   |     ❌     |
| Backups           |  ✔️   |    ✔️     |

由于移植 HA OS 使用的是 KVM 虚拟机的方式，虚拟机的启动需要固化一些内存，HA 官方建议最小内存是 2GB ，考虑到 Add-ons 的使用，我设置了 4GB。

因此如果你不需要 Add-ons 功能，可以考虑使用懒猫微服官方移植的版本（懒猫官方移植的应该是 HA Core，除了 Add-ons 外，Backups 也是不可用的）。

接下来我将会引导你如何开始你的 HomeAssistant 之旅。

https://appstore.lazycat.cloud/#/shop/detail/ink.akawa.ety001.haos

打开懒猫微服应用商店，搜索到 HomeAssistant OS 后，点击安装。由于虚拟机镜像从安装包中已经剥离，因此这一步安装会很快。

安装成功后，等待应用启动。初次安装会从我的服务器下载虚拟机镜像，下载成功后会启动虚拟机。

虚拟机启动后，大约需要10--15分钟，HomeAssistant完成初始化。如果一直没有反应，可以在懒猫面板中停止后再启动。

初始化结束后，页面会自动跳转到 HomeAssistant 的欢迎界面，如下图

![screenshot_20250620_155202.jpg](https://dl.playground.lazycat.cloud/guidelines/364/6fb89f26-17da-4d15-bd22-0804573b6086.jpg "screenshot_20250620_155202.jpg")

> 如果你不是第一次使用 HomeAssistant，可以从其他设备的 HomeAssistant 备份中恢复。
> 这里演示的是全新安装。

点击“创建我的智能家居”，输入用户名和密码，创建管理员账号，

![screenshot_20250620_155234.jpg](https://dl.playground.lazycat.cloud/guidelines/364/be66f805-b3ea-41eb-9029-d9ac7247c22d.jpg "screenshot_20250620_155234.jpg")

选择你的家庭位置，这个主要是后期做离家回家互动使用

![screenshot_20250620_155247.jpg](https://dl.playground.lazycat.cloud/guidelines/364/36847e98-7a37-4cd1-beac-506fdcb69ace.jpg "screenshot_20250620_155247.jpg")

完成初始化

![screenshot_20250620_155315.jpg](https://dl.playground.lazycat.cloud/guidelines/364/80568bc0-2a80-47c7-a6a9-377e2b97d505.jpg "screenshot_20250620_155315.jpg")

上面点击“完成”后，可能会出现下面截图中的无法访问的情况，直接关闭重新打开即可。

![screenshot_20250620_155327.jpg](https://dl.playground.lazycat.cloud/guidelines/364/3d2d91be-a935-4992-bbba-14b59a735ea0.jpg "screenshot_20250620_155327.jpg")

完成初始化后，来到登陆界面，输入用户名和密码登陆。

![screenshot_20250620_155350.jpg](https://dl.playground.lazycat.cloud/guidelines/364/9ba31822-1a81-4448-8802-566600b0cade.jpg "screenshot_20250620_155350.jpg")

在左边栏找到“设置”，进入设置页面后，点击“设备与服务”。

![screenshot_20250620_155424.jpg](https://dl.playground.lazycat.cloud/guidelines/364/a86251e9-ce2b-41a9-9647-c47d3de8f6d6.jpg "screenshot_20250620_155424.jpg")

输入“HACS”。

> 这是我集成的第三方的扩展安装商店。

![screenshot_20250620_155951.jpg](https://dl.playground.lazycat.cloud/guidelines/364/27211cea-2007-4b0a-93ab-a7c2a0db9b5c.jpg "screenshot_20250620_155951.jpg")

点击之后会需要你跳转你的 Github 账号，输入屏幕给出的验证码完成绑定。

> 这一步可能会需要尝试多次，因为 HACS 的所有安装信息都在 Github 库中，而 HACS 的用户数量庞大，Github API 提供的免费限流在高峰期不足以支撑用户完成绑定之类的操作。

![screenshot_20250620_160011.jpg](https://dl.playground.lazycat.cloud/guidelines/364/244e6433-02b4-494c-9575-1af7b79e5d01.jpg "screenshot_20250620_160011.jpg")

绑定成功后，就可以激活 HACS 了，在左边栏也可以看到 HACS 的选项。

点击左边栏的 “HACS” 打开第三方商店，输入“xiaomi”，找到“Xiaomi Miot Auto”，即可安装目前 HomeAssistant 中最好用的小米集成。

![image.png](https://dl.playground.lazycat.cloud/guidelines/364/d283f5b5-5033-45d8-bd5b-d6114ab79ee0.png "image.png")

另外对于使用易微联的用户，可以在“HACS”中搜索“sonoff lan”，安装即可使用易微联设备。

至此，一个全新的 HomeAssistant 完成安装部署。

如果你需要在不方便安装懒猫客户端的设备上访问，可以直接 http://你的懒猫IP:8123 进行访问。