HA 桥接插件指南
seenzus Bridge 是跑在 Home Assistant 里的桥接插件,负责把你的空间与 seenzus 双向联通:
- 不需要内网穿透:桥从屋里主动连出公网 MQTT,你的 HA 不暴露任何端口;
- 凭证按桥签发:每座桥拿到的是自己专属的连接凭证,只能收发自己这一档的消息;
- 三通道协议:命令、结果、状态分流,设备状态以事件流回报——应用里看到的就是屋里正在发生的。
下载插件包后,解压放进 Home Assistant 的 config/custom_components/ 目录,重启 HA。
之后在 设置 → 设备与服务 → 添加集成 里就能搜到它。
配对方式一:快速配对(推荐)
Section titled “配对方式一:快速配对(推荐)”- 添加集成时选择 快速配对,填入 seenzus 服务地址;
- 浏览器自动打开授权页——登录你的账号,确认授权;
- 回到 HA,集成自动完成:桥拿到专属凭证,连上即开始上报设备目录。
整个过程你不需要手填任何 MQTT 参数。
配对方式二:手动 MQTT(自带 broker)
Section titled “配对方式二:手动 MQTT(自带 broker)”如果你想用自己的 MQTT broker(不经 seenzus 托管),选择手动模式: 自行填入 broker 地址、端口、用户名密码与 bridgeId,在应用的数据源页选「手动接入」 对应填写同一套参数即可。这是面向进阶玩家的逃生门——大多数人用快速配对即可。
- 应用数据源页出现这座桥的卡片,显示在线状态与覆盖范围(N 设备 · M 空间);
- 设备会陆续被认进空间——名字、分区可以在应用里整理,seenzus 会照着你的叫法来;
- 改名、换 broker、停用都在数据源卡片里:停用只断连接、保留数据。
| 症状 | 先看这里 |
|---|---|
| 授权页打不开 | 检查填的服务地址是否完整(含协议头);换浏览器重试 |
| 提示配对会话已失效 | 会话是一次性的——回 HA 重新发起一次快速配对 |
| 配对成功但设备没出现 | 等一会儿(目录同步需要片刻);确认数据源卡片显示「在线」 |
| 数据源显示离线 | 看 HA 里插件是否在跑;屋里断网/HA 重启后桥会自动重连 |
| 设备状态不更新 | 桥在线但状态停滞,试试在数据源卡片里「测试连接」 |
还没解决?去 常见问题 或直接找我们。