Skip to content

Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.

2.6 KB
Raw Blame

升级指南

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

备份

::: warning 先停止服务并备份 停止容器后,备份以下内容:

  • 整个数据目录和 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

更新镜像

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

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

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

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

从 v0.14.1 升级到 1.0.0

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

回退

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

:::

升级后检查

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