Docker容器内无法连接Postgres数据库的问题求助

1. 优先使用Docker内网通信（避免NAT回环问题） #

Digital Ocean Droplet的容器内通过公网IP访问自身端口映射可能触发NAT回环限制，导致超时。直接用容器内网IP或容器名连接：

• 查看Postgres容器的内网IP：docker inspect -f '{{.NetworkSettings.IPAddress}}' postgres
• 在backend容器内用内网IP连接：psql --host <postgres_ip> --port 5432 -U root -d main
• 如果两个容器在同一个Docker网络（默认bridge或自定义网络），可以直接用容器名作为主机名：psql --host postgres --port 5432 -U root -d main

2. 检查Postgres的监听与权限配置 #

• 进入Postgres容器，修改/var/lib/postgresql/data/postgresql.conf，确保：

  listen_addresses = '*'
  

• 修改/var/lib/postgresql/data/pg_hba.conf，添加允许Docker子网的连接规则（以默认bridge子网为例）：

  host    all             all             172.17.0.0/16            scram-sha-256
  

• 重启Postgres容器：docker restart postgres

3. 验证容器网络连通性 #

在backend容器内执行以下命令排查：

• 测试Postgres容器IP可达性：ping <postgres_ip>
• 测试端口开放情况：telnet <postgres_ip> 5432 或 nc -zv <postgres_ip> 5432

4. 检查容器运行状态与日志 #

• 确认Postgres容器正常运行：docker ps | grep postgres，状态应为Up
• 调整Postgres日志级别获取更多信息，重启容器时添加参数：

  docker run ... -c log_statement=all -c log_min_messages=debug postgres
  

  再查看日志：docker logs postgres

5. 服务器防火墙与安全组检查 #

• 检查服务器本地防火墙（如ufw）是否允许Docker子网的流量：ufw status，确保没有拦截172.17.0.0/16等Docker内网段的请求
• 检查Digital Ocean安全组，若必须通过公网IP连接，需确保入站规则开放8080端口（你当前映射的端口）

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