Google Container Registry(gcr.io)镜像拉取与加速配置教程

教程简介

Google Container Registry(gcr.io)镜像拉取教程:对比官方 docker pull 与轩辕专属加速域名写法,说明 google-containers 等命名空间规则,适合 GKE 与云原生组件在国内环境稳定拉取。

适用场景

适用于 GCR(gcr.io)(GCR、gcr.io、Google Container Registry、镜像加速)镜像拉取与加速配置场景。

1
官方源拉取

使用仓库官方域名直接拉取镜像。

docker pull gcr.io/google-containers/pause:3.9

2
轩辕专属域名拉取

使用轩辕镜像加速拉取 GCR(gcr.io) 需先开通专属域名。点击下方「显示专属域名」按钮获取对应前缀,再替换下方命令中的专属域名。 专属域名是什么?如何开启? →

格式 ***.xuanyuan.run

将 ***-gcr.xuanyuan.run 替换为你的 GCR 专属域名

docker pull ***-gcr.xuanyuan.run/google-containers/pause:3.9

3
常见问题:配置了 daemon.json 仍然很慢?

Q:为什么 daemon.json 已配置 ***-gcr.xuanyuan.run,拉取 gcr.io/google-containers/pause:3.9 依然很慢?

不少用户在 Windows、Linux 或 macOS 上执行 docker compose build、docker build 或 docker pull 时, 已在 daemon.json 的 registry-mirrors 中加入轩辕专属域名, 但构建日志仍显示从 gcr.io 拉取且耗时很长。

典型现象(构建日志仍走官方源):

#12 FROM gcr.io/google-containers/pause:3.9
#12 sha256:... 8.12MB / 12.40MB 420.8s

A:daemon.json 中的镜像加速仅对 docker.io 生效,gcr.io 需显式使用专属域名

registry-mirrors 只作用于 docker.io(Docker Hub 官方仓库)。对于 gcr.io 等非 Docker Hub 的 Registry,Docker 客户端不会查询 registry-mirrors,而是直接向官方域名发起请求。

例如执行以下命令时,Docker 不会自动走镜像加速:

docker pull gcr.io/google-containers/pause:3.9

Dockerfile 中写 FROM gcr.io/... 时同理——构建阶段仍会访问官方源。

正确做法:在命令或 Dockerfile 中显式使用轩辕专属域名

将官方域名替换为专属域名后再拉取或构建。点击上方「显示专属域名」按钮即可查看:

docker pull ***-gcr.xuanyuan.run/google-containers/pause:3.9

Dockerfile 示例:

FROM ***-gcr.xuanyuan.run/google-containers/pause:3.9

将 ***-gcr.xuanyuan.run 替换为你的专属域名。点击上方「显示专属域名」按钮即可查看。了解更多 registry-mirrors 原理 →

专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告