无法访问GitLab上的Docker私有仓库，点击Registry标签报500错误

Hey Tom，看了你的日志和描述，问题根源其实非常明确——GitLab容器找不到指定路径下的registry.key文件，这就是点击Registry标签直接返回500错误的核心原因。别着急，我一步步帮你解决这个卡了一个月的问题：

从你贴的production.log里，最关键的错误行已经把问题点得明明白白：

Errno::ENOENT (No such file or directory @ rb_sysopen - /certs/registry.key):

这说明GitLab在生成容器Registry认证令牌时，尝试读取/certs/registry.key这个私钥文件，但容器里根本找不到它，直接触发了服务器内部错误。

因为你是用Docker容器部署GitLab和私有Registry，我们重点解决文件挂载路径匹配和GitLab配置正确性这两个核心点：

1. 确认私有Registry的证书/密钥位置 #

首先，你的私有Registry容器肯定有证书存储目录（比如宿主机上的/opt/registry/certs），里面必须包含两个关键文件：

• registry.crt：Registry的证书文件（自签名或CA签发均可）
• registry.key：Registry的私钥文件

如果还没生成自签名证书，直接在宿主机上执行这条命令生成：

mkdir -p /opt/registry/certs
openssl req -newkey rsa:4096 -nodes -sha256 -keyout /opt/registry/certs/registry.key -x509 -days 365 -out /opt/registry/certs/registry.crt

2. 让GitLab容器能访问到这些文件 #

你需要把宿主机上的Registry证书目录挂载到GitLab容器里，而且挂载路径要和后续GitLab配置里的路径完全一致。比如你想让GitLab容器内的路径是/certs，启动GitLab容器时要加上这个挂载参数：

-v /opt/registry/certs:/certs:ro

（:ro表示只读挂载，更安全，避免GitLab误修改证书文件）

如果是用Docker Compose部署，就在GitLab的服务配置里加：

volumes:
  - /opt/registry/certs:/certs:ro

3. 修正GitLab的Registry配置（不用改gitlab.yml） #

Docker部署的GitLab推荐用gitlab.rb配置文件，别直接碰gitlab.yml。先进入GitLab容器：

docker exec -it <你的GitLab容器名称> /bin/bash

然后编辑/etc/gitlab/gitlab.rb，找到容器Registry相关配置，确保以下几项正确：

# 启用容器Registry集成
gitlab_rails['registry_enabled'] = true

# 填写你的私有Registry的外部访问地址
gitlab_rails['registry_host'] = '你的Registry域名或IP:端口'
gitlab_rails['registry_port'] = 5000 # 改成你实际用的端口

# 关键：指定证书和私钥的路径，必须和挂载的路径一致！
gitlab_rails['registry_key_path'] = "/certs/registry.key"
gitlab_rails['registry_certificate_path'] = "/certs/registry.crt"

# 填写Registry的内部API地址（如果和GitLab在同一Docker网络，可用容器名）
gitlab_rails['registry_api_url'] = 'http://registry:5000'

4. 让配置生效并重启GitLab #

修改完配置后，执行以下命令让GitLab加载新配置并重启服务：

gitlab-ctl reconfigure
gitlab-ctl restart

5. 最后验证文件是否存在 #

重启后再进入GitLab容器，检查/certs/registry.key是否真的存在：

ls -l /certs/registry.key

如果能看到文件信息，那问题就解决了，回到GitLab页面点击Registry标签试试吧！

• 别忘了重启你的私有Registry容器，确保它也在使用正确的证书和私钥
• 如果用的是CA签发的证书，registry.crt应该是CA的根证书，不是Registry的证书，这样GitLab才能信任Registry的证书

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