Google Container Registry(gcr.io)镜像拉取与加速配置教程
教程简介
适用场景
1官方源拉取
使用仓库官方域名直接拉取镜像。
2轩辕专属域名拉取
使用轩辕镜像加速拉取 GCR(gcr.io) 需先开通专属域名。点击下方「显示专属域名」按钮获取对应前缀,再替换下方命令中的专属域名。 专属域名是什么?如何开启? →
格式 ***.xuanyuan.run
将 ***-gcr.xuanyuan.run 替换为你的 GCR 专属域名
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 不会自动走镜像加速:
Dockerfile 中写 FROM gcr.io/... 时同理——构建阶段仍会访问官方源。
正确做法:在命令或 Dockerfile 中显式使用轩辕专属域名
将官方域名替换为专属域名后再拉取或构建。点击上方「显示专属域名」按钮即可查看:
Dockerfile 示例:
将 ***-gcr.xuanyuan.run 替换为你的专属域名。点击上方「显示专属域名」按钮即可查看。了解更多 registry-mirrors 原理 →
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务