docker部署的Nextcloud，处于维护模式，如何解决

Nextcloud 在升级后卡在维护模式，以下是针对 Docker 部署的解决方案：

1. 通过 OCC 命令强制关闭维护模式

进入 Nextcloud 容器内部执行命令：

# 替换 `nextcloud` 为你的容器名称
docker exec -it --user www-data nextcloud php occ maintenance:mode --off

这会直接关闭维护模式 。如果命令执行成功，刷新页面即可恢复访问。

2. 手动修改配置文件（备用方案）

若上述命令无效，需手动修改配置文件 config/config.php：

1. 进入容器或挂载的配置目录：

   # 方式1：直接进入容器
   docker exec -it nextcloud /bin/bash
   # 方式2：宿主机直接编辑（需提前挂载配置目录）
   

2. 找到 'maintenance' => true，改为 'maintenance' => false 或直接删除该行 。

3. 检查升级残留问题

如果维护模式反复出现，可能是升级未完成导致：

• 重新运行升级脚本：

  docker exec -it --user www-data nextcloud php occ upgrade
  

• 修复文件权限（容器内执行）：

  chown -R www-data:www-data /var/www/html
  

4. Docker 服务重启

完成上述操作后重启容器：

docker-compose down && docker-compose up -d

关键注意事项

• 优先使用 OCC 命令，避免直接修改配置文件 。
• 如果问题持续，检查容器日志（docker logs nextcloud）排查数据库连接或文件权限问题 。
• 后续升级建议通过 docker-compose pull 和 docker-compose up -d 完成，避免 Web 界面升级的稳定性问题 。