自托管Docker GitLab（Nginx反向代理）容器仓库镜像不显示，如何登录？

核心操作步骤 #

1. 网页端完成身份验证 #

• 若账号开启双因素认证（2FA），必须用个人访问令牌（PAT）代替密码：
  • 进入GitLab个人设置 → 访问令牌
  • 勾选read_registry权限（如需推送镜像可额外勾选write_registry），设置有效期后生成令牌，务必保存好（令牌仅显示一次）
  • 在容器仓库页面的登录提示框中，输入GitLab用户名和生成的PAT完成登录
• 未开启2FA的用户，直接使用GitLab账号密码登录即可

2. 同步Docker客户端登录状态 #

执行Docker登录命令关联你的自托管容器仓库：

docker login <你的GitLab容器仓库地址>

注：容器仓库地址通常为registry.你的GitLab实例域名或直接使用实例域名，具体以GitLab配置为准；登录时同样遵循2FA用PAT、无2FA用账号密码的规则

3. 权限与配置排查 #

• 确认当前用户对目标项目拥有容器仓库查看权限：进入项目「设置→成员」，检查角色至少为开发者（Developer）及以上，或被单独授予read_registry权限
• 验证容器仓库服务状态：在GitLab服务器上执行gitlab-ctl status registry，确保服务正常运行；同时检查gitlab.rb配置文件中的registry_external_url是否正确指向容器仓库地址

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