You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Kind Kubernetes集群拉取Docker镜像失败问题求助

解决Kind集群镜像拉取失败(ImagePullBackOff/ErrImagePull)的问题

我来帮你搞定这个Kind集群拉镜像失败的问题!你猜的没错,这确实是国内网络访问Docker Hub受限导致的。不过要注意,Kind默认用的是containerd作为容器运行时,不是Docker,所以你进入Kind节点后找不到docker命令是正常的——所有镜像拉取都是containerd在处理,咱们得从配置containerd的镜像镜像(mirror)入手。

下面给你两种实用的解决方案:

方案一:创建集群时预先配置镜像源

这种方法最省心,适合新集群:

  1. 新建一个Kind集群配置文件,比如kind-config.yaml,内容如下:

    kind: Cluster
    apiVersion: kind.x-k8s.io/v1alpha4
    nodes:
    - role: control-plane
      containerdConfigPatches:
      - |-
        [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
          endpoint = ["https://hub-mirror.c.163.com", "https://mirror.baidubce.com"]
    

    这里用了网易和百度的国内镜像源,你也可以换成自己的阿里云镜像加速地址(如果有的话)。

  2. 用这个配置文件创建Kind集群:

    kind create cluster --config kind-config.yaml --name dev
    

方案二:给已有的Kind集群添加镜像源

如果不想重新创建集群,直接修改现有节点的containerd配置:

  1. 进入你的Kind控制节点容器:
    docker exec -it dev-control-plane /bin/bash
    
  2. 编辑containerd的配置文件:
    vi /etc/containerd/config.toml
    
  3. 在配置中找到[plugins."io.containerd.grpc.v1.cri".registry.mirrors]区块,添加Docker Hub的镜像源配置:
    [plugins."io.containerd.grpc.v1.cri".registry.mirrors."docker.io"]
      endpoint = ["https://hub-mirror.c.163.com", "https://mirror.baidubce.com"]
    
  4. 重启containerd服务:
    systemctl restart containerd
    
  5. 退出节点容器,删除之前失败的Pod并重新创建:
    kubectl delete pod nginx hello
    kubectl run nginx --image=nginx
    kubectl run hello --image=hello-world
    

备选方案:提前把镜像加载到Kind集群

如果你不想配置镜像源,也可以先在本地拉取镜像,再加载到Kind集群里:

  1. 本地拉取所需镜像:
    docker pull nginx
    docker pull hello-world
    
  2. 把镜像加载到Kind集群:
    kind load docker-image nginx --name dev
    kind load docker-image hello-world --name dev
    
  3. 再创建Pod时,Kubernetes会直接使用本地加载的镜像,不用从远程拉取了:
    kubectl run nginx --image=nginx
    kubectl run hello --image=hello-world
    

用上面任意一种方法,应该就能解决你的镜像拉取问题了!

内容的提问来源于stack exchange,提问作者Hantsy

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.08 23:57:50