连接 Home Assistant

HA Bridge 通过 Home Assistant 地址和长期访问令牌读取实体，并在仪表盘中执行你允许的操作。

1. 打开 HA Bridge 的连接设置

1. 登录 HA Bridge 后，点击顶部的「HA 未配置」。
2. 在弹窗中填写 Home Assistant 地址和长期访问令牌。

2. 在 Home Assistant 创建令牌

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

令牌只会完整显示一次；如果忘记，需要在 Home Assistant 中重新创建。

3. 填写信息并连接

1. 在 HA Bridge 填写 HA 地址，例如 http://192.168.1.100:8123。
2. 粘贴刚刚创建的长期访问令牌。
3. 如果使用受信任的 https:// 域名，保持「验证 HTTPS 证书」勾选；如果使用内网 http:// 地址，则不需要勾选。内网 https:// 使用自签名证书时，只有明确接受风险后才取消勾选。
4. 按需先点击「测试连接」，然后点击「保存并连接」。

连接成功后，系统会同步实体、设备和区域，并显示同步数量。

常见注意点

• HA 地址应填写 NAS 能访问到的地址，局域网内通常使用 http://内网 IP:8123。
• 使用 https:// 地址时，HA Bridge 默认会验证证书。若证书过期、域名与证书不匹配、证书链不完整或使用未受信任的自签名证书，测试连接可能失败；请先在 HA Bridge 所在设备上确认该 HTTPS 地址可以正常访问。
• 使用 http:// 地址时不使用 TLS，因此不需要勾选「验证 HTTPS 证书」；常见的内网地址示例是 http://192.168.1.100:8123。
• 只有在你明确了解风险时，才取消「验证 HTTPS 证书」；这会降低连接安全性，不建议作为常规排错方式。
• 不要在地址末尾添加多余路径，例如 /lovelace。
• Home Assistant 的地址、令牌和同步数据属于私密信息，不要把截图中的令牌公开。