Kubernetes:如何解决 k8s.gcr.io 拉取镜像失败问题
问题背景 由于网络限制,k8s.gcr.io 和 registry.k8s.io 在国内无法直接访问。在部署 Kubernetes 组件或安装 CSI、CNI 等插件时,经常会遇到: Error response from daemon: manifest for k8s.gcr.io/xxx not found: manifest unknown # 或 Failed to pull image "registry.k8s.io/sig-storage/nfs-subdir-external-provisioner:v4.0.2" 方案一:域名替换(最简单,手动拉取时用) 将 k8s.gcr.io 或 registry.k8s.io 替换为国内可用的镜像站: 原始地址 替换为 k8s.gcr.io/xxx registry.lank8s.cn/xxx registry.k8s.io/xxx registry.lank8s.cn/xxx k8s.gcr.io/xxx m.daocloud.io/xxx registry.k8s.io/xxx m.daocloud.io/xxx 示例:NFS Subdir External Provisioner # 原始命令(会失败) docker pull registry.k8s.io/sig-storage/nfs-subdir-external-provisioner:v4.0.2 # 替换为 lank8s.cn 镜像 docker pull registry.lank8s.cn/sig-storage/nfs-subdir-external-provisioner:v4.0.2 # 或使用 DaoCloud 镜像 docker pull m.daocloud.io/sig-storage/nfs-subdir-external-provisioner:v4.0.2 # 拉取后重新打标签 docker tag registry.lank8s.cn/sig-storage/nfs-subdir-external-provisioner:v4.0.2 \ registry.k8s.io/sig-storage/nfs-subdir-external-provisioner:v4.0.2 常用镜像站对比 镜像站 同步速度 稳定性 备注 registry.lank8s.cn ⚡ 快 ✅ 稳定 个人维护,长期可用 m.daocloud.io ⚡ 快 ✅ 稳定 DaoCloud 官方维护 gcr.mirrors.ustc.edu.cn 🐢 较慢 ⚠️ 有时断 中科大源 registry.aliyuncs.com/google_containers ⚡ 快 ✅ 稳定 阿里云,需拼接路径 方案二:配置 Docker / containerd 镜像加速(推荐,一劳永逸) Docker Engine 配置 编辑 /etc/docker/daemon.json: ...