无法从容器连接Docker主机PostgreSQL数据库的原因排查

这个问题我之前踩过好几次坑，大概率是下面几个原因导致的，你可以一步步排查：

1. PostgreSQL 默认只监听本地回环地址 #

默认情况下，PostgreSQL的配置文件里listen_addresses只设为localhost（也就是127.0.0.1），这意味着它只会响应来自主机本地的连接请求，docker0网段的172.17.0.1自然连不上。

解决步骤：

• 找到PostgreSQL的配置文件postgresql.conf：
  • Ubuntu/Debian系统一般在/etc/postgresql/<你的PostgreSQL版本>/main/postgresql.conf
  • CentOS/RHEL系统一般在/var/lib/pgsql/<你的PostgreSQL版本>/data/postgresql.conf
• 打开文件，找到listen_addresses这一行，修改为：

  listen_addresses = '*'
  

  （或者更严谨一点，设为'127.0.0.1,172.17.0.1'，只允许本地和docker网段访问）
• 重启PostgreSQL服务：

  # Ubuntu/Debian
  sudo systemctl restart postgresql
  # CentOS/RHEL
  sudo systemctl restart postgresql-<版本号>
  

2. PostgreSQL的访问控制列表（pg_hba.conf）没放行docker网段 #

就算PostgreSQL监听了所有地址，它的访问控制列表也可能拒绝来自172.17.0.0/16网段的连接请求。

解决步骤：

• 找到同目录下的pg_hba.conf文件，添加一条规则到文件末尾：

  host    all             all             172.17.0.0/16            scram-sha-256
  

  （如果你的PostgreSQL版本比较旧，认证方式可能是md5，根据实际情况调整）
• 同样重启PostgreSQL服务让配置生效。

3. 主机防火墙/iptables挡住了5432端口 #

主机的防火墙（比如ufw、firewalld）可能默认禁止了外部网段访问5432端口，导致容器的连接请求被拦截。

解决步骤：

• 如果是Ubuntu的ufw防火墙：

  sudo ufw allow from 172.17.0.0/16 to any port 5432
  sudo ufw reload
  

• 如果是CentOS的firewalld：

  sudo firewall-cmd --add-rich-rule='rule family="ipv4" source address="172.17.0.0/16" port port="5432" protocol="tcp" accept' --permanent
  sudo firewall-cmd --reload
  

• 另外也可以检查iptables规则，确保没有拒绝docker0网段的5432端口流量。

4. 额外检查：PostgreSQL服务是否正常运行 #

虽然可能性不大，但还是确认一下主机上的PostgreSQL服务是否正常启动：

sudo systemctl status postgresql

如果服务没运行，先启动它：

sudo systemctl start postgresql

按照这个顺序排查下来，基本就能解决容器内连接主机PostgreSQL被拒绝的问题了。

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