Nginx反向代理下GitLab Docker容器502错误排查求助

背景 #

已通过Linode完成域名及子域名配置，Nginx反向代理可正常将流量转发至各Docker容器（例如cloud.domainname.com可访问8080端口的Nextcloud实例）。为GitLab配置反向代理时，因81、443、22端口被占用，将GitLab容器端口映射为82:80、444:443、23:22，但访问gitlab.domainname.com时持续出现502 Bad Gateway错误，调整GitLab主机名及环境变量后问题仍未解决。

GitLab Docker Compose配置片段 #

hostname: 'gitlab.example.com'
environment:
  GITLAB_OMNIBUS_CONFIG: |
    external_url 'https://gitlab.example.com'
    # Add any other gitlab.rb configuration here, each on its own line
ports:
  - 82:80
  - 444:443
  - 23:22

已完成的排查步骤 #

• 检查Docker容器日志，未发现明确错误信息
• 验证Nginx反向代理配置（其他服务使用相同配置逻辑可正常运行）
• 确认防火墙未拦截82端口
• 反复核对GitLab容器配置，包括external_url的正确性
• 确认DNS设置将gitlab.domainname.com指向正确服务器IP
• 验证SSL/TLS证书配置（其他服务使用同一证书可正常工作）
• 修改配置后重启GitLab容器与Nginx服务

可能的原因及解决建议 #

1. GitLab内部服务未完全启动
   GitLab启动依赖多个组件（nginx、redis、postgresql等），容器状态显示running不代表内部服务就绪。执行以下命令检查内部服务状态：

docker exec -it <gitlab-container-name> gitlab-ctl status

确保所有服务处于run状态后再测试访问，首次启动需等待5-10分钟初始化。

2. Nginx反向代理目标端口或网络配置错误

• 若Nginx运行在宿主机，确认配置中代理目标为宿主机82端口，且包含必要的代理头：

  server {
      server_name gitlab.domainname.com;
      location / {
          proxy_pass http://localhost:82;
          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;
      }
      # SSL配置部分
      listen 443 ssl;
      ssl_certificate /path/to/cert.pem;
      ssl_certificate_key /path/to/key.pem;
  }
  

• 若Nginx与GitLab均在Docker容器中，建议将两者加入同一自定义Docker网络，Nginx直接通过容器名访问GitLab的80端口，无需映射宿主机端口，避免网络转发问题。

3. GitLab未正确识别反向代理请求
   在GitLab的GITLAB_OMNIBUS_CONFIG中添加代理信任配置，确保GitLab接受Nginx的代理请求：

environment:
  GITLAB_OMNIBUS_CONFIG: |
    external_url 'https://gitlab.domainname.com'
    nginx['listen_port'] = 80
    nginx['listen_https'] = false
    gitlab_rails['trusted_proxies'] = ['<Nginx服务器IP或容器IP>']

关闭GitLab内部nginx的HTTPS（由外部Nginx处理SSL），并将Nginx地址加入信任列表，避免请求被拦截。

4. 服务器资源不足
   GitLab默认需要至少4GB内存，若服务器内存不足，内部服务可能无法正常启动。执行free -h查看内存使用情况，必要时增加服务器内存，或在docker-compose中添加资源限制：

deploy:
  resources:
    limits:
      memory: 4G
    reservations:
      memory: 2G

5. 端口占用验证
   确认宿主机82端口确实被GitLab容器占用：

sudo lsof -i :82

若输出非GitLab进程，需排查端口冲突并调整映射端口。

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