Docker拉取GCP Container Registry镜像报405 v1 API禁用错误
核心问题根因
你的操作链路、身份认证、网络连通性都不存在问题,触发405报错的核心原因是当前安装的Docker 1.9.1版本过于老旧,默认优先使用v1 Registry API发起拉取请求:
- Docker Hub目前仍保留对老版本Docker的v1接口兼容,所以你拉取公共python镜像的操作可以正常完成
- GCP Container Registry早已彻底下线v1接口的所有支持,因此老版本Docker向GCR发起的v1请求会直接被拒绝,返回405错误
该报错和凭证配置无关,你已经执行的gcloud auth configure-docker操作是完全正确的,在其他机器可以正常运行也侧面印证了凭证、账号权限没有问题。
快速排查验证
- 验证网络连通性:执行
curl -I https://eu.gcr.io/v2/,如果返回401未授权状态码,说明本地到GCR的网络链路完全通畅,不存在访问阻断 - 版本兼容性核对:GCR要求客户端最低支持v2 Registry API,对应Docker版本需在1.10.0以上,你当前的1.9.1版本原生默认开启legacy v1 registry支持,会优先向v1接口发请求,完全不符合GCR的接口要求
对应解决方案
临时适配(不调整现有Docker版本)
按照报错提示的指引,强制Docker守护进程禁用旧版v1 registry支持,强制走v2协议发起请求:
- 停止当前运行的dockerd服务进程
- 携带禁用参数重启dockerd:
sudo dockerd --disable-legacy-registry & - 重启完成后重新执行docker pull命令测试拉取
注意:该配置仅当前运行周期生效,后续dockerd重启需要重新携带参数;且因为Docker 1.9.1本身版本过老,后续可能遇到镜像存储格式不兼容、层校验失败等衍生问题
推荐方案(升级Docker版本)
将老旧的Docker 1.9.1替换为兼容GCR v2接口的适配版本:
- 先卸载当前旧版Docker:
sudo apt-get remove docker docker-engine docker.io - 安装适配老版本Ubuntu 14.04的Docker 18.09版本,该版本对旧系统兼容性好,原生支持GCR v2 API拉取
- 安装完成后重新执行
gcloud auth configure-docker同步凭证配置,即可正常拉取镜像
应急绕方案
如果暂时无法修改Docker服务配置,可直接通过gcloud命令把镜像拉取到本地后导入Docker,完全绕开Docker客户端的接口兼容问题:
- 下载目标镜像为本地tar包:
gcloud artifacts docker images export eu.gcr.io/gcp-project-1/my_docker_image:latest --destination=./my_image.tar - 导入tar包到本地Docker:
docker load -i ./my_image.tar
内容的提问来源于stack exchange,提问作者DUDANF
相关产品推荐
相关产品推荐

