Docker Compose部署PostgreSQL无法通过localhost:5432访问，需稳定连接方案

看到你的问题了，Windows 10上用Docker Compose部署PostgreSQL，其他容器都能正常通过localhost访问，唯独PostgreSQL连不上，而且容器IP还会动态变化，确实挺折腾人的，我来帮你一步步解决这两个问题。

一、先解决localhost:5432无法访问的问题 #

先排查几个常见的原因：

• 检查主机端口是否被占用：打开Windows命令提示符，运行 netstat -ano | findstr :5432，看看有没有其他进程（比如本地安装的PostgreSQL）占用了5432端口。如果有，要么关闭该进程，要么把compose里的端口映射改成5433:5432，用主机的5433端口访问数据库。
• 检查Docker网络后端的映射问题：如果你用的是WSL2后端的Docker，可以试试从WSL2终端里访问localhost:5432，有时候Windows主机的localhost和WSL2的localhost会存在映射差异。另外也可以在Docker Desktop的设置中，确认“Settings > Resources > WSL Integration”里对应的WSL发行版是开启状态。
• 验证PostgreSQL的监听配置：虽然官方postgres镜像默认允许所有IP访问，但可以进入容器确认一下。运行 docker exec -it db bash，然后查看/var/lib/postgresql/data/postgresql.conf里的listen_addresses参数是否为*。如果不是，修改后重启容器即可。
• 检查Windows防火墙拦截：临时关闭Windows防火墙，再尝试访问localhost:5432，如果能成功连接，说明防火墙拦截了Docker的端口映射，需要给Docker添加防火墙允许规则。

二、实现稳定的数据库连接（摆脱动态IP） #

你的核心需求是部署应用时能稳定访问数据库，不用每次修改IP，这里有两个实用方案：

方案一：同一Compose网络内用服务名访问（推荐） #

如果你的应用也是通过Docker Compose部署的（和Redis、PGAdmin在同一个compose文件里），直接用服务名db作为数据库的主机名即可。比如数据库连接字符串可以写成：
postgresql://postgres:1432@db:5432/telegram_bot_db

Docker Compose会自动在内部网络中把服务名解析为容器的IP，不管容器重启后IP怎么变，这个服务名都是稳定的。这是Docker生态中最标准、最灵活的连接方式。

方案二：给PostgreSQL容器配置固定IP #

如果需要从主机或者外部网络稳定访问，可以在compose文件中给db服务配置固定IP。修改后的docker-compose.yml如下：

version: '3.8'
services:
  db:
    image: postgres:14.1-alpine3.15
    ports:
      - '5432:5432'
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=1234
      - POSTGRES_DB=telegram_bot_db
    restart: always
    container_name: db
    volumes:
      - db:/var/lib/postgresql/data
    networks:
      my_network:
        ipv4_address: 172.20.0.5 # 选择一个和现有容器IP段兼容的固定IP
  pgadmin:
    image: dpage/pgadmin4:latest
    container_name: pgadmin
    restart: always
    depends_on:
      - db
    environment:
      PGADMIN_DEFAULT_EMAIL: some@nicemail.com
      PGADMIN_DEFAULT_PASSWORD: nice
      PGADMIN_LISTEN_PORT: 80
    ports:
      - '8080:80'
    volumes:
      - pgadmin:/var/lib/pgadmin
    networks:
      - my_network
  redis:
    image: redis
    container_name: redis
    restart: always
    ports:
      - '6379:6379'
    command: redis-server --save 20 1 --loglevel warning --requirepass qwe123qwe
    volumes:
      - redis:/data
    networks:
      - my_network
  redis_insight:
    image: redislabs/redisinsight:latest
    container_name: redis_insight
    restart: always
    depends_on:
      - redis
    ports:
      - '6380:8001'
    volumes:
      - redis_insight:/db
    networks:
      - my_network
volumes:
  db:
    driver: local
  redis:
    driver: local
  redis_insight:
    driver: local
  pgadmin:
    driver: local
networks:
  my_network:
    ipam:
      config:
        - subnet: 172.20.0.0/16 # 定义一个固定的子网段

这样db容器每次启动都会使用172.20.0.5这个固定IP，你可以直接用这个IP访问数据库。不过这种方式不如服务名灵活，除非必须从外部网络用IP访问，否则优先选择方案一。

备注：内容来源于stack exchange，提问作者Tim Korelov