Portainer环境下Nextcloud容器更新后无法连接MariaDB数据库

1. 彻底重启Nextcloud容器 #

更新后容器可能残留网络缓存问题，直接删了重跑（保留卷数据，不会丢内容）：

• 在Portainer里找到Nextcloud容器，先停止，再删除，然后用原配置重新创建容器。
• 用命令行操作的话：

  docker stop nextcloud
  docker rm nextcloud
  docker run [你的Nextcloud启动参数，确保指定--network nextcloud_default]
  

2. 核对数据库连接的主机名 #

别用静态IP，直接用MariaDB的容器名当主机名（Docker同网络内可以直接通过容器名解析）：

• 先确认MariaDB的容器名（比如叫mariadb），然后检查Nextcloud的config/config.php里的dbhost字段：

  docker exec -it nextcloud cat config/config.php | grep dbhost
  

  把值改成MariaDB的容器名，别用IP。

3. 检查MariaDB的监听配置 #

确保MariaDB不是只监听本地回环地址：

• 进入MariaDB容器查看配置：

  docker exec -it mariadb cat /etc/mysql/my.cnf | grep bind-address
  

  如果显示bind-address = 127.0.0.1，改成0.0.0.0，然后重启MariaDB容器。

4. 测试容器间端口连通性 #

进入Nextcloud容器，用telnet测MariaDB的3306端口：

docker exec -it nextcloud telnet mariadb 3306

如果连不上，说明端口被阻断，要么是MariaDB配置问题，要么是网络规则限制。

5. 重建Docker网络 #

有时候自定义网络会出现异常，直接重建：

1. 停止Nextcloud、MariaDB、phpMyAdmin三个容器
2. 删除旧网络：

   docker network rm nextcloud_default
   

3. 重新创建网络（如果是用docker-compose部署的，直接启动容器会自动重建网络）：

   docker network create nextcloud_default
   

4. 重新启动三个容器，确保都加入这个网络。

6. 排查宿主机/容器防火墙 #

• 检查宿主机的iptables规则，确保Docker网络的流量被允许：

  iptables -L | grep docker
  

• 进入Nextcloud容器，查看是否有内部防火墙规则阻断出站流量：

  docker exec -it nextcloud iptables -L
  

内容的提问来源于stack exchange，提问作者Struppi