Portainer部署的Django容器无法连接跨主机MySQL数据库

检查Docker网络配置 #

• 确认Django容器与数据库所在主机的网络可达性：
  • 若数据库为Docker容器，需确保两者加入同一自定义Docker网络（避免使用默认bridge网络），可在Portainer容器详情页查看网络归属。
  • 若数据库为外部物理机/主机，进入Django容器执行ping <数据库IP>，验证容器能否直接连通目标IP。
• 避免使用host网络模式：该模式会让容器复用宿主机网络栈，易引发IP混淆问题，建议改用自定义桥接网络。

验证Django数据库配置有效性 #

• 确认settings.py中的数据库配置未被覆盖：

  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.mysql',  # 对应你的数据库引擎
          'NAME': 'your_db_name',
          'USER': 'your_db_user',
          'PASSWORD': 'your_db_password',
          'HOST': '192.168.x.x',  # 确认此处为目标数据库IP，而非localhost/127.0.0.1
          'PORT': '3306',
      }
  }
  

• 检查Portainer容器环境变量：确认未设置DB_HOST等变量覆盖settings.py中的配置。
• 进入容器验证配置：执行python manage.py shell后输入以下代码，确认输出的IP为目标数据库IP：

  from django.conf import settings
  print(settings.DATABASES['default']['HOST'])
  

排查Nginx Proxy Manager的潜在影响 #

• 反向代理通常不干扰数据库TCP连接，但需确认：
  • 未在NPM中配置针对数据库端口的TCP转发规则（检查NPM的Hosts列表）。
  • NPM的HTTP代理配置未错误修改请求头（如X-Forwarded-For），该问题一般影响请求来源判断，而非数据库连接，但需排除。

检查网络防火墙与权限配置 #

• 在Portainer宿主机执行telnet <数据库IP> <数据库端口>，确认宿主机能访问数据库。
• 若宿主机可达但容器不可达，检查宿主机防火墙是否阻止容器网段的出站请求，或数据库主机防火墙是否拒绝容器IP的访问。
• 确认数据库权限配置：比如MySQL需授权user@<容器网段>访问，PostgreSQL需在pg_hba.conf中允许容器网段连接。

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