Docker中运行的PgAdmin无法连接本地Postgres服务器

核心原因 #

Docker容器内的127.0.0.1指向容器自身，而非你的本地宿主机——你用127.0.0.1在PgAdmin里连接，实际是找容器内部的PostgreSQL，自然连不上。

修复步骤 #

• 替换PgAdmin中的主机地址
  根据操作系统，用宿主机在Docker网络中的专属地址：

  • Linux/macOS/Windows（Docker Desktop）：直接填host.docker.internal
  • Windows（Docker Toolbox）：填192.168.99.100
  • 通用方案：直接用宿主机的局域网IP（比如192.168.1.100，可通过ifconfig/ipconfig查询）

• 确保PostgreSQL允许外部连接
  本地PostgreSQL默认可能只允许localhost连接，需要调整配置：

  1. 打开PostgreSQL配置文件postgresql.conf，找到listen_addresses项，修改为：

     listen_addresses = '*'
     

  2. 打开pg_hba.conf，添加一行连接规则（按需选择）：

     # 允许所有IP连接（测试用，方便但不安全）
     host    all             all             0.0.0.0/0               md5
     # 只允许Docker默认子网连接（更安全）
     host    all             all             172.17.0.0/16           md5
     

  3. 重启PostgreSQL服务（Linux用systemctl restart postgresql，Windows在服务管理器中操作）

• 重新测试连接
  在PgAdmin的服务器配置中，把主机地址换成上述地址，保持端口、用户名、密码不变，再尝试连接即可。

补充说明 #

你本地的SQLAlchemy能正常连接，是因为它运行在宿主机上，127.0.0.1直接指向本地PostgreSQL服务，和Docker容器的网络环境完全不同。

内容的提问来源于stack exchange，提问作者Bobby Wan-Kenobi