升级与回滚

升级会短暂停止实时查看和录像。先安排可接受的停机时间，再按下面的步骤操作。备份的范围和恢复方法见备份与监控。

升级

1. 先做一次停服备份，记下当前版本号。版本号在 设置 → 常规 → 关于 → 第三方软件声明 的第一行。
2. 停止 Rerinku View，替换程序文件，再启动。内置的 FFmpeg、识别组件会随新版本自动更新；config.yaml 不会被覆盖，也不会自动加上新的配置项。
3. 数据库结构的升级在启动时自动完成，只向前执行、每项只执行一次。
4. 检查健康检查、设备数量、实时画面和历史回放。

Docker 升级

在 Compose 文件所在目录操作。先停止容器，并备份挂载到 /data 的完整目录或命名卷（包含配置、数据库和 secret.key）；保留原来的镜像版本，以便需要时回滚。

docker compose stop
# 完成数据卷备份后再继续
docker compose pull
docker compose up -d
docker compose logs --tail=100

沿用原有的卷挂载和配置。不要用 docker compose down -v，它会移除命名卷。使用固定镜像标签时，先在 Compose 文件中改为已发布的目标版本。

升级后验证

确认 /healthz 返回 200，设备数量与升级前一致；打开一台摄像头的实时画面，回放一段升级前的录像，再确认升级后也有新录像。有使用 AI、远端存储或快速连接时，分别检查识别结果、上传状态和外网访问。失败时先保存日志，参照故障排查定位。

回滚

新版本启动后，数据库结构已经升级，不能只换回旧程序，部分升级会删除旧的字段和表：

1. 停止新版本，保留日志和当前数据的副本。
2. 恢复升级前的数据库备份；录像目录通常可以保留。
3. 如果在新版本期间往配置文件里加了旧版本不认识的配置项，先删掉，否则旧版本会拒绝启动。
4. 启动旧版本，检查健康检查、设备、录像和回放。