备份与恢复

HA Bridge 的仪表盘、图片、连接配置和授权运行信息都保存在持久化目录中。备份或迁移时，请同时保留 data、secrets 和部署配置。

需要备份的内容

内容	作用
data	保存数据库、仪表盘、图片素材、户型草稿和运行数据；支持账号重置的新版还包含 admin-account.json。
secrets	保存 Home Assistant 凭据和授权运行所需信息，必须与 data 一起备份。
部署配置	保存 compose.yaml 或 Docker Run 命令中的镜像、端口、网络和挂载路径，便于恢复。

备份步骤

1. 停止 ha-bridge 容器或对应的 Compose 项目，避免备份时仍有文件写入。
2. 完整复制 data 和 secrets 文件夹，并保留原有目录结构和文件权限。
3. 保存当前部署配置，记录实际使用的镜像地址、访问端口和宿主机路径。
4. 检查备份目录不是空目录，并确认 data 和 secrets 都能正常读取。

只备份 data 不算完整备份；不要使用空的 data 或 secrets 覆盖已有数据。

支持独立账号文件的新版，需要把 admin-account.json 随整个 data 一起备份。它保存管理员用户名和密码哈希，应与密钥一样妥善保管；不要只复制 app.db 后就认为账号、图片和密钥也已备份。

Home Assistant Add-on 用户应创建包含 HA Bridge Add-on 及其数据的备份，操作方式见HAOS 备份与恢复。

恢复到原设备

1. 按原来的部署方式重新创建或启动 HA Bridge，但先不要进入正常使用流程。
2. 停止新创建的 ha-bridge 容器或 Compose 项目。
3. 用备份中的 data 和 secrets 分别替换当前对应目录。
4. 确认部署配置仍挂载这两组目录，右侧容器路径保持为 /data 和 /run/secrets。
5. 启动容器，登录后检查仪表盘、图片、Home Assistant 连接和授权状态。

从尚未分离账号的旧版完整备份恢复到支持此功能的新版时，系统会从旧数据库迁移原账号，无需手工创建账号文件。从已经分离账号的备份恢复时，如果遗漏 admin-account.json，新版会认为需要重新设置账号。

忘记账号密码不需要恢复整套备份，按重置本地账号与密码操作即可。若要回退到分离账号之前的旧程序，请使用与该版本匹配的升级前完整备份，不要只换旧镜像继续使用已经升级的数据。

恢复到新设备

迁移到新 NAS、服务器或小主机时，先完成解绑与建议，再按以下顺序操作：

1. 在新设备上按对应教程部署 HA Bridge。
2. 停止新设备上的容器，将旧设备备份的 data 和 secrets 复制到新设备对应位置。
3. 检查新设备的挂载路径、端口和网络配置。
4. 启动容器，使用原授权完成激活。
5. 确认仪表盘、图片素材、Home Assistant 连接和设备控制都正常后，再清理旧设备。

迁移完成前，不要删除旧设备的备份、容器或数据目录。