无法通过Docker使用PGAdmin连接Django PostgreSQL数据库

尝试用PGAdmin4可视化浏览Django应用的数据库数据，但无法连接数据库。已尝试使用localhost和通过docker inspect <container name>获取的Docker容器IP（如172.18.0.2），均连接失败。

配置信息 #

settings.py 数据库配置 #

DATABASES = {
    "default": env.dj_db_url("DATABASE_URL",
    default="postgres://postgres@db/postgres")
}

docker-compose.yml 配置 #

version: "3.9"
services:
  web:
    build: .
    ports:
      - "8000:8000"
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - .:/my_backend
    depends_on:
      - db
    environment:
      - "DJANGO_SECRET_KEY=xyz"
      - "DJANGO_DEBUG=True"
  db:
    image: postgres:15
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    environment:
      - "POSTGRES_HOST_AUTH_METHOD=trust"

volumes:
  postgres_data:

已尝试操作 #

• 删除所有镜像、卷、容器，通过docker-compose up -d --build重启
• 重新执行Django的migrate命令
• 将Brew安装的psql添加到zsh环境路径
• 使用localhost和172.18.0.2作为主机名，维护数据库设为postgres，用户名postgres，密码为空，尝试连接PGAdmin均失败

1. 给Postgres容器暴露端口 #

当前docker-compose.yml中db服务未将Postgres默认端口5432映射到宿主机，导致localhost无法访问数据库。修改db服务配置，添加端口映射：

db:
  image: postgres:15
  ports:
    - "5432:5432"  # 新增端口映射
  volumes:
    - postgres_data:/var/lib/postgresql/data/
  environment:
    - "POSTGRES_HOST_AUTH_METHOD=trust"

修改后重启容器：

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

2. 配置PGAdmin连接参数 #

端口映射完成后，在PGAdmin中新建数据库连接时填写以下参数：

• 主机名/地址：localhost
• 端口：5432
• 维护数据库：postgres
• 用户名：postgres
• 密码：留空（因配置了POSTGRES_HOST_AUTH_METHOD=trust，无需密码验证）

3. 容器IP连接失败的原因 #

若PGAdmin安装在宿主机而非Docker容器内，直接使用容器IP连接可能受限于Docker网络与宿主机的互通规则（如防火墙、子网隔离），优先采用端口映射+localhost的方式更稳定。

4. 提前验证数据库连通性 #

可先用宿主机的psql命令测试连接是否正常：

psql -h localhost -U postgres -d postgres

若能成功进入Postgres命令行，说明数据库服务正常，此时再用PGAdmin连接即可。

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