Gitlab CE迁移后Container Registry镜像标签缺失、docker登录失败求助

1 优先完成配置一致性校验 #

• 首先检查/etc/gitlab/gitlab.rb中所有Registry相关配置，确保参数和实际部署方案匹配：
  • 若使用HTTP暴露Registry，确认registry_external_url前缀为http而非https，示例：registry_external_url 'http://gitlab.example.com:5005'
  • 确认gitlab_rails['registry_api_url']配置的是Registry内部可访问地址，不要填写外部公网地址，避免回环访问异常
  • 配置修改完成后执行gitlab-ctl reconfigure生效，再执行gitlab-ctl restart registry重启Registry服务

2 解决docker login报错问题 #

报错Error response from daemon: Get "https://gitlab.example.com:5005/v2/": http: server gave HTTP response to HTTPS client根因为Docker客户端默认强制对所有容器注册表走HTTPS验证，你当前使用HTTP暴露Registry，需要把对应地址加入客户端的不安全注册表列表

• 修改Linux环境Docker客户端配置文件/etc/docker/daemon.json，文件不存在可直接新建，添加如下配置：

{
  "insecure-registries": ["gitlab.example.com:5005"]
}

• 执行systemctl daemon-reload && systemctl restart docker重启Docker服务生效
• 重新执行docker login http://gitlab.example.com:5005验证登录即可

3 解决无法查看镜像标签问题 #

该问题通常为Gitlab服务与Registry之间通信配置不匹配导致，完成第一步配置校验后按如下步骤排查：

• 确认备份迁移过程中没有修改/var/opt/gitlab/gitlab-rails/etc/gitlab-secrets.json文件中的Registry相关密钥，密钥不匹配会导致Gitlab无法拉取镜像元数据
• 检查Gitlab服务到Registry内部地址的连通性，在Gitlab服务器上执行curl <你配置的registry_api_url>/v2/，确认能正常返回结果，无401/404/503等错误码
• 确认原Registry存储数据已完整复制到新服务器对应目录，默认存储路径为/var/opt/gitlab/gitlab-rails/shared/registry，如果文件权限异常可执行chown -R registry:registry /var/opt/gitlab/gitlab-rails/shared/registry修正

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