升级 Flarum 容器¶

升级 Flarum 容器（即更换镜像版本）时，请遵循以下步骤。核心原则是：先备份，再升级，后迁移数据库与缓存。

升级前准备¶

备份你的数据库、config.php、composer.lock 以及 assets 目录。

在后台管理面板中先禁用所有第三方扩展，再执行升级。

编辑 docker-compose.yml，将 image 改为目标版本：

services:
  flarum:
    image: forkdo/flarum:1.8
    # ... 其余配置保持不变

# 拉取新镜像
docker pull forkdo/flarum:1.8

# 停止并移除旧容器
docker compose stop flarum
docker compose rm flarum

# 用新镜像启动容器
docker compose up -d flarum

由于扩展列表位于数据卷 /flarum/app/extensions 中，容器重建后已安装的扩展会自动恢复（见扩展教程）。

# 执行数据库迁移
docker exec -ti flarum php /flarum/app/flarum migrate

# 清理缓存
docker exec -ti flarum php /flarum/app/flarum cache:clear

升级完成后，重新启用之前禁用的第三方扩展，并在浏览器中验证论坛功能正常。🎉 🎉