Docker Compose部署pgAdmin登录时出现ERR_EMPTY_RESPONSE问题求助

问题重现 #

在Digital Ocean Droplet上通过Docker Compose部署PostgreSQL和pgAdmin服务，docker-compose.yml配置如下：

version: "3.8"
services:
  db:
    image: postgres
    container_name: xyz-postgres-db
    restart: always
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: xyz
      POSTGRES_PASSWORD: password
  pgadmin:
    image: dpage/pgadmin4
    container_name: xyz-pgadmin
    restart: always
    ports:
      - "5433:80"
    environment:
      PGADMIN_DEFAULT_EMAIL: example@gmail.com
      PGADMIN_DEFAULT_PASSWORD: Example123

执行docker-compose up -d启动后，访问IP:5433能正常加载登录页，但输入账号密码点击登录后出现ERR_EMPTY_RESPONSE错误。已尝试更换端口、增强密码、切换pgAdmin镜像版本，问题仍存在，服务器同时配置了Nginx。

排查与解决步骤 #

1. 查看pgAdmin容器日志定位错误 #

先通过日志确认问题根源，执行命令：

docker logs xyz-pgadmin

常见触发错误的原因包括：/var/lib/pgadmin目录写入权限不足、pgAdmin会话加密密钥缺失、Nginx代理丢失关键请求头。

2. 解决容器权限与数据持久化问题 #

如果日志显示权限相关报错，给pgAdmin添加持久化卷，修改docker-compose.yml：

version: "3.8"
services:
  db:
    # 保持原有配置不变
    image: postgres
    container_name: xyz-postgres-db
    restart: always
    ports:
      - "5432:5432"
    environment:
      POSTGRES_USER: xyz
      POSTGRES_PASSWORD: password
  pgadmin:
    image: dpage/pgadmin4
    container_name: xyz-pgadmin
    restart: always
    ports:
      - "5433:80"
    environment:
      PGADMIN_DEFAULT_EMAIL: example@gmail.com
      PGADMIN_DEFAULT_PASSWORD: Example123
    volumes:
      - pgadmin-data:/var/lib/pgadmin  # 添加持久化卷
volumes:
  pgadmin-data:  # 声明全局卷

重新启动容器：

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

3. 修正Nginx反向代理配置（若使用Nginx代理pgAdmin） #

如果通过Nginx反向代理访问pgAdmin，必须配置完整的请求头传递，否则pgAdmin无法处理会话请求。示例Nginx配置：

server {
    listen 80;
    server_name your-droplet-ip;  # 替换为你的Droplet IP或域名

    location / {
        proxy_pass http://localhost:5433;
        # 必须添加的请求头
        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;
        # 调整超时避免请求中断
        proxy_connect_timeout 300s;
        proxy_send_timeout 300s;
        proxy_read_timeout 300s;
    }
}

重启Nginx生效：

sudo systemctl restart nginx

4. 添加pgAdmin会话加密密钥 #

如果日志提示密钥缺失，在pgAdmin的环境变量中添加随机生成的32位以上字符串作为密钥：

environment:
  PGADMIN_DEFAULT_EMAIL: example@gmail.com
  PGADMIN_DEFAULT_PASSWORD: Example123
  PGADMIN_CONFIG_SECRET_KEY: "your-random-32-character-key-here"  # 替换为随机字符串

重新启动容器即可。

5. 检查Digital Ocean安全组与服务器防火墙 #

确保Droplet安全组允许5433端口的双向通信，同时服务器本地防火墙（如ufw）开放对应端口：

sudo ufw allow 5433/tcp
sudo ufw reload

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