手动配置桥接
需要填写什么
Section titled “需要填写什么”添加 seenzus MQTT Bridge 时选择「手动配置（高级）」，然后填写：
| 参数 | 说明 | 默认值 |
|---|---|---|
| MQTT Broker 地址 | 公网 MQTT 地址 | 必填 |
| MQTT 端口 | Broker 端口 | 1883 |
| MQTT 用户名 / 密码 | Broker 认证 | 空 |
| Topic 根路径 | 协议根路径 | seenzus/v2 |
| Bridge ID | 留空时自动生成 | 自动 |
其他高级开关保持默认即可。保存后集成会自动重载。
桥会通过 MQTT 接收命令并调用 Home Assistant 内部 API。自建 Broker 时必须：
- 使用专用账号和强密码；
- 只允许可信后端向
{topicRoot}/bridge/{bridgeId}/command/+发布； - 限制
result、state、presence、catalog的订阅权限； - 尽量使用 TLS（通常是 8883 端口）；
- 保持“模板渲染 API”“危险服务”“返回完整 config”关闭。
保存后检查：
- Home Assistant 中出现
seenzus MQTT Bridge； - 桥状态显示正在运行；
- seenzus 的「集成」页显示已连接；
- 首页或空间页能看到真实设备状态。
连接失败时，按排障指南检查 Broker 地址、认证和 Topic ACL。