简介 #
HomeAssistant(HA)是一个开源的智能家居控制中心项目，支持的智能家居品牌非常全面，对中文的支持也非常好，通过HA可以实现绕开智能家居品牌的远程服务器，直接在本地给智能家居的设备下发控制指令，从而有助于隐私保护。2024-12-16小米官方开源了HA的集成项目，这波是格局打开了。博主有一些米家的IoT设备，但由于没有小米手机，导致每次想要控制智能家居都要打开米家APP，多少有些不便。而HA就能做到打通米家的智能设备和苹果HomeKit，因此可以让你直接在苹果设备的控制中心操控米家的产品。 相关链接：
HA安装指南 #
官方的安装教程覆盖的方式非常全面，他们还有官方硬件可以直接购买，这是最省事也是最适合小白的方式。安装HA的系统可分为两种：HAOS和Container。物理机安装和虚拟机(VM)安装都属于HAOS，即有自己独立内核的一个操作系统（毕竟都自称为OS了）。官方的安装指南对比了HAOS和Container部署的区别，即VM是完全体，Container不能使用第三方插件和一键更新。但我实测小米的官方插件可以完美安装不受影响，所以我不清楚官方的“不能使用第三方插件”是什么含义。而更新，对于容器来说，需要时手动更新也不是什么难事。
下文会介绍PVE下VM和LXC的安装方法，容器的方式对硬件资源的节约十分显著，后面会有对比。容器化安装也是博主最终选择的方式。
VM安装方式 #
对于HAOS的安装，博主家里有基于PVE的虚拟化平台，如果你使用ESXi也是十分类似的。在官网的Linux教程下载.qcow2镜像，得到是一个.xz格式的压缩文件，直接解压即可。ESXi用户将其转换成.vmdk格式就能用了。到PVE建立好虚拟机，并删除磁盘文件，然后将.qcow2文件上传到PVE。使用如下命令模板将.qcow2导入到虚拟机成为虚拟磁盘：
qm importdisk <vmid> <images-name> <storage pool> --format=<disk-fs>
- vmid：vm的id 例如102
- images-name：磁盘镜像的路径
- storage pool: 存储磁盘镜像的位置，如lvm-thin local
- disk-fs: 磁盘镜像格式 raw/vmdk/qcow2
具体例子：
qm importdisk 240 haos_ova-16.2.qcow2 local-zfs --format=qcow2
待命令执行完毕就能在VM里看到新导入的磁盘了，双击它直接确定即可。到PVE虚拟机的Options里设置好刚导入的硬盘为第一启动项就能启动安装程序了。安装过程需要联网，不成功就赋予魔法。安装完成在console可以看到ip, 安装提示打开网页并设置好用户和地区就算完成HAOS的安装了。
Container方式 #
网上的其他教程几乎都是直接在一个Linux设备里通过docker安装的，但既然使用PVE那还可以通过我最喜欢的LXC安装。博主发现PVE的社区脚本里有一键安装的命令，那就简单了！在PVE执行
bash -c "$(curl -fsSL https://git.community-scripts.org/community-scripts/ProxmoxVE/raw/branch/main/ct/homeassistant.sh)"
以后要更新也是通过这一条命令就搞定。安装过程可能会比较慢，懂得都懂了。
LXC安装的HA其实是嵌套了docker提供服务的，事实上HAOS也是通过docker部署的。安装脚本默认分配了2C2G的硬件资源，由于LXC本就十分节省资源，博主改成了1C512MiB，这也是基础使用最低要求了，如果装了更多的插件建议给到1GiB及以上。硬件资源可以直接修改而不需要关机，这也是博主喜欢LXC的原因之一。前面的一件安装脚本会连同portainer也一并安装，如果不需要的话可以禁用其自启动。
首先docker ps查看portainer的container id, 然后更新容器容器策略
# 查看重启策略
docker inspect -f '{{.HostConfig.RestartPolicy.Name}}' <容器名称或ID>
# 不是no则修改
docker update --restart=no <容器名称或ID>
两种方式占用资源对比 #
对比图是设置完成投入使用时候的截图，上VM下LXC。可见VM占用的内存显著更多，而LXC仅需400MiB左右的内存。此外当我使用VM的一键更新到2025.9.3的最新版本后，出现有一个进程吃满一个核心的状况（图中50%的CPU占用），不清楚具体原因，重新安装一遍HAOS也是一样的问题，后来博主才换成了LXC的部署方式。
HACS安装 #
接下来需要安装HACS(HomeAssistant Community Store), 按照hacs的官方教程来就行, 装完hacs需要重启ha。
依次点开设置->设备与服务，右下角添加集成，搜索HACS，然后按照指引授权Github。完成后左侧菜单栏会出现HACS选项，如果没有则清除浏览器缓存，还没有就重启HA。
至此，所有前置条件都准备好了，下篇教程将打通米家智能家居和Apple Homekit.
参考