Docker化GitLab 17 Omnibus配置外部Nginx容器仓库遇502错误求助

1. 修正Registry监听地址与容器端口映射 #

你的GitLab配置中registry['registry_http_addr'] = "127.0.0.1:5000"绑定了容器内部回环地址，宿主机的Nginx无法访问这个端口：

• 修改GitLab配置：将registry['registry_http_addr']改为"0.0.0.0:5000"，让Registry监听容器所有网卡
• 在compose.yml的GitLab服务中添加端口映射：

  ports:
    - "5000:5000"
  

• 重启GitLab容器，确保端口正常暴露

2. 验证宿主机到Registry的连通性 #

在宿主机执行以下命令，确认能访问容器内的Registry：

curl http://127.0.0.1:5000/v2/

• 正常返回401 Unauthorized说明连通性没问题（需要登录验证）
• 如果返回Connection refused或超时，说明端口映射/监听地址配置错误，回到第一步排查

3. 检查Registry服务状态 #

进入GitLab容器，确认Registry服务正常启动：

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

• 如果状态不是run，查看Registry日志定位启动失败原因：

  docker exec -it <gitlab-container-name> gitlab-ctl tail registry
  

4. 修正Nginx的proxy_pass配置 #

你的Nginx配置中location /的proxy_pass http://gitlab-registry$request_uri写法错误，会导致路径重复拼接，引发后端请求异常：

• 将该位置的proxy_pass改为：

  proxy_pass http://gitlab-registry/;
  

• 重启Nginx服务生效：systemctl restart nginx

5. 统一Registry外部地址配置 #

GitLab配置中registry_external_url与gitlab_rails['registry_host']不一致，会导致GitLab生成的Registry地址混乱：

• 将两者统一为registry.domain.tld，修改后的配置片段：

  registry_external_url 'https://registry.domain.tld'
  gitlab_rails['registry_host'] = 'registry.domain.tld'
  

• 重启GitLab容器生效

6. 查看Nginx错误日志 #

检查Nginx的错误日志，获取具体的502原因：

tail -f /var/log/nginx/registry.domain.tld/error.log

日志中通常会明确提示是连接超时、拒绝还是后端返回异常，针对性排查

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