Docker版本升级后MariaDB容器无法远程访问的求助

1. 网络驱动兼容性验证 #

旧版本的nat网络驱动在Docker 20.10.x中已被移除，默认使用bridge驱动，需确认当前容器的网络配置：

• 查看容器使用的网络驱动：

  docker inspect <容器ID> | grep -i "driver"
  

• 若使用自定义网络，检查网络是否允许外部访问：确认自定义网络创建时是否添加--attachable参数，且子网未与宿主机或其他网络冲突
• 测试默认bridge网络：停止现有容器，重新启动时不指定自定义网络，使用默认bridge，再尝试远程连接

2. 端口映射有效性检查 #

确保--publish 3306:3306参数实际生效：

• 查看容器端口映射情况：

  docker port <容器ID> 3306
  

  需输出0.0.0.0:3306，若仅显示127.0.0.1:3306，则仅允许本地访问
• 检查宿主机端口监听状态：
  Linux系统：

  netstat -tulpn | grep 3306
  

  Windows系统：

  netstat -ano | findstr ":3306"
  

  确认监听地址为0.0.0.0而非仅回环地址

3. MariaDB绑定配置生效验证 #

确认bind-address=0.0.0.0配置已被正确加载：

• 进入容器验证实际生效的配置：

  docker exec -it <容器ID> bash
  mysql -u root -p -e "SHOW VARIABLES LIKE 'bind_address';"
  

  若结果不是0.0.0.0，检查：
  • 宿主机配置文件是否正确挂载到容器内的对应路径（常见路径：/etc/mysql/my.cnf或/etc/mysql/mariadb.conf.d/50-server.cnf）
  • 容器启动命令中是否包含正确的配置文件挂载参数（如-v /host/config/path:/container/config/path）

4. 数据库用户权限确认 #

验证远程访问用户的权限配置：

• 登录MariaDB执行：

  SELECT user, host FROM mysql.user;
  

  确保远程用户的host字段为%（允许所有IP）或指定的客户端IP
• 查看用户权限详情：

  SHOW GRANTS FOR '你的用户名'@'%';
  

  确认用户拥有ALL PRIVILEGES或至少远程连接所需的权限（如SELECT、INSERT等）

5. 日志与防火墙排查 #

• 查看容器日志中的错误信息：

  docker logs <容器ID>
  

  搜索bind、access denied、connection refused等关键词定位问题
• 检查宿主机防火墙规则：确保3306端口的入站流量被允许（如ufw allow 3306、firewall-cmd --add-port=3306/tcp --permanent）
• 检查Docker的iptables规则：

  iptables -L DOCKER
  

  确认存在允许3306端口转发的规则

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