--- title: 小米官方发布「米家集成」，可在 Home Assistant 中使用小米 IoT 智能设备 date: 2024-12-17T08:04:42Z modified: 2024-12-17T08:04:46Z permalink: "https://www.appinn.com/ha-xiaomi-home-for-home-assistant/" type: post status: publish excerpt: "" categories: - 业界消息 - 智能硬件 tags: - 业界消息 - 智能硬件 - Home Assistant - 米家 featured_image: "https://www.appinn.com/wp-content/uploads/2024/12/appinn-homework-38.jpg" author: 青小蛙 timestamp: 2024-12-17T08:04:46Z --- **米家集成**是由小米官方发布的 **Home Assistant** 集成组件，在登录米家账号之后，可以在 Home Assistant 中使用小米 IoT 智能设备，NAS 党狂喜。@[Appinn](https://www.appinn.com/ha-xiaomi-home-for-home-assistant.md)[](https://github.com/XiaoMi/ha_xiaomi_home/blob/main/doc/README_zh.md#home-assistant-%E7%B1%B3%E5%AE%B6%E9%9B%86%E6%88%90) ![](https://www.appinn.com/wp-content/uploads/2024/12/appinn-homework-38.jpg) ## **Home Assistant** 是什么？ Home Assistant（[官网](https://www.home-assistant.io/)） 是一个开源的智能家居自动化平台，通过一个统一的界面（网页、手机客户端）来管理和控制家中的智能设备（支持不同品牌如宜家、飞利浦、亚马逊等），还支持自动化设置，可根据自己的需求创建智能场景。 在此之前想要将米家的设备接入 **Home Assistant** 是一件十分复杂且挑设备的事情，而今后就不同了。 以下内容转自米家集成的 [GitHub 中文介绍页面](https://github.com/XiaoMi/ha_xiaomi_home/blob/main/doc/README_zh.md)： ## 米家集成（3 种安装方式） 米家集成 作为一个 Home Assistant 的集成组件，直接安装在 Home Assistant 中。你需要先安装 HA，然后才能安装米家集成。 Home Assistant 版本要求： - Core ≥ 2024.11.0 - Operating System ≥ 13.0 米家集成的说明文档中提供了三种安装方式： ### 命令行 cd config git clone https://github.com/XiaoMi/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /config 可以很方便的切换版本： cd config/ha_xiaomi_home git checkout v1.0.0 ./install.sh /config ### 通过 HACS 商店安装 尚未添加到商店中，但可以在 HACS 中：HACS > Overflow Menu > Custom repositories > Repository: https://github.com/XiaoMi/ha\_xiaomi\_home.git & Category: Integration > ADD 😂 ### 手动安装 下载并将 `custom_components/xiaomi_home` 文件夹复制到 Home Assistant 的 `config/custom_components` 文件夹（没有就创建一个）下。 相对来说，这个方法可能更简单一些。帮你们打了个包：扫码关注**小众软件微信公众号**，回复 **241217** 获取网盘链接： ![](https://www.appinn.com/wp-content/uploads/2024/10/qrcode_for_gh_cae83b625e1e_344.jpg) 安装完成之后，记得重启 **Home Assistant** ## 配置 ### 登录 [设置 > 设备与服务 > 添加集成](https://my.home-assistant.io/redirect/brand/?brand=xiaomi_home) > 搜索“`Xiaomi Home`” > 下一步 > 请点击此处进行登录 > 使用小米账号登录 [![Open your Home Assistant instance and start setting up a new integration.](https://camo.githubusercontent.com/adbb09f7a40eb3933f3220dfe49dd8dff1e0f86acf59e9803662bb6f8f988910/68747470733a2f2f6d792e686f6d652d617373697374616e742e696f2f6261646765732f636f6e6669675f666c6f775f73746172742e737667) ](https://my.home-assistant.io/redirect/config_flow_start/?domain=xiaomi_home)![](https://www.appinn.com/wp-content/uploads/2024/12/Screen-20241217154149@2x.avif) 出现 Xiaomi Home 即代表安装成功 ### 添加 MIoT 设备 登录成功后，会弹出会话框“选择家庭与设备”。您可以选择需要添加的米家家庭，该家庭内的所有设备将导入 Home Assistant 。 ### 多账号登录 用一个小米账号登录并配置完成后，您可以在 Xiaomi Home Integration 页面中继续添加其他小米账号。 方法：[设置 > 设备与服务 > 已配置 > Xiaomi Home](https://my.home-assistant.io/redirect/integration/?domain=xiaomi_home) > 添加中枢 > 下一步 > 请点击此处进行登录 > 使用小米账号登录 [![Open your Home Assistant instance and show an integration.](https://camo.githubusercontent.com/15a86d08f7563387040afaf0ccbc46e4bee0f1002dfba800b01196693feff43f/68747470733a2f2f6d792e686f6d652d617373697374616e742e696f2f6261646765732f696e746567726174696f6e2e737667) ](https://my.home-assistant.io/redirect/integration/?domain=xiaomi_home)### 修改配置项 在会话框“配置选项”中，可选择需要变更的配置项。您可以修改用户昵称或更新从米家 APP 导入的设备列表。 方法：[设置 > 设备与服务 > 已配置 > Xiaomi Home](https://my.home-assistant.io/redirect/integration/?domain=xiaomi_home) > 配置 > 选择需要变更的配置项 ### Action 调试模式 开启该模式后，您可手动向设备发送带参数的 Action 控制指令。发送带参数的 Action 控制指令的用户入口显示为一个文本实体。 方法：[设置 > 设备与服务 > 已配置 > Xiaomi Home](https://my.home-assistant.io/redirect/integration/?domain=xiaomi_home) > 配置 > Action 调试模式 ## 安全性 米家集成及其使用的云端接口由小米官方提供。您需要使用小米账号登录以获取设备列表。米家集成使用 OAuth 2.0 的登录方式，不会在 Home Assistant 中保存您的小米账号密码。但由于 Home Assistant 平台的限制，登录成功后，您的小米用户信息（包括设备信息、证书、 token 等）会明文保存在 Home Assistant 的配置文件中。因此，您需要保管好自己 Home Assistant 配置文件。一旦该文件泄露，其他人可能会冒用您的身份登录。 ## 常见问题 **米家集成是否支持所有的小米米家设备？** 米家集成目前支持大部分米家设备品类，但仍有一小部分设备品类（蓝牙、红外及虚拟设备）并不支持。 **米家集成是否可以同时使用多个小米账号？** 是的，米家集成支持多个小米账号同时登录。另外，米家集成还支持不同账号的米家设备添加至同一个 Home Assistant 区域。 **米家集成是否支持本地化控制？** 米家集成支持通过[小米中枢网关](https://www.mi.com/shop/buy/detail?product_id=15755&cfrom=search)（固件版本 3.4.0\_000 以上）或内置中枢网关（软件版本 0.8.0 以上）的米家设备实现本地化控制。如果没有小米中枢网关或其他带中枢网关功能的设备，那么所有控制指令都会通过小米云发送。支持 Home Assistant 本地化控制的小米中枢网关（含内置中枢网关）的固件尚未发布，固件升级计划请参阅 MIoT 团队的通知。 小米中枢网关仅在中国大陆可用，在其他地区不可用。 米家集成也能通过开启小米局域网控制功能实现部分本地化控制效果。小米局域网控制功能只能控制与 Home Assistant 处于同一局域网内的 IP 设备（使用 WiFi、网线连接路由器的设备），无法控制蓝牙 Mesh、ZigBee 等协议接入的设备。该功能可能会引起一些异常，我们建议不要使用该功能。小米局域网控制功能开启方法：[设置 > 设备与服务 > 已配置 > Xiaomi Home](https://my.home-assistant.io/redirect/integration/?domain=xiaomi_home) > 配置 > 更新局域网控制配置 小米局域网控制功能不受地区限制，在全球范围内均可用。如果 Home Assistant 所在的局域网内存在中枢网关，那么即便米家集成开启了小米局域网控制功能，该功能也不会生效。 **米家集成在哪些地区可用？** 米家集成所用的云服务接口已部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国共六个地区的机房。由于用户数据在不同地区的小米云上相互隔离，您需要在配置 Home Assistant 时选择用户所在地区，才能导入相应的米家设备。米家集成支持将不同地区的米家设备添加至同一个 Home Assistant 区域。 --- 更多详见项目主页：[https://github.com/XiaoMi/ha\_xiaomi\_home/](https://github.com/XiaoMi/ha_xiaomi_home/) 另外，我们建立了一个群组，感兴趣的同学可以一起来讨论： ![](https://www.appinn.com/wp-content/uploads/2024/12/IMG_4165.avif) 注意，在安装过程中问题还是不少，可能要折腾一段时间，比如，我卡在了登录这里： ![](https://www.appinn.com/wp-content/uploads/2024/12/Screen-20241217154909@2x.avif) 如果你也是，将 ip homeassistant.local 添加到 hosts 文件里（或者在地址里换一下 URL） 这大概是 NAS 党又一个不得不装的工具啊。 ## Topics **分类目录:** [业界消息](https://www.appinn.com/category/it-news/?output_format=md), [智能硬件](https://www.appinn.com/category/smart-hardware/?output_format=md) **标签:** [Home Assistant](https://www.appinn.com/tag/home-assistant/?output_format=md), [米家](https://www.appinn.com/tag/%e7%b1%b3%e5%ae%b6/?output_format=md)