连接 Home Assistant

HA Bridge 通过 Home Assistant API 读取状态并调用服务。首次连接需要连接名称、HA 地址和长期访问令牌。

1. 打开连接设置

1. 登录 HA Bridge。
2. 第一次配置点击顶部的「HA 未配置」；已配置时点击 Home Assistant 状态按钮并选择「修改」。
3. 在弹窗中填写连接名称、Home Assistant 地址和长期访问令牌。

2. 创建长期访问令牌

1. 打开 Home Assistant，点击左下角的用户名。
2. 打开「安全」选项卡，滑动到「长期访问令牌」区域。
3. 点击「创建令牌」，填写容易识别的名称，例如 ha_bridge。
4. 复制生成的完整令牌并妥善保存。

令牌只完整显示一次；忘记后需重新创建。不要公开令牌或包含令牌的截图。

3. 填写地址并验证证书

1. 填写 HA 服务根地址，例如 http://192.168.1.100:8123，不要带 /lovelace、/config 等页面路径。
2. 粘贴长期访问令牌。
3. 受信任的 https:// 域名保持「验证 HTTPS 证书」勾选；内网 http:// 不勾选。内网自签名 HTTPS 只有在确认网络可信并接受风险时才取消勾选。
4. 点击「测试连接」，成功后点击「保存并连接」。

连接成功后会同步实体、设备和区域并显示数量。之后可在实体选择器中按设备名称或 entity_id 搜索，绑定灯光、开关、窗帘、空调、传感器等实体；HA 中新增或修改设备后，等待同步即可使用。点击顶部连接状态可查看地址、版本和实体数量。

编辑已有连接时，如果长期访问令牌输入框留空，保存会继续使用原令牌；只有在需要更换令牌时才粘贴新的完整令牌。

连接失败时检查

• 确认 HA Bridge 所在设备能访问填写的地址和端口，局域网通常使用 http://内网 IP:8123。
• HTTPS 失败时检查证书是否过期、域名是否匹配或证书链是否完整；证书验证开关不能修复地址、端口或令牌错误。
• 长期访问令牌属于私密信息，不要公开。