Home Assistant HA 米家集成 2025 最新版下载安装

Home Assistant 米家 介绍

米家集成是一个由小米官方提供支持的 Home Assistant 的集成组件，它可以让您在 Home Assistant 中使用小米 IoT 智能设备。

请输入密码 xiaomi 查看 Home Assistant 米家集成 网盘下载地址访问码

Home Assistant 米家安装

Home Assistant 版本要求：

Core≥2024.4.4

Operating System≥13.0

安装方法 1：使用 git clone 命令从 GitHub 下载

cd config
git clone https://github.com/XiaoMi/ha_xiaomi_home.git
cd ha_xiaomi_home
./install.sh /config

推荐使用此方法安装米家集成。当您想要更新至特定版本时，只需要切换至相应的 Tag 。

例如，更新米家集成版本至 v1.0.0

cd config/ha_xiaomi_home
git checkout v1.0.0
./install.sh /config

安装方法 2: HACS

HACS > 右上角三个点 > Custom repositories > Repository: https://github.com/XiaoMi/ha_xiaomi_home.git & Category or Type: Integration > ADD > 点击 HACS 的 New 或 Available for download 分类下的 Xiaomi Home ，进入集成详情页 > DOWNLOAD

米家集成暂未添加到 HACS 商店，敬请期待。

安装方法 3：通过 Samba 或 FTPS 手动安装

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

Home Assistant 米家配置

登录

设置 > 设备与服务 > 添加集成 > 搜索 「Xiaomi Home」 > 下一步 > 请点击此处进行登录 > 使用小米账号登录

Open your Home Assistant instance and start setting up a new integration.

添加 MIoT 设备

登录成功后，会弹出会话框 「选择家庭与设备」。您可以选择需要添加的米家家庭，该家庭内的所有设备将导入 Home Assistant 。

多账号登录

用一个小米账号登录并配置完成后，您可以在 Xiaomi Home Integration 页面中继续添加其他小米账号。

方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 添加中枢 > 下一步 > 请点击此处进行登录 > 使用小米账号登录

Open your Home Assistant instance and show an integration.

修改配置项

在会话框 「配置选项」 中，可选择需要变更的配置项。您可以修改用户昵称或更新从米家 APP 导入的设备列表。

方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > 选择需要变更的配置项

Action 调试模式

开启该模式后，您可手动向设备发送带参数的 Action 控制指令。发送带参数的 Action 控制指令的用户入口显示为一个文本实体。

方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > Action 调试模式

Home Assistant 米家安全性说明

米家集成及其使用的云端接口由小米官方提供。您需要使用小米账号登录以获取设备列表。米家集成使用 OAuth 2.0 的登录方式，不会在 Home Assistant 中保存您的小米账号密码。但由于 Home Assistant 平台的限制，登录成功后，您的小米用户信息 （包括设备信息、证书、 token 等） 会明文保存在 Home Assistant 的配置文件中。因此，您需要保管好自己 Home Assistant 配置文件。一旦该文件泄露，其他人可能会冒用您的身份登录。

如果您怀疑您的 OAuth 2.0 令牌已泄露，您可以通过以下步骤取消小米账号的登录授权： 米家 APP -> 我的 -> 点击用户名进入小米账号页面 -> 应用授权 -> Xiaomi Home (Home Assistant Integration) -> 取消授权

Home Assistant 米家常见问题

米家集成是否支持所有的小米米家设备？

米家集成目前支持大部分米家设备品类，但仍有一小部分设备品类 （蓝牙、红外及虚拟设备） 并不支持。

米家集成是否可以同时使用多个小米账号？

是的，米家集成支持多个小米账号同时登录。另外，米家集成还支持不同账号的米家设备添加至同一个 Home Assistant 区域。

米家集成是否支持本地化控制？

米家集成支持通过小米中枢网关 （固件版本 3.4.0_000 以上） 或内置中枢网关 （软件版本 0.8.0 以上） 的米家设备实现本地化控制。如果没有小米中枢网关或其他带中枢网关功能的设备，那么所有控制指令都会通过小米云发送。支持 Home Assistant 本地化控制的小米中枢网关 （含内置中枢网关） 的固件尚未发布，固件升级计划请参阅 MIoT 团队的通知。

小米中枢网关仅在中国大陆可用，在其他地区不可用。

米家集成也能通过开启小米局域网控制功能实现部分本地化控制效果。小米局域网控制功能只能控制与 Home Assistant 处于同一局域网内的 IP 设备 （使用 WiFi、网线连接路由器的设备），无法控制蓝牙 Mesh、ZigBee 等协议接入的设备。该功能可能会引起一些异常，我们建议不要使用该功能。小米局域网控制功能开启方法：设置 > 设备与服务 > 已配置 > Xiaomi Home > 配置 > 更新局域网控制配置

小米局域网控制功能不受地区限制，在全球范围内均可用。如果 Home Assistant 所在的局域网内存在中枢网关，那么即便米家集成开启了小米局域网控制功能，该功能也不会生效。

米家集成在哪些地区可用？

米家集成所用的云服务接口已部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国共六个地区的机房。由于用户数据在不同地区的小米云上相互隔离，您需要在配置 Home Assistant 时选择用户所在地区，才能导入相应的米家设备。米家集成支持将不同地区的米家设备添加至同一个 Home Assistant 区域。