K8s.gcr.io 镜像已迁移？国内免费镜像加速服务与使用指南

k8s.gcr.io 是由 Google Container Registry (GCR) 托管的 Kubernetes 官方容器镜像仓库，曾长期用于存储 kube-apiserver、etcd 等核心组件镜像。

不过，自 2023 年 4 月 3 日起，这个仓库已被官方冻结。这意味着 Kubernetes 及其子项目的新版本镜像（如 v1.25 之后）不再推送到此处。官方已全面转向新域名 registry.k8s.io。新域名采用了多云分发模式（覆盖 Google Cloud、AWS 等），旨在通过分散流量来降低成本，并提升全球用户的下载速度。

对于国内开发者而言，直接从 k8s.gcr.io 或其新地址拉取镜像时常面临网络不畅或速度缓慢的问题。为此，一些国内镜像加速服务应运而生，持续同步这些官方镜像，并提供免费、不限速的下载通道。近期，某服务完成了第 7 批同步，涵盖了相关 89 个镜像仓库的主流版本 Tag，并提供多架构支持。

如何使用镜像加速服务

这类镜像加速仓库通常汇聚了来自 docker.io、gcr.io、ghcr.io、quay.io、registry.k8s.io、docker.elastic.co、mcr.microsoft.com、nvcr.io 以及 k8s.gcr.io 等主流镜像托管平台的容器镜像。它们通过自动同步与合规审核，为国内用户提供高速下载服务。

目前，常见的提供两种下载模式：普通下载 和 超高速下载。

• 普通下载：直接使用服务提供的镜像地址进行拉取。
• 超高速下载：可以并行从该服务维护的多个上游仓库下载同一个容器镜像的不同层，从而显著提升下载速度。

普通下载模式

普通下载不需要复杂配置。通常，你只需在服务提供的镜像仓库搜索页面（例如 https://example.com/app/image）找到目标镜像，点击进入详情页获取镜像的 拉取地址，然后直接使用 docker pull 命令即可。

例如，拉取 Nginx 镜像的命令格式如下：

docker pull registry.example.com/docker.io/library/nginx:1.29.3

超高速下载模式

超高速下载模式能极大提升拉取效率。配置主要包含以下几个步骤：

1. 创建自签证书
2. 复制并创建 Nginx 反向代理配置
3. 运行 Nginx 服务
4. 将 Nginx 服务地址配置为 Docker 的非安全仓库 (insecure-registry)
5. 验证镜像拉取

具体的详细配置步骤，请参考服务商提供的官方文档（例如 https://example.com/p/assets/docs/image/）。如果你想了解更多关于容器技术和云原生的实践，可以到 云栈社区 与广大开发者交流探讨。

第7批同步的镜像仓库列表

以下为本次同步所涵盖的 k8s.gcr.io 下的部分镜像仓库，各镜像的详细 Tags 列表请参考各仓库页面地址：

https://example.com/i/k8s.gcr.io/pause
https://example.com/i/k8s.gcr.io/sig-storage/nfs-subdir-external-provisioner
https://example.com/i/k8s.gcr.io/kube-state-metrics/kube-state-metrics
https://example.com/i/k8s.gcr.io/prometheus-adapter/prometheus-adapter
https://example.com/i/k8s.gcr.io/ingress-nginx/controller
https://example.com/i/k8s.gcr.io/sig-storage/csi-node-driver-registrar
https://example.com/i/k8s.gcr.io/kubernetes-dashboard-amd64
https://example.com/i/k8s.gcr.io/hpa-example
https://example.com/i/k8s.gcr.io/sig-storage/csi-attacher
https://example.com/i/k8s.gcr.io/sig-storage/csi-provisioner
https://example.com/i/k8s.gcr.io/metrics-server/metrics-server
https://example.com/i/k8s.gcr.io/ingress-nginx/kube-webhook-certgen
https://example.com/i/k8s.gcr.io/sig-storage/csi-resizer
https://example.com/i/k8s.gcr.io/sig-storage/csi-snapshotter
https://example.com/i/k8s.gcr.io/coredns/coredns
https://example.com/i/k8s.gcr.io/kube-proxy
https://example.com/i/k8s.gcr.io/etcd
https://example.com/i/k8s.gcr.io/kube-controller-manager
https://example.com/i/k8s.gcr.io/kube-scheduler
https://example.com/i/k8s.gcr.io/descheduler/descheduler
https://example.com/i/k8s.gcr.io/kube-apiserver
https://example.com/i/k8s.gcr.io/sig-storage/livenessprobe
https://example.com/i/k8s.gcr.io/coredns
https://example.com/i/k8s.gcr.io/cuda-vector-add
https://example.com/i/k8s.gcr.io/build-image/kube-cross
https://example.com/i/k8s.gcr.io/echoserver
https://example.com/i/k8s.gcr.io/cluster-proportional-autoscaler-amd64
https://example.com/i/k8s.gcr.io/build-image/debian-iptables
https://example.com/i/k8s.gcr.io/dns/k8s-dns-node-cache

这些镜像涵盖了 Kubernetes 核心组件、常用插件（如 Dashboard, Ingress-Nginx, CSI 驱动）以及监控组件（如 Metrics Server），对于构建和维护 云原生 环境至关重要。利用国内镜像服务，可以确保这些基础镜像的稳定、快速获取，为开发部署流程提速。