Kubernetes Registry(registry.k8s.io)镜像拉取与加速配置教程

教程简介

Kubernetes 官方 registry.k8s.io 拉取教程:以 kube-apiserver 等组件为例,对比官方源与轩辕 K8s 专属域名命令,适合集群升级与离线节点镜像预热场景。

适用场景

适用于 K8s(registry.k8s.io)(registry.k8s.io、Kubernetes Registry、K8s 镜像、镜像加速)镜像拉取与加速配置场景。

1
官方源拉取

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

docker pull registry.k8s.io/kube-apiserver:v1.30.1

2
轩辕专属域名拉取

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

格式 ***.xuanyuan.run

将 ***-k8s.xuanyuan.run 替换为你的 K8s 专属域名

docker pull ***-k8s.xuanyuan.run/kube-apiserver:v1.30.1

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 不会自动走镜像加速:

docker pull registry.k8s.io/kube-apiserver:v1.30.1

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

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

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

docker pull ***-k8s.xuanyuan.run/kube-apiserver:v1.30.1

Dockerfile 示例:

FROM ***-k8s.xuanyuan.run/kube-apiserver:v1.30.1

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

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