Docker环境下Nginx代理PgAdmin出现502 Bad Gateway问题咨询

你的502错误和访问失败问题，核心来自Nginx配置的两个关键问题：

1. 路径转发逻辑错误 #

当前location /pgadmin的proxy_pass配置会把请求转发到http://containerIP:port/pgadmin，但PgAdmin默认是在根路径(/)提供服务的，不存在/pgadmin这个子路径，导致后端无法处理请求，返回502错误。

2. 容器地址稳定性问题 #

直接使用容器IP而非容器名称/服务名，在容器重启后IP可能发生变化，导致Nginx无法正确连接到PgAdmin容器。

修正后的Nginx配置 #

server {
  listen 80;
  server_name domain;

  location /.well-known/acme-challenge/ {
      root /var/www/certbot;
  }

  location / {
      return 301 https://$host$request_uri;
  }
}

server {
      listen 443 ssl;
      server_name domain;
      
      # 保留你的SSL配置（ssl_certificate、ssl_certificate_key等）

      location /pgadmin/ {
         # 使用Docker网络内的容器名称代替IP，确保地址稳定
         proxy_pass http://pgadmin-container:5050/;
         # 添加必要的代理头，让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;
      }

      location / {
         proxy_pass http://your-main-app-container:port/;
         # 同样添加对应代理头
         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;
      }
}

正确的访问URL #

配置修正后，你需要访问：
https://domain/pgadmin/
（注意末尾的斜杠，否则会出现路径跳转异常）

额外说明：

• 把pgadmin-container替换为你实际的PgAdmin容器名称（可通过docker ps命令查看）
• 确认PgAdmin容器的端口默认是5050，如果你的容器映射了其他端口，替换为对应端口
• 确保所有容器都在同一个Docker自定义网络中（而非默认bridge网络），这样容器名称才能被正确解析

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