重置本地账号与密码

本页用于忘记 HA Bridge 本地管理员账号或密码时重新设置登录。它不会修改 Home Assistant 账号或授权商店账号，也不需要解除设备授权绑定。

先确认版本支持

独立账号文件重置属于 v0.4.5 之后的待发布更新。本文编写时正式版仍为 v0.4.5；请在包含此功能的版本发布并完成升级后使用。

支持此功能的版本会在登录页显示删除 admin-account.json 的提示，并在首次设置或迁移旧账号时自动生成这个文件。旧版没有此文件时，不要删除数据库来代替，也不要自己新建一个空文件。

下面是支持此功能的登录页提示。截图来自本地待发布构建，版本文字暂时仍显示 0.4.5；示例未填写任何真实账号或密码。

旧用户升级会改变账号密码吗

不会。首次升级到支持此功能的版本时，系统会把原登录凭据迁移到独立文件，原账号和密码继续有效，仍有效的登录会话可以继续使用。普通更新时保留这个文件即可，无需重新设置。

文件保存的是用户名和密码的单向哈希，不是可读取的密码明文。不要把账号文件、数据库或密钥发到用户群中。

Docker / NAS 如何找到文件

账号文件位于 HA Bridge 容器的 /data/admin-account.json。先打开容器的挂载或存储设置，找到容器路径为 /data 的那一项；它对应的宿主机目录就是需要查看的位置。

例如采用通用 Docker 部署中的挂载：

/opt/ha-bridge/data:/data

对应文件就是 /opt/ha-bridge/data/admin-account.json。NAS 使用其他目录时，以自己的实际挂载为准；它不在 DockerCopilot 的数据目录，也不在 Home Assistant 的配置目录中。

使用 Docker 命名卷的用户应通过该卷的管理方式查看数据，不能照搬上面的宿主机路径。

重置步骤

1. 确认要操作的是自己的 HA Bridge 实例，并按备份与恢复保留一份操作前备份。
2. 在 NAS 容器管理器中停止 HA Bridge 容器。
3. 在刚才确认的数据目录中，只删除 admin-account.json。
4. 按原挂载配置重新启动同一个 HA Bridge 容器。
5. 打开原来的 HA Bridge 地址，系统会进入设置页；也可以在原地址后加 /setup，例如 http://设备 IP:18080/setup。
6. 填写新的管理员账号、密码和确认密码，点击「保存账号并进入系统」。
7. 登录后检查原有仪表盘、户型、Home Assistant 连接和授权状态。

账号至少 3 个字符，密码至少 8 个字符。重新设置成功后，系统会生成新的账号文件。

重置只影响管理员登录：旧登录会话会失效，项目、户型草稿、图片素材、Home Assistant 配置、授权以及中控配对数据继续保留。若改用了新账号或新密码，后续使用新凭据登录。

只删除这一个文件

不要删除 app.db、data 整个目录、secrets 或 /run/secrets，也不要卸载并清除应用数据。这些操作不是账号重置，可能造成户型、连接或其他数据丢失。

没有停止就删除了怎么办

删除后不会立即退出登录：正在运行的 HA Bridge 仍使用已载入的凭据，原账号密码还可以登录，设置页也不会立刻开放。

重新启动 HA Bridge 后，系统才会发现文件缺失、清除旧管理员会话并进入重新设置。业务数据不会因为只删除账号文件而被清空。

Home Assistant Add-on 用户

先确认已安装的 Add-on 版本也包含独立账号文件功能；独立 Docker 镜像更新不代表 Add-on 已同步更新。

Add-on 的 /data 是该应用自己的持久化数据目录，不等同于 Home Assistant 的 /config，也不是其他 File editor、Samba 或终端 Add-on 所看到的 /data。普通文件编辑器不一定能访问它。

请先在 Home Assistant 创建包含 HA Bridge Add-on 数据的备份，再停止 HA Bridge Add-on。能够确认并访问其真实数据目录时，只删除其中的 admin-account.json 后重新启动；无法定位目录时，提供安装方式和 Add-on 版本寻求协助，不要通过卸载、清空数据或删除 Home Assistant 配置尝试重置。

找不到文件或启动失败

• 找不到文件：先核对版本、首次启动是否完成、实际挂载目录是否正确；新安装尚未创建管理员时没有账号文件是正常的。
• 重启后仍进不了设置页：确认删除的是当前实例的文件，且确实重启了该实例；再查看启动日志。
• 提示账号文件无法读取：文件可能被手工修改、损坏或权限不正确。先备份并查看日志，修复文件或按本页步骤重新设置，不能用空 JSON 代替。
• 原来的项目也不见了：停止操作并检查挂载路径。只删除账号文件不会删除项目；不要继续创建新项目覆盖恢复线索。