HomeAssistant 安装入门 折腾&踩坑记录

想要把家里的海尔智能设备接入米家, 遂开始研究 HomeAssistant (下称HA)

HA 提供 OS, Docker 等多种安装方式, 区别可见官方安装教程. 最后决定使用完全体, 即 HAOS 的方式安装

先前往 HAOS 的 GitHub Release 下载最新版的 qcow2/img 格式的镜像, 注意下载后是 xz, 需要解压后才能使用

注意安装过程需要科学环境, 你需要先搭建一个有此邪恶功能的网关

下载后上传到家里云 Unraid 的 isos 目录, 然后在unraid的虚拟机管理器创建虚拟机, OS 选择 Linux, CPU/RAM 看情况给, 最低 1c1g 也能跑起来, 主要虚拟磁盘位置选择手动, 定位到上传的镜像文件, 总线选择 SATA其他选择默认, 创建并运行, 首次运行需要走安装流程, 特别慢

等待启动过程跑完, 到 Waiting for the Home Assistant CLI to be ready... 屏幕, 就可以通过 http://homeassistant.local:8123 或 http://homeassistant:8123 或 http://ip:8123 访问 HA 的 WebUI 了

另外, 访问 4357 端口可以查看几个关键组件的运行状态

等等, 你以为这就完了? 不不不, 此时你打开 WebUI 大概率会还在 Preparing 界面, 或者日志已经有一大堆报错, 这就是我踩了一晚上的坑了. 接下来为 HAOS 手动指定网关, 来确保它能连接上外网

为了防止某些国内路由器厂商下发错误的配置导致 HAOS 连不上科学网关, 手动配置一下 HAOS 的网卡设置

回到 Unraid, 使用 VNC 连接到 HAOS 的终端, 输入 login 回车, 即进入命令行界面

然后输入 nmcli con 查看网络连接状态

能看到有一个名为 Supervisor enp1s0 的连接, 这里的名字可能不同, 注意替换

我们来编辑这个连接, 输入 nmcli con edit "Supervisor enp1s0", 看到如下提示即已经进入编辑状态

进入编辑状态后可先输入 print ipv4 print ipv6 查看当前的配置, 然后通过 set/remove ipv4.gateway 10.0.2.9 这样的命令来修改设置

如果科学网关没有提供 IPv6 服务, 建议暂时在此处禁用掉 ipv6; 顺便可以在此为 HAOS 配置静态 IP 方便以后使用

修改完配置后, 可以再次使用 print 命令查看配置, 确认无误后, 通过 save 命令保存, quit 退出编辑, 然后通过终端或者 Unraid 重启 HAOS 虚拟机

上一步配置完网关并重启后, 可以再次打开终端, 通过 curl https://google.com 等命令确保 HAOS 已经科学

确保已经科学后, 还是有概率安装某些组件失败. 搜了一大圈, 再没有什么好的解决方法了, 只能等它自动重试到安装好.

等不住了, 睡了一觉, 第二天起来, 已经安装好了 : )

此时可以在 WebUI 完成基础设置

在配置基础信息的过程中, WebUI 可能会卡住(即中间显示内容的框子什么都不显示), 此时刷新即可解决, 别傻等

配置完成后进入主界面, HA 会自动扫描到一部分设备(扫到了我的小爱音箱和 Redmi 路由器 awa )

Unraid 终端太难受了, 而且是残废版, 所以需要装个 ssh 插件

前往 HA 配置->加载项->右下角加载项商店, 搜索 ssh, 点进搜索结果中的 Terminal & SSH , 点击安装

安装后点击启动, 并打开自启动和守护

此时已经可以通过 打开 WEB UI按钮在浏览器连接终端了, 连接 ssh 还需要继续配置

然后切到配置选项卡, 配置 ssh 登录用的密钥/密码等信息, 并配置 ssh 端口(注意如果不配置, 那么 ssh 端口默认是关闭的), 保存并重启后, 即可使用配置的密钥/密码通过 ssh 软件连接到 HAOS 的终端了

HACS 是一个第三方应用商店

安装只需要先安装 ssh, 然后在 ssh 终端直接执行以下命令即可

安装完成后重启 HAOS

然后进入 HA 配置->设备与服务->集成->右下角添加集成->搜索 HACS->点击

弹出的提示请自己看完, 保证自己有故障排查的基本能力, 然后全部打勾点击继续, 按照弹出的提示, 复制验证码, 点击链接进入 GitHub 设备激活页面, 输入验证码完成授权, 回到 HA, 此时应该已经弹出完成的提示

安装完成后, HA 侧边栏已经出现 HACS 项目

打开 banto6/haier 仓库, 点击 OPEN HACS REPO... 按钮按照指引安装插件并重启 HA

重启后即可在 HA 配置->设备与服务->集成->右下角添加集成->搜索 haier 添加海尔设备了

这里使用巴法云插件来控制, 极大的简化了接入难度

打开HA 侧边栏 HACS->搜索 bemfa, 安装并重启HA

前往 巴法云 注册并登录账号, 进入控制台复制私钥

进入 HA 配置->设备与服务->集成->右下角添加集成->搜索 bemfa 点击, 粘贴私钥完成配置

回到集成页面, 点击 Bemfa->选项->同步实体, 选择需要同步的实体

然后前往米家APP->我的->连接其他平台->添加->巴法->绑定账号, 完成账号绑定

Unraid虚拟机安装Home Assistant – CSDN Home Assistant虚拟机版，修改ip地址和网关 – 哔哩哔哩 2.0 Addons – 安装ssh server服务 – 知乎 Download – HACS Home Assistant 安装 HACS 社区商店教程 – 希卡米 | HiKami用小爱同学/天猫精灵/小度音箱控制HA仅需一步 – 瀚思彼岸 larry-wong/bemfa – GitHub