小米智能家居接入 Home Assistant 完整指南4 步把小米设备统一管理起来【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_homeha_xiaomi_home 是小米官方的 Home Assistant 集成组件一句话概括它的本事把小米设备接入 Home Assistant 统一管理。你只需要登录小米账号家里的灯、插座、空调就会出现在 HA 的设备列表里还能直接写进自动化和仪表盘。这篇带你从装到配走一遍全程不用碰任何协议细节。先说它能帮你干什么一个面板管所有小米设备不再在米家 App和HA之间来回切所有小米设备变成标准 HA 实体和别家设备放在同一套界面里本地化控制有小米中枢网关时控制指令和状态更新走局域网指令不发外部网络响应更快断外网时家里设备照样能控自动化联动设备的属性变化、事件比如门窗传感器触发都会同步给 HA可以直接作为自动化的触发条件和执行目标动手前3 件事先自查Home Assistant 版本Core ≥ 2024.4.4用官方镜像的话Operating System ≥ 13.0你能打开终端并且知道 HA 配置目录在哪比如/config或~/homeassistant小米 App 里你要接入的设备已经配好并且显示在线4 步把小米家居接进 Home Assistant第 1 步克隆 ha_xiaomi_home 仓库把仓库拉到你的 HA 服务器上git clone https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home第 2 步跑安装脚本把组件拷进 config脚本会把xiaomi_home组件复制到你的 HA 配置目录下的custom_componentsbash install.sh /path/to/your/homeassistant/config路径换成你真实的配置目录。遇到权限报错给命令前面加个sudo再跑一次。跑完会提示安装完成重启一下 Home Assistant。第 3 步添加集成登录小米账号进设置 设备与服务 添加集成搜索Xiaomi Home按页面提示登录小米账号。这一步走的是 OAuth 授权密码由小米的登录页处理账号信息不会明文存在 HA 里开了两步验证的话输完密码及时填验证码。整个交互流程定义在 config_flow.py 里出问题时可以对照源码看它卡在哪一步。第 4 步选家居分组挑设备登录成功后会弹出选择家居和设备的对话框。选中设备所在的家居确认要导入的设备清单保存即可。设备会出现在 HA 的设备列表里每个属性按 MIoT 规范自动映射成对应的实体开关、传感器、数值等。云端还是本地按你家网络选模式集成支持两种控制链路差别主要在指令走哪条路云端控制本地控制延迟经小米云中转稍高局域网直连更低断外网时控制不可用仍可控制网关和供电正常即可前置条件小米账号 外网通畅小米中枢网关固件 ≥ 3.3.0_0023或内置中枢网关的设备软件版本 ≥ 0.8.9适用场景需要远程控制、没有网关家庭日常使用、对响应速度有要求建议很直接家里有小爱中枢网关就直接选本地体验最好没有网关就用云端它靠消息订阅机制推送状态并不会频繁轮询日常使用也够顺。另外配置里有个小米 LAN 控制选项能部分本地化控制 Wi-Fi 直连设备但项目 README 明确不推荐开启可能引发异常可以当备胎别当主力。想让体验再顺一点3 个进阶选项状态同步实体生成与同步逻辑分布在 sensor.py 等实体文件里想调状态更新行为可以从这里入手多语言显示界面文案在 translations/zh-Hans.json想自定义设备名称和状态描述可以直接改自动化规则在 HA 的自动化编辑器里把 Xiaomi Home 的实体当触发条件、目标动作用就能搭出回家开灯这类自定义场景最常踩的 3 个坑Q设备发现不到列表里是空的先确认设备在小米 App 里是否在线再确认 HA 和小米设备在同一局域网路由器别开 AP 隔离。两个都没问题就重启小米网关和 HA再重新触发一次集成。Q控制指令延迟大、偶尔失败这是典型的云端链路波动。有中枢网关的话切到本地模式基本能解决没有网关就看 miot_network.py 相关的超时表现确认设备固件升到最新版。Q集成成功了但设备状态一直不更新按这个顺序查先到开发者工具里看实体属性是否在变再检查集成日志里状态监听的记录逻辑在 miot_device.py最后去设置 设备与服务 Xiaomi Home重新加载集成试试。⚠️想继续深挖的话CONTRIBUTING.md 讲了怎么参与开发改了本地化规则或想验证自己的配置可以跑跑 test/test_lan.py 这类测试脚本。项目迭代很快装完记得看一眼 CHANGELOG.md 了解当前版本的改动。【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考