如何快速把小米米家设备接入 Home Assistant？ha_xiaomi_home 官方集成完整指南
如何快速把小米米家设备接入 Home Assistantha_xiaomi_home 官方集成完整指南【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home晚上回家还要在米家 App 里逐个关灯、关插座的瞬间你一定想过能不能把所有小米设备搬进 Home Assistant 统一管理ha_xiaomi_home米家集成就是干这件事的——它把小米 MIoT 设备接入 Home Assistant让你用 HA 的面板和自动化掌控整个家。一句话看懂它简单说ha_xiaomi_home 是小米官方维护的一个 Home Assistant 集成组件装好之后你米家账号下的灯泡、插座、空气净化器、扫地机器人……都会变成 HA 里标准的实体可以直接点亮、调温、写自动化。✅为什么值得信它第一它是小米官方出品的开源项目云端接口也是官方提供的稳定性和安全性比社区魔改方案踏实得多第二登录走的是 OAuth 2.0HA 里不会存你的小米账号密码第三设备多、品类杂的小米生态正是 HA 最需要这类官方搬运工的场景。它背后是怎么跑起来的这套集成内部有四条线在干活用大白话讲一遍你就知道它为什么既快又稳。登录一张不存密码的门禁卡你用小米账号登录时走的是 OAuth 2.0 授权流程类似住酒店刷房卡集成只拿到一把钥匙令牌拿不到你的账号密码本身。需要注意的是登录成功后令牌、设备信息会明文保存在 HA 的配置文件里所以配置文件要保管好。万一怀疑令牌泄露可以在米家 App 的账号安全页里一键取消授权。状态同步订阅群消息而不是反复敲门设备状态是怎么实时出现在 HA 里的集成并没有每隔几秒去问一次云端我的灯现在啥状态而是在 MIoT 云上订阅了 MQTT 消息。打个比方它像加了一个群聊设备一有变化开关、属性变动、事件触发消息就自动推到 HA秒级更新。配置完成时只需向云端查询一次全部属性之后的访问压力非常小。下发指令通过 HTTP 接口点外卖反过来你在 HA 里点一下开灯集成会通过 MIoT 云的 HTTP 接口把控制命令发给设备云端再转发给设备执行。就像点外卖下单订单经平台送达厨房你不用自己跑餐厅。本地直连把外卖换成自家厨房如果你的局域网里有小米中枢网关固件 3.3.0_0023 及以上或者内置中枢网关的米家设备软件 0.8.9 及以上集成就会切到本地模式网关本身内置了一个标准 MQTT Broker状态推送和控制指令都在局域网内完成不再绕远路经过云端——响应更快断外网时家里照样能自动化。注意小米中枢网关目前仅在中国大陆地区发售海外用户没有网关时指令默认全部走云端。五分钟上手先确认版本HA 核心版本需 ≥ 2024.4.4。然后按你喜欢的路子装方式一Git 克隆官方推荐方便回退到指定版本cd config git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home.git cd ha_xiaomi_home ./install.sh /config方式二HACS 一键安装—— 打开 HACS搜索框输入 Xiaomi Home进入详情页点 DOWNLOAD 即可。方式三手动安装—— 把custom_components/xiaomi_home整个文件夹复制到 HA 的config/custom_components目录下可用 Samba 或 FTP 传输重启 HA。装完开始登录进入「设置 设备与服务 添加集成」搜索Xiaomi Home按提示用小米账号 OAuth 登录然后在选择家庭与设备对话框里勾选要导入的米家家庭设备就批量进来了。家里有两个小米账号完全没问题进入「已配置 Xiaomi Home」点「添加中枢」再登录另一个账号即可。不同账号的设备甚至能放进同一个 HA 区域统一管理。落地玩法设备进来了才是好玩的部分。给你四个可以直接抄的场景回家自动开灯 —— 触发条件用门磁/人体传感器或手机地理围栏回家事件动作设为打开玄关灯、空调。因为状态是 MQTT 实时推送的人还没开门灯已经亮了。离家布防—— 自动化里把所有成员离家 布防时段设为触发动作开启摄像头录像并推送告警到你的 HA 通知通道门锁异常事件也会第一时间弹出来。一键影音模式—— 建一个场景打开电视、调暗灯光、音箱播轻音乐。配合米家音箱的 Notify 类实体还能让音箱用语音报观影模式已开启。能耗一眼看电耗 —— 把带电量计量的插座或智能电表作为传感器导入用 HA 的能源面板或仪表卡片查看客厅、厨房各自用了多少度电月底账单不再是一笔糊涂账。更多转换规则和细节可以参考 中文 README 和 源码目录 custom_components/xiaomi_home/miot/。能力边界与注意点上手前把这几条丑话说在前面能少走弯路不是 100% 全品类蓝牙设备、红外设备、虚拟设备暂不支持其余绝大多数品类都覆盖。本地模式有门槛中枢网关只在大陆地区销售局域网控制LAN control虽不限地区但只能控制同网段的 WiFi/网线直连设备且官方并不建议开启稳定性不如走中枢网关。可用地区云服务部署在中国大陆、欧洲、印度、俄罗斯、新加坡、美国六个区域配置时要选对地区跨地区的设备可以导入到同一个 HA 区域。安全提醒OAuth 令牌等用户信息明文存于 HA 配置文件服务器安全要自己守住怀疑泄露就去米家 App 撤销授权。适合谁适合愿意折腾 Home Assistant 的多设备小米用户如果你只有两三个设备且只用米家 App这套集成可能火力过剩。常见问题问我买了个小米蓝牙温度计能导入吗不能。蓝牙、红外和虚拟设备目前不在支持范围内WiFi/以太网/ZigBee 等品类基本都可以。问外网断了我的自动化还活着吗没有中枢网关的话指令要经云端中转外网断就失效了有小米中枢网关或内置中枢的设备时状态订阅和控制都走局域网断外网照样运转。问老公和老婆各有一个小米账号设备冲突吗不冲突。集成支持多账号登录两个账号的设备可以共存还能放到同一个区域里统一调度。写在最后ha_xiaomi_home 把官方出品、OAuth 安全登录、MQTT 实时状态、HTTP 下发指令、可选本地直连这几件事一次做齐了对小米生态 Home Assistant 双栈用户来说基本是目前最省心的选择。如果这篇指南帮你想通了接入路径不妨去翻一翻仓库里的 README、更新日志 和 贡献指南——看完之后你的米家设备可能正等着被自动化接管呢。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考