Kubernetes Registry(registry.k8s.io)镜像拉取与加速配置教程
教程简介
适用场景
1官方源拉取
使用仓库官方域名直接拉取镜像。
2轩辕专属域名拉取
使用轩辕镜像加速拉取 K8s(registry.k8s.io) 需先开通专属域名。点击下方「显示专属域名」按钮获取对应前缀,再替换下方命令中的专属域名。 专属域名是什么?如何开启? →
格式 ***.xuanyuan.run
将 ***-k8s.xuanyuan.run 替换为你的 K8s 专属域名
3常见问题:配置了 daemon.json 仍然很慢?
Q:为什么 daemon.json 已配置 ***-k8s.xuanyuan.run,拉取 registry.k8s.io/kube-apiserver:v1.30.1 依然很慢?
不少用户在 Windows、Linux 或 macOS 上执行 docker compose build、docker build 或 docker pull 时, 已在 daemon.json 的 registry-mirrors 中加入轩辕专属域名, 但构建日志仍显示从 registry.k8s.io 拉取且耗时很长。
典型现象(构建日志仍走官方源):
#6 FROM registry.k8s.io/kube-apiserver:v1.30.1 #6 sha256:... 22.1MB / 35.6MB 388.2s
A:daemon.json 中的镜像加速仅对 docker.io 生效,registry.k8s.io 需显式使用专属域名
registry-mirrors 只作用于 docker.io(Docker Hub 官方仓库)。对于 registry.k8s.io 等非 Docker Hub 的 Registry,Docker 客户端不会查询 registry-mirrors,而是直接向官方域名发起请求。
例如执行以下命令时,Docker 不会自动走镜像加速:
Dockerfile 中写 FROM registry.k8s.io/... 时同理——构建阶段仍会访问官方源。
正确做法:在命令或 Dockerfile 中显式使用轩辕专属域名
将官方域名替换为专属域名后再拉取或构建。点击上方「显示专属域名」按钮即可查看:
Dockerfile 示例:
将 ***-k8s.xuanyuan.run 替换为你的专属域名。点击上方「显示专属域名」按钮即可查看。了解更多 registry-mirrors 原理 →
用户好评
来自真实用户的反馈,见证轩辕镜像的优质服务