一.前言
HomeAssistant介绍:Home Assistant(简称 HA)是一款开源的智能家居集成平台,具有以下核心特性:
- 跨平台支持
- 支持接入5000+种智能设备(Zigbee/Z-Wave/WiFi等协议)
- 兼容Google Home/Apple HomeKit生态
- 自动化中枢
- 基于状态/时间/事件的自动化触发
- 支持Node-RED可视化流程编排
- 丰富的条件判断和延迟操作
- 本地化架构
- 优先本地执行保障隐私
- 基于Python的可扩展架构
- Docker容器化部署方案
- UI定制能力
- 可高度定制的Lovelace界面
- 支持3D家居地图集成
- 多用户权限管理
二.安装过程
homeassistant官网安装文档地址:
https://www.home-assistant.io/installation/linux
根据文档首先安装依赖

因为镜像自带的python是3.11版本,而最新版本是需要python3.12的,所以尝试安装2024.3.3版本:

原生源安装太慢,换清华源之后:



启动遇到问题了,开始以为可能是网络造成的,国内访问容易出问题:



最后发现是homeassistant会自动进行升级,而homeassistant版本是跟着python的版本走的,所以这里用固件自带的python行不通,此时有两个方案:
- 安装conda库,然后安装一个全新的虚拟python环境,使用最新版的python安装homeassistant
- 采用docker方式,下载homeassistant镜像
conda稍微复杂一点,先尝试用docker的方式试试看
首先安装docker:
直接安装失败,containerd下载不下来

还是网络问题,自己下载dpkg包手动安装,需要解决依赖问题:
http://mirrors.ustc.edu.cn/debian/pool/main/c/containerd/


然后再执行:sudo apt-get install docker.io完成安装:

把docker添加进用户组并设置开机启动

创建homeassistant配置文件夹

执行下面这个命令拉取并运行镜像:
docker run -d \
--name homeassistant \
--privileged \
--restart=unless-stopped \
-e TZ=Asia/Shanghai \
-v /home/luckfox/.homeassistant:/config \
-v /run/dbus:/run/dbus:ro \
--network=host \
ghcr.io/home-assistant/home-assistant:stable
其中TZ是时区(TimeZone)的意思,/home/luckfox/.homeassistant是homeassistant的配置文件夹的位置.

使用国外源可能出错,可以尝试使用国内源或镜像加速站,我这里使用华为云的:
c2b4cfc215074912827f9357c207eff5.mirror.swr.myhuaweicloud.com/homeassistant/home-assistant:stable
docker run -d --name homeassistant --privileged --restart=unless-stopped -e TZ=Asia/Shanghai -v /home/luckfox/.homeassistant:/config -v /run/dbus:/run/dbus:ro --network=host c2b4cfc215074912827f9357c207eff5.mirror.swr.myhuaweicloud.com/homeassistant/home-assistant:stable

拉取成功:

查看镜像列表和容器列表:

然后就水灵灵的运行起来了,输入自己的ip:8123,可以看到启动界面:

先创建个用户


进入成功,目前还没有任何设备:

三.安装hacs商店
可以下载HACS插件,当然这一步非必须,关于HACS的解释如下:
HACS(Home Assistant Community Store)是一个第三方插件商店,允许用户安装社区维护的集成和主题。并非所有设备集成都需要HACS,因为Home Assistant本身已经内置了许多官方支持的集成。
用户可能在使用某些特定品牌的设备时,发现需要安装HACS中的插件才能支持,例如某些小米设备或需要自定义集成的设备。但很多常见品牌如Philips Hue、TP-Link等的集成已经包含在官方集成中,无需HACS。
因此,是否需要HACS取决于用户要添加的设备类型。如果设备有官方集成,则不需要HACS;如果设备需要社区开发的集成,则需要通过HACS安装。需要建议用户先检查官方集成列表,如果找不到对应的集成,再考虑使用HACS。
另外,HACS本身并不是Home Assistant的必需组件,但可以扩展其功能。用户如果不需要社区插件,完全可以不使用HACS。因此,回答应明确区分官方和社区集成的区别,并指导用户如何判断是否需要HACS。
hacs的官方网址:https://hacs.xyz/
找到文档部分,安装hacs,在docker方式下可以使用wget指令直接下载:
wget -O - https://get.hacs.xyz | bash -

进入homeassistant的终端命令行:


开发板网速不好的情况下也可以自己从电脑上下载然后传过去:
https://github.com/hacs/integration/releases





使用docker restart命令重启homeassistant容器

重新回到网页



此处需要github账号登录,没有的话需要自己注册:




在左边产生了hacs插件

后面就可以愉快的用各种小米美的的设备去集成了,放在下一篇