通过GitLab Dependency Proxy拉取镜像出现404错误如何解决？

第一步：验证拉取路径格式正确性 #

你当前使用的拉取地址额外携带了443端口，Docker访问HTTPS服务时默认使用443端口，无需显式声明，显式添加端口会导致GitLab路由匹配失败，是此报错的高频诱因。
请尝试使用修正后的拉取命令：

docker pull my.gitlab.com/groups/mygroup/dependency_proxy/containers/busybox:latest

如果修改后仍报错，继续执行以下排查步骤。 #

第二步：确认Dependency Proxy功能已开启 #

• 登录GitLab后台，进入目标组mygroup的设置页，定位到Packages and registries > Dependency Proxy选项
• 确认功能开关已启用，同时核对页面给出的镜像拉取前缀与你使用的前缀完全一致
• 可直接在浏览器访问https://my.gitlab.com/groups/mygroup/-/dependency_proxy，正常打开即说明功能与组路径配置无误

第三步：检查GitLab全局配置 #

如果你使用Docker部署GitLab，需要确认gitlab.rb配置文件中以下参数配置正确：

# 启用依赖代理功能
gitlab_rails['dependency_proxy_enabled'] = true
# 依赖代理对外访问地址与你的GitLab域名完全匹配
gitlab_rails['dependency_proxy_external_url'] = 'https://my.gitlab.com'
# 确保HTTPS配置正确
nginx['listen_https'] = true
nginx['redirect_http_to_https'] = true

修改配置后重启GitLab容器生效：
docker restart <你的GitLab容器名称> #

第四步：校验访问权限 #

• 确认你执行docker login my.gitlab.com时使用的账号，对mygroup至少拥有Reporter及以上权限
• 若组为私有级别，不要开启「允许匿名访问依赖代理」配置，避免权限校验冲突

第五步：日志定位具体错误 #

若以上步骤都未解决问题，可通过GitLab日志确认404的具体原因：

1. 查看Nginx访问日志，确认拉取请求是否正常到达GitLab，路径是否被截断：
   docker exec -it <你的GitLab容器名称> tail -f /var/log/gitlab/nginx/gitlab_access.log
2. 查看Rails业务日志，确认是否为权限拦截或内部逻辑报错：
   docker exec -it <你的GitLab容器名称> tail -f /var/log/gitlab/gitlab-rails/production.log
   执行拉取镜像操作时同步观察日志输出即可定位根因。

内容的提问来源于stack exchange，提问作者Mohammad Reza Mousavi