小米路由器BE7000 Docker+HomeAssistant+ha_xiaomi_home

最近小米官方发布了Home Assistant米家集成ha_xiaomi_home。之前用的是Xiaomi Miot Auto，想替换为小米官方的ha_xiaomi_home。

ha_xiaomi_home主要优点如下：

• 基于消息订阅机制通信，响应比轮询更及时。

• 更完善支持米家设备，涵盖更多设备、更详细信息、更多实体与控制项。

• 采用 OAuth2 登录方式，较用户名、密码方式更安全，但敏感信息仍明文存于 Home Assistant 里，需做好安全防护。

• 支持多账号。

• 支持本地通信，其优势在于比云服务转发消息更快，断网状态下也能用；不过需要小米中枢网关或者支持中枢网关功能的米家设备，且配套的中枢网关固件暂未发布，暂时无法使用。

安装要求：

        Home Assistant 版本要求：Core ≥ 2024.11.0     Operating System ≥ 13.0

原本正在使用的HomeAssistant版本不满足该安装要求，在HA管理面板中，检测更新却显示没有可更新内容，所以无法直接通过升级的方式将 Home Assistant 升级到满足要求的新版本。故选择重新安装最新版的HomeAssistant。

1.安装HomeAssistant

BE7000路由器上安装Docker+HomeAssistant+HACS参照另一位博主的教程（非常详细）：路由器竟然比NAS还厉害？！小米7000及万兆路由器Docker实战全指南 - 知乎

注意：因为Docker源被墙的原因，当进行到 Docker拉取HomeAssistant镜像这一步时：

docker pull homeassistant/home-assistant

会一直提示拉取失败。故不执行教程中的这一步！！不通过Docker拉取HomeAssistant，通过米家路由器中的SimpleDocker，在镜像管理中，选择导入镜像包。

该HomeAssistant镜像包可以自行在有梯子的设备上，使用Docker拉取打包为tar（注意为Linux/arm64架构的）。也可以使用以下镜像包，是我从Docker Hub官网打包的当前最新版本。

通过网盘分享的文件：HA Docker镜像
链接: https://pan.baidu.com/s/1ga39L01e7TiUwZHDVJWyPw?pwd=cjd6 提取码: cjd6

导入时，加载文件进度条走完之后，需要等待较长一段时间，等镜像包加载完成，直到“导入结果”有内容输出才算导入完毕。

其他步骤按照博主的教程走。就可以完成HomeAssistant的安装。

2.安装ha_xiaomi_home

ha_xiaomi_home/doc/README_zh.md at main · XiaoMi/ha_xiaomi_home · GitHub

官方说明中有详细的安装方式，对于 BE7000+Docker+HomeAssistant 方案，最方便的安装方式就是方法3：通过 Samba 或 FTPS 手动安装：

下载并将 custom_components/xiaomi_home 文件夹复制到 Home Assistant 的 config/custom_components 文件夹下。

复制好后，在HA的管理面板中，重启HA。重启后，到集成中搜索 XIAOMI HOME 就可以看到米家的官方集成了。

至此，就完成了 BE7000 Docker+HomeAssistant+ha_xiaomi_home 的安装。