Docker Compose部署的PostgreSQL容器连接超时，如何配置可访问？

核心问题分析 #

从报错信息和容器状态来看，PostgreSQL容器已正常启动，但同网络内的其他容器无法通过TCP连接访问，核心原因是PostgreSQL默认仅监听localhost，没有绑定容器的内网IP地址，导致外部容器请求被拒绝。

分步解决方案 #

1. 修改PostgreSQL监听配置，允许所有IP访问 #

PostgreSQL默认配置仅允许本地连接，需要修改listen_addresses参数为*，可通过两种方式实现：

方式一：通过docker-compose环境变量直接配置

在docker-compose.yml的heritagebuxfr-postgres服务下添加环境变量：

services:
  heritagebuxfr-postgres:
    image: postgres:12
    environment:
      - POSTGRES_DB=heritagebuxfr
      - POSTGRES_USER=heritagebuxfr
      - POSTGRES_PASSWORD=xxxxxxxx
      - POSTGRES_LISTEN_ADDRESSES=*  # 关键：监听所有IP
    restart: always
    volumes:
      - /data/heritagebuxfr-posgtres:/var/lib/postgresql/data
    networks:
      heritagebuxfr:
        ipv4_address: 10.8.0.5

networks:
  heritagebuxfr:
    driver: bridge
    ipam:
      config:
        - subnet: 10.8.0.0/16

方式二：挂载自定义配置文件

若需要更复杂的配置，可在宿主机创建postgresql.conf文件，设置：

listen_addresses = '*'

然后在docker-compose的volumes中添加挂载：

volumes:
  - /data/heritagebuxfr-posgtres:/var/lib/postgresql/data
  - /path/to/your/postgresql.conf:/var/lib/postgresql/data/postgresql.conf

2. 验证容器内PostgreSQL监听状态 #

进入PostgreSQL容器，检查端口监听情况：

docker exec -it root_heritagebuxfr-postgres_1 bash
# 容器内执行
netstat -tulpn | grep 5432

正常输出应显示0.0.0.0:5432，表示已监听所有IP地址。

3. 测试网络连通性 #

先在测试容器中ping PostgreSQL容器IP，确认网络可达：

docker run -it --rm --network root_heritagebuxfr busybox ping 10.8.0.5

若ping通但连接失败，用telnet测试端口：

docker run -it --rm --network root_heritagebuxfr busybox telnet 10.8.0.5 5432

若telnet超时，回到步骤1确认监听配置；若telnet成功，检查连接命令是否正确。

4. 修正连接命令（可选） #

直接用容器IP测试连接，避免DNS解析问题：

docker run -it --rm --network root_heritagebuxfr postgres psql -h 10.8.0.5 -U heritagebuxfr -d heritagebuxfr

若服务名heritagebuxfr-postgres无法解析，可重启Docker服务修复DNS：

systemctl restart docker

5. 检查iptables规则（可选） #

从提供的iptables输出看，DOCKER链中缺少针对10.8.0.5:5432的ACCEPT规则，可手动添加：

iptables -A DOCKER -d 10.8.0.5/32 -p tcp -m tcp --dport 5432 -j ACCEPT

更推荐重启Docker服务，让其自动生成正确规则。

验证修复 #

修改配置后重启PostgreSQL容器：

docker-compose down && docker-compose up -d

重新执行连接命令，即可正常访问PostgreSQL服务。

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