Docker容器中配置Postgres、pgAdmin与Nginx遇问题求助

我注意到你当前的docker-compose.yml存在几个关键问题，比如过时的links用法、缺失的数据持久化配置、不完整的Nginx配置，还有没有用自定义网络优化服务间通信。下面是修正后的完整配置，以及详细的改进说明：

修正后的完整Docker Compose配置 #

version: '3.8'
services:
  postgres:
    image: postgres:latest
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: postgres
    volumes:
      - postgres_data:/var/lib/postgresql/data/  # 持久化Postgres数据，避免容器重启丢失
    networks:
      - app-network
    restart: unless-stopped

  pgadmin:
    image: dpage/pgadmin4:latest
    environment:
      PGADMIN_DEFAULT_EMAIL: 'postgres@pg.com'
      PGADMIN_DEFAULT_PASSWORD: 'postgres'
    volumes:
      - pgadmin_data:/var/lib/pgadmin/  # 持久化pgAdmin的配置和会话数据
    networks:
      - app-network
    ports:
      - "5050:80"
    restart: unless-stopped
    depends_on:
      - postgres  # 确保Postgres先启动，避免pgadmin启动时连不上数据库

  nginx:
    image: nginx:alpine
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf  # 挂载自定义的Nginx反向代理配置
    networks:
      - app-network
    ports:
      - "80:80"
    restart: unless-stopped
    depends_on:
      - pgadmin

volumes:
  postgres_data:
  pgadmin_data:

networks:
  app-network:
    driver: bridge

配套的Nginx反向代理配置（nginx.conf） #

把这个文件放在和docker-compose.yml同一目录下：

events {
    worker_connections 1024;
}

http {
    server {
        listen 80;

        location / {
            proxy_pass http://pgadmin:80;
            # 传递必要的请求头，确保pgAdmin能正确处理请求
            proxy_set_header Host $host;
            proxy_set_header X-Real-IP $remote_addr;
            proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
            proxy_set_header X-Forwarded-Proto $scheme;
        }
    }
}

关键改进点说明 #

• 替换links为自定义网络：Docker Compose v3里links已经是过时用法，自定义app-network能让服务直接通过服务名（比如postgres、pgadmin）相互访问，更符合现代Docker最佳实践，也更稳定。
• 添加数据持久化卷：给Postgres和pgAdmin都配置了专用卷，避免容器删除或重启后数据、配置全部丢失。
• 完善Nginx配置：补充了反向代理到pgAdmin的完整规则，同时用轻量的nginx:alpine镜像减小容器体积。
• 增加depends_on：确保服务按依赖顺序启动（Postgres→pgAdmin→Nginx），虽然不保证服务完全就绪，但能避免启动顺序导致的初期连接失败。
• 更新镜像版本：把pgAdmin的镜像从老旧的3.0版本换成latest（也可以指定具体稳定版本号），避免版本兼容性问题。

常见问题排查 #

如果配置后还是有问题，可以从这几点入手：

• 检查Nginx配置文件的路径是否正确，确保容器能读取到nginx.conf；
• 用docker-compose ps查看所有服务的运行状态，确认没有异常退出的容器；
• 查看容器日志定位具体问题：比如docker-compose logs postgres或docker-compose logs pgadmin；
• 在pgAdmin里连接Postgres时，主机名填postgres（服务名），端口用默认的5432，用户名密码对应你设置的POSTGRES_USER和POSTGRES_PASSWORD。

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