升级指南

升级前先查看更新日志，确定目标版本及其迁移说明。可以在后台概览的运行信息中查看当前版本。

1

备份

先停止服务并备份

停止容器后，备份以下内容：

• 整个数据目录和 Compose 文件。
• 旧部署仍在使用的 .env。
• data 目录之外的本地照片，以及 S3 / OpenList 中的外部文件。

docker compose stop chronoframe
mkdir -p backups
cp -a data "backups/data-$(date +%Y%m%d-%H%M%S)"
cp docker-compose.yml backups/docker-compose.yml

2

更新镜像

在 Compose 文件中将镜像标签改为目标版本，例如 v1.0.0，然后执行：

docker compose pull chronoframe
docker compose up -d chronoframe
docker compose logs -f chronoframe

启动时自动迁移

容器启动时会自动执行数据库迁移，正常情况下无需手动运行迁移命令。当前运行镜像不包含 shell 和包管理器，旧文档中的 docker exec ... sh 或容器内 npx drizzle-kit migrate 不适用。

直接使用 docker run 的部署，先停止并移除旧容器，再用新标签和相同的数据挂载重建。保留原有的端口、网络和仍有用途的部署环境变量。

从 v0.14.1 升级到 1.0.0

• 使用 v1.0.0 标签固定版本，或使用 latest 跟随正式版。
• 首次升级时先保留旧环境变量，让应用迁移可识别的设置和存储方案。启动后在后台核对站点、地图、登录和存储是否正确，再整理旧 .env。
• 1.0.0 修复了重启覆盖后台设置的问题，后续以后台保存的设置为准。
• 如果升级后进入向导，使用已有管理员邮箱，确认原存储路径，不要新建空数据目录。先核对挂载和启动日志，再继续操作。
• 会话密钥、数据库、存储路径等部署数据必须保留。代理信任等部署选项仍由运行环境提供，不属于可删除的旧站点设置。

回退

回退时同时恢复数据库

数据库迁移可能改变结构。需要回退时，停止新容器，恢复升级前的完整数据备份，再使用原版本标签启动。不要只降级镜像并继续使用已经迁移的数据库。

3

升级后检查

确认能登录后台，打开几张已有照片，尝试上传一张照片，并检查相册、地图和任务队列。1.0.0 新增了隐藏相册照片的访问限制，升级后也应检查公开画廊。