Postgres pgAdmin Docker Compose在Linux下连接超时如何解决？

关键解决步骤 #

1. 用服务名替代动态IP连接 #

别用172.18.0.3这种容器动态IP，在pgAdmin的连接配置里，把主机名/地址改成postgres（对应compose里的Postgres服务名），端口保持5432。Docker Compose的默认网络会自动解析服务名到对应容器，避免IP变动导致的连接失败。

2. 给pgAdmin加启动延迟 #

Postgres启动需要初始化时间，pgAdmin如果先启动就会触发超时。在compose的pgadmin服务配置里加依赖和延迟：

services:
  pgadmin:
    # 其他配置不变
    depends_on:
      - postgres
    command: ["/bin/sh", "-c", "sleep 10; /entrypoint.sh"]

让pgAdmin等Postgres启动10秒后再启动，确保数据库服务就绪。

3. 检查Postgres监听配置 #

如果挂载了自定义的postgresql.conf，确认里面设置了listen_addresses = '*'，允许所有地址访问。官方Postgres镜像默认已配置，但自定义配置时容易忽略这一点。

4. 排查Linux防火墙干扰 #

Linux防火墙可能阻断容器间通信，临时关闭防火墙测试：

# UFW防火墙
sudo ufw disable

# firewalld防火墙
sudo systemctl stop firewalld

测试正常后，添加Docker网络允许规则：

sudo ufw allow from 172.16.0.0/12

5. 验证容器间网络连通性 #

进入pgAdmin容器，测试和Postgres的网络连通：

# 替换为你的pgAdmin容器名
docker exec -it pgadmin_container /bin/sh

# 测试是否能解析服务名
ping postgres

# 测试端口是否开放
telnet postgres 5432

如果连通失败，重建Docker网络：

docker-compose down
docker network prune
docker-compose up -d

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