嘿，我之前也踩过这个一模一样的坑，按官方文档配完还是报connection refused，折腾了大半天终于搞定了，给你分享几个关键的排查点：

• 先确认Registry服务本身是否在运行
  别着急看Nginx，先检查GitLab的Registry组件有没有正常启动。执行gitlab-ctl status registry，如果显示down，那先解决服务启动问题——常见原因是配置格式错误、端口被占用，或者依赖服务没起来。

• 核对gitlab.rb的核心配置
  确保这几个关键配置没有写错，尤其是细节：

  # 开启Registry功能
  gitlab_rails['registry_enabled'] = true
  # 外部访问的完整地址，要和Nginx配置的域名/端口完全匹配
  registry_external_url 'https://registry.your-domain.com'
  # Registry服务的监听端口，默认5000，要和Nginx转发的端口对应
  gitlab_rails['registry_port'] = 5000
  # 如果是跨机器访问或容器部署，必须让Registry监听所有网卡，不然只能本地访问
  registry['listen_address'] = '0.0.0.0:5000'
  

  改完配置一定要执行gitlab-ctl reconfigure，这个命令会自动生成所有必要的配置文件，千万别直接手动修改GitLab自动生成的文件！

• 检查Nginx反向代理配置
  如果你用的是自己搭建的Nginx（不是GitLab自带的），要确保转发规则完全正确：

  server {
    listen 443 ssl;
    server_name registry.your-domain.com;
  
    # 替换成你的SSL证书路径
    ssl_certificate /etc/nginx/ssl/registry.crt;
    ssl_certificate_key /etc/nginx/ssl/registry.key;
  
    location / {
      # 这里的端口必须和gitlab.rb里的registry_port完全一致
      proxy_pass http://localhost:5000;
      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;
    }
  }
  

  配置完用nginx -t检查语法是否正确，没问题再重启Nginx。如果用的是GitLab自带的Nginx，只要registry_external_url配置正确，执行reconfigure后会自动生成对应的Nginx规则，不用手动修改。

• 排查端口占用与本地可达性
  用netstat -tulpn | grep 5000（换成你配置的端口）看看这个端口是不是被其他服务占用了。如果是，要么更换Registry的端口，要么停掉占用的服务。另外，在Nginx所在机器上执行curl http://localhost:5000/v2/，如果这个请求都失败，那问题肯定出在Registry服务本身，和Nginx无关。

• Docker部署GitLab的特殊注意事项
  如果你是用Docker容器运行GitLab，别忘了把Registry的端口映射到宿主机：

  docker run -d \
    --name gitlab \
    -p 80:80 -p 443:443 -p 22:22 \
    -p 5000:5000 \ # 必须添加这个端口映射
    -v /srv/gitlab/config:/etc/gitlab \
    -v /srv/gitlab/logs:/var/log/gitlab \
    -v /srv/gitlab/data:/var/opt/gitlab \
    gitlab/gitlab-ce:latest
  

  同时gitlab.rb里的registry_external_url要对应宿主机的公网地址或域名，比如https://your-public-ip:5000。

最后，当你测试curl https://registry.your-domain.com/v2/返回{"errors":[{"code":"UNAUTHORIZED","message":"authentication required","detail":null}]}的时候，就说明连接已经正常了，只是需要用GitLab账号登录验证即可。

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