步骤 1 - 检查更新

容器版本号始终与 Piwigo 版本保持一致；从 16.3.0 版本开始，容器版本号后会新增一个字母，以支持容器专属更新

适用于容器版本 16.3 及以上

你应已能在更新界面查看是否有可用更新；若需更新至次版本，请使用标签的第一个数字（例如：16）

适用于容器版本 16.2 及以下

前往标签列表页，搜索你想要更新到的标签

步骤 2 - 创建备份

为确保更新过程零风险，你需备份 Piwigo 实例的数据库和文件（含所有数据）

备份数据库

你可通过以下命令创建数据库备份：

docker exec -it piwigo-db-1 mariadb-dump -u piwigodb_user -p "piwigodb" | tee db_dump.sql

数据库密码需与你填写在 .env 文件中的密码一致（请务必替换容器名称为你自己的）

现在你可执行 docker compose down 停止容器

备份文件

如需备份上传至 Piwigo 的所有图片 / 照片，请复制以下文件夹：

      ./piwigo-data/piwigo/
      ├── galleries
      ├── local
      └── upload
    

备份 compose 和 env 文件

为你的 compose 和 env 文件重命名，在文件名末尾添加 .bak 后缀（例如：.env.bak）