minikube安装kubernetes以及start启动报错解决办法：Unable to find image ‘gcr.io/k8s-minikube/kicbase

最新推荐文章于 2025-10-29 14:18:28 发布
原创 最新推荐文章于 2025-10-29 14:18:28 发布 · 3.3k 阅读 · 5 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#kubernetes #docker #linux #minikube

文章讲述了在Linux系统中使用minikube安装Kubernetes集群时可能遇到的问题，包括不能以root权限使用docker驱动和镜像下载失败。解决方案是使用--force参数强行启动，以及切换到国内阿里云镜像源下载替代镜像。通过指定参数如--base-image、--image-mirror-country和--image-repository，成功启动minikube并访问集群。

使用minikubu安装kuburnetes集群，所遇到的问题，以及如何设置。

安装 Kubernetes 集群

三种安装方式，练习使用minikube简单化安装，相关文档资料如下所示：

在Linux中安装并设置kubectl

安装minikube之前要先安装kubectl,以下是官方文档安装教程。文档很详细，并且建议根据文档安装下“启用 shell 自动补全功能”，这个自动补全功能真的很好用，省很大事呢！

minikube安装

安装minikube前要把docker提前安装好，并设置为国内阿里云镜像。
在这里插入图片描述
根据如图所示选择自己的操作系统架构执行安装即可。
但在下一步minikube start的时候经常会出错，这里列几个我遇到的问题：

问题1、报错X Exiting due to DRV_AS_ROOT: The “docker” driver should not be used with root privileges.

  • Centos 7.9.2009 (kvm/amd64) 上的 minikube v1.29.0
  • Kubernetes 1.26.1 is now available. If you would like to upgrade, specify: --kubernetes-version=v1.26.1
  • 根据现有的配置文件使用 docker 驱动程序
  • The “docker” driver should not be used with root privileges. If you wish to continue as root, use --force.
  • If you are running minikube within a VM, consider using --driver=none:
  • https://minikube.sigs.k8s.io/docs/reference/drivers/none/
  • Tip: To remove this root owned cluster, run: sudo minikube delete
    X Exiting due to DRV_AS_ROOT: The “docker” driver should not be used
    with root privileges.

这个问题好解决，说是不能用root，但是我就要用，所以直接加个 --force参数就可以。

问题2、Unable to find image ‘gcr.io/k8s-minikube/kicbase:v0.0.37@sha256:8bf7a0e8a062bc5e2b71d28b35bfa9cc862d9220e234e86176b3785f685d8b15’ locally

在这里插入图片描述

出现这个问题要设置为国内镜像，并且添加下载替换的镜像。

解决办法

查找替代的镜像，比如anjone/kicbase

  • 下载镜像
docker pull anjone/kicbase
  • 指定镜像启动
    使用anjone/kicbase，而不是gcr.io/k8s-minikube/kicbase:v0.0.10。
    这样就不会因为gcr.io/k8s-minikube/kicbase:v0.0.10下载失败，而无法启动集群！

最终参数列表：

参数说明值
–base-image指定镜像，忽略SHA校验anjone/kicbase
–vm-driver使用dockerdocker
–image-mirror-country镜像所在的国家是中国cn
–image-repository镜像仓库地址为阿里云registry.cn-hangzhou.aliyuncs.com/google_containers
–logtostderr输出日志到stderr
–kubernetes-version指定kubernetes版本v1.22.0
–force强制使用root账户

所以最终的start命令如下：

minikube start --vm-driver=docker --base-image="anjone/kicbase" --image-mirror-country='cn' --image-repository='registry.cn-hangzhou.aliyuncs.com/google_containers' --kubernetes-version='v1.22.0' --force

执行成功如下图所示：
在这里插入图片描述

  • 访问集群，看到下图就说明成功了
    在这里插入图片描述
kubectl get po -A

如果还有其他报错，可以通过参数说明查看参数设置：

minikube start --help
阿里云安装 minikube v1.9.2
qq_25951401的博客
05-06 2849
阿里云安装 minikube v1.9.2 日期：2020年5月6日 一、环境 阿里云 centos8 2c4g 二、安装docker centos官方安装教程 https://docs.docker.com/engine/install/centos/ 国内阿里云centos8安装参考资料 https://yq.aliyun.com/articles/748412 安装完后可做的操作 http...
X Exiting due to DRV_AS_ROOT: The “docker“ driver should not be used with root privileges
热门推荐
t0m的专栏
09-25 1万+
[root@dev01 ~]# minikube start --driver=docker * minikube v1.13.0 on Centos 8.1.1911 * Using the docker driver based on user configuration * The "docker" driver should not be used with root privileges. * If you are running minikube within a VM, consider u.
【运行一个简单的k8s集群】
最新发布
m0_52021466的博客
10-29 690
利用minikube实现在本地虚拟机运行一个简单的k8s集群
minikube start 可选项(中文版)
e891377的专栏
05-26 1056
minikube start 可选项
minikube安装与运行（阿里云环境运行）
ilwoziji的博客
04-11 2288
说下为啥选择云环境，最开始在本地电脑上安装的minikube，但是由于国内的网络访问不了谷歌的镜像仓库，安装ingress-nginx或者其他插件时着实的恶心。要不翻墙，要不自己搭建个镜像仓库。最终决定用阿里云境外的节点，按小时收费的那种，一个小时大概也就3毛钱。随时释放，不会因为这些环境和网络的问题分神。
minikube start启动集群失败Unable to find image gcr.io/k8s-minikube/kicbase:v0.0.10
在线笔记
08-01 5615
1. minikube启动集群 minikube start --vm-driver=docker --image-mirror-country='cn' --image-repository='registry.cn-hangzhou.aliyuncs.com/google_containers' --logtostderr 参数 值 –vm-driver 使用docker –image-mirror-country 镜像所在的国家是中国 –image-repository 镜像
【minikube】minikube start报错
fafawf的博客
04-22 1253
minikube 启动报错 X Exiting due to DRV_AS_ROOT: The "docker" driver should not be used with root privileges. 修改为 minikube start --force --driver=docker 可运行
cxc@cxc-VMware-Virtual-Platform:~$ minikube start * Ubuntu 25.04 上的 minikube v1.35.0 * 自动选择 docker 驱动。其他选项：none, ssh * 使用具有 root 权限的 Docker 驱动程序 * 在集群中 "minikube" 启动节点 "minikube" primary control-plane * 正在拉取基础镜像 v0.0.46 ... * 正在下载 Kubernetes v1.32.0 的预加载文件... > preloaded-images-k8s-v18-v1...: 112.81 MiB / 333.57 MiB 33.82% 677.97 K! minikube cannot pull kicbase image from any docker registry, and is trying to download kicbase tarball from github release page via HTTP. ! It's very likely that you have an internet issue. Please ensure that you can access the internet at least via HTTP, directly or with proxy. Currently your proxy configure is: > preloaded-images-k8s-v18-v1...: 333.57 MiB / 333.57 MiB 100.00% 737.35 E0516 20:26:00.769799 32819 cache.go:222] Error downloading kic artifacts: failed to download kic base image or any fallback image * 创建 docker container（CPU=2，内存=2200MB）... ! StartHost 失败，将要重试: creating host: create: creating: setting up container node: preparing volume for minikube container: docker run --rm --name minikube-preload-sidecar --label created_by.minikube.sigs.k8s.io=true --label name.minikube.sigs.k8s.io=minikube --entrypoint /usr/bin/test -v minikube:/var gcr.io/k8s-minikube/kicbase:v0.0.46@sha256:fd2d445ddcc33ebc5c6b68a17e6219ea207ce63c005095ea1525296da2d1a279 -d /var/lib: exit status 125 stdout: stderr: Unable to find image 'gcr.io/k8s-minikube/kicbase:v0.0.46@sha256:fd2d445ddcc33ebc5c6b68a17e6219ea207ce63c005095ea1525296da2d1a279' locally docker: Error response from daemon: Get "https://gcr.io/v2/": context deadline exceeded Run 'docker run --help' for more information * docker "minikube" 缺失 container，将重新创建。 * 创建 docker container（CPU=2，内存=2200MB）... * 启动 docker container 失败。运行 "minikube delete" 可能需要修复它： recreate: creating host: create: creating: setting up container node: preparing volume for minikube container: docker run --rm --name minikube-preload-sidecar --label created_by.minikube.sigs.k8s.io=true --label name.minikube.sigs.k8s.io=minikube --entrypoint /usr/bin/test -v minikube:/var gcr.io/k8s-minikube/kicbase:v0.0.46@sha256:fd2d445ddcc33ebc5c6b68a17e6219ea207ce63c005095ea1525296da2d1a279 -d /var/lib: exit status 125 stdout: stderr: Unable to find image 'gcr.io/k8s-minikube/kicbase:v0.0.46@sha256:fd2d445ddcc33ebc5c6b68a17e6219ea207ce63c005095ea1525296da2d1a279' locally docker: Error response from daemon: Get "https://gcr.io/v2/": context deadline exceeded (Client.Timeout exceeded while awaiting headers) Run 'docker run --help' for more information X 因 GUEST_PROVISION 错误而退出：error provisioning guest: Failed to start host: recreate: creating host: create: creating: setting up container node: preparing volume for minikube container: docker run --rm --name minikube-preload-sidecar --label created_by.minikube.sigs.k8s.io=true --label name.minikube.sigs.k8s.io=minikube --entrypoint /usr/bin/test -v minikube:/var gcr.io/k8s-minikube/kicbase:v0.0.46@sha256:fd2d445ddcc33ebc5c6b68a17e6219ea207ce63c005095ea1525296da2d1a279 -d /var/lib: exit status 125 stdout: stderr: Unable to find image 'gcr.io/k8s-minikube/kicbase:v0.0.46@sha256:fd2d445ddcc33ebc5c6b68a17e6219ea207ce63c005095ea1525296da2d1a279' locally docker: Error response from daemon: Get "https://gcr.io/v2/": context deadline exceeded (Client.Timeout exceeded while awaiting headers) Run 'docker run --help' for more information * ╭───────────────────────────────────────────────────────────────────────────────────────────────────╮ │ │ │ * 如果上述建议无法帮助解决问题，请告知我们： │ │ https://github.com/kubernetes/minikube/issues/new/choose │ │ │ │ * 请运行 minikube logs --file=logs.txt 命令，并将生成的 logs.txt 文件附加到 GitHub 问题中。 │ │ │ ╰───────────────────────────────────────────────────────────────────────────────────────────────────╯
05-17
"kubelet": "gcr.io/k8s-minikube/kicbase:v0.0.xx", "custom_kic_base_image": "registry.cn-hangzhou.aliyuncs.com/google_containers/kicbase-v0.0.xx" } ``` 注意：需根据实际需求调整版本号和目标仓库名称。 ...
stderr: Unable to find image 'gcr.io/k8s-minikube/kicbase:v0.0.39@sha256:bf2d9f1e9d837d8deea073611d2605405b6be904647d97ebd9b12045ddfe1106' locally docker: Error response from daemon: Get "https://gcr.io/v2/": net/http: request canceled while waiting for connection (Client.Timeout exceeded while awaiting headers). See 'docker run --help'.
05-26
这个错误信息提示 Docker 无法在本地找到指定的镜像，同时也无法从远程仓库下载...minikube stop && minikube start ``` 这个命令会先停止 Minikube，然后再启动它。在启动的过程中，Minikube 会自动下载所需的镜像。
本地搭建k8s集群日志
weixin_43324309的博客
01-29 969
操作系统：macos 最开始想参照minikube官网搭建一个集群，步骤如下： 安装minikube brew install minikube 用minikube创建集群 minikube start --nodes 2 -p multinode-demo 在这一步就遇到了问题，日志没有报错，但在拉取镜像kicbase的时候一直处于0进度，google了很多发现国内拉这个镜像就是有问题，于是看到有各种各样的解决方法，比如minikube start启动集群失败Unable to find im
ee@lee-virtual-machine:~/桌面$ minikube start --kubernetes-version=1.23.0 --base-image='rdsource.tp-link.com:8088/kicbase/stable:v0.0.47' 😄 Ubuntu 22.04 上的 minikube v1.36.0 ✨ 自动选择 docker 驱动 📌 使用具有 root 权限的 Docker 驱动程序 👍 在集群中 "minikube" 启动节点 "minikube" primary control-plane 🚜 正在拉取基础镜像 v0.0.47 ... ⌛ 另一个 minikube 实例正在下载依赖项… 💾 正在下载 Kubernetes v1.23.0 的预加载文件... > preloaded-images-k8s-v18-v1...: 399.22 MiB / 399.22 MiB 100.00% 2.17 Mi ❗ minikube cannot pull kicbase image from any docker registry, and is trying to download kicbase tarball from github release page via HTTP. ❗ 很可能您遇到了网络问题。请确保您可以通过 HTTP 访问互联网，直接连接或使用代理。当前您的代理配置为： E0819 16:50:24.735963 3398 cache.go:225] Error downloading kic artifacts: failed to download kic base image or any fallback image 🔥 创建 docker container（CPU=2，内存=2200MB）... 🤦 StartHost 失败，将要重试: creating host: create host timed out in 360.000000 seconds 🤷 docker "minikube" 缺失 container，将重新创建。 🔥 创建 docker container（CPU=2，内存=2200MB）... 😿 启动 docker container 失败。运行 "minikube delete" 可能需要修复它： recreate: creating host: create: creating: setting up container node: preparing volume for minikube container: docker run --rm --name minikube-preload-sidecar --label created_by.minikube.sigs.k8s.io=true --label name.minikube.sigs.k8s.io=minikube --entrypoint /usr/bin/test -v minikube:/var rdsource.tp-link.com:8088/kicbase/stable:v0.0.47 -d /var/lib: exit status 125 stdout: stderr: Unable to find image 'rdsource.tp-link.com:8088/kicbase/stable:v0.0.47' locally v0.0.47: Pulling from kicbase/stable f4e12836666d: Pulling fs layer f4e12836666d: Pull complete Digest: sha256:6ed579c9292b4370177b7ef3c42cc4b4a6dcd0735a1814916cbc22c8bf38412b Status: Downloaded newer image for rdsource.tp-link.com:8088/kicbase/stable:v0.0.47 docker: Error response from daemon: Conflict. The container name "/minikube-preload-sidecar" is already in use by container "b70d6e8d051a698c39c6cac8b88bb685c5bc6430d1911e1ee25839075f7caa15". You have to remove (or rename) that container to be able to reuse that name. Run 'docker run --help' for more information ❌ 因 GUEST_PROVISION 错误而退出：error provisioning guest: Failed to start host: recreate: creating host: create: creating: setting up container node: preparing volume for minikube container: docker run --rm --name minikube-preload-sidecar --label created_by.minikube.sigs.k8s.io=true --label name.minikube.sigs.k8s.io=minikube --entrypoint /usr/bin/test -v minikube:/var rdsource.tp-link.com:8088/kicbase/stable:v0.0.47 -d /var/lib: exit status 125 stdout: stderr: Unable to find image 'rdsource.tp-link.com:8088/kicbase/stable:v0.0.47' locally v0.0.47: Pulling from kicbase/stable f4e12836666d: Pulling fs layer f4e12836666d: Pull complete Digest: sha256:6ed579c9292b4370177b7ef3c42cc4b4a6dcd0735a1814916cbc22c8bf38412b Status: Downloaded newer image for rdsource.tp-link.com:8088/kicbase/stable:v0.0.47 docker: Error response from daemon: Conflict. The container name "/minikube-preload-sidecar" is already in use by container "b70d6e8d051a698c39c6cac8b88bb685c5bc6430d1911e1ee25839075f7caa15". You have to remove (or rename) that container to be able to reuse that name. Run 'docker run --help' for more information
08-20
minikube start --kubernetes-version=1.23.0 --base-image='gcr.io/k8s-minikube/kicbase:v0.0.47' ``` 3. **检查网络和代理**： - 确保 Docker 能访问互联网：测试 `docker pull hello-world`。 - 如有代理，...
kicbase_v0.0.8.tar.gz
05-06
自行下载的kicbase镜像，gcr.io/k8s-minikube/kicbase:v0.0.8@sha256:2f3380ebf1bb0c75b0b47160fd4e61b7b8fef0f1f32f9def108d3eada50a7a81 用于解决该镜像下不到的问题
kicbase.tar
08-01
anjone/kicbase导出来的镜像，使用命令导入镜像docker load -i kicbase.tar
minikube 启动出错
u_my_heart的博客
08-17 509
minikube delete minikube start --vm-driver=hyperv --hyperv-virtual-switch=minikube
Minikube不能成功启动的报错分析及解决方案
m0_37806791的博客
03-16 6258
Minikube不能成功启动的报错分析及解决方案 Minikube启动前需要对系统环境进行初始化： # 启用docker服务 sudo systemctl enable docker.service # 关闭防火墙 sudo systemctl stop firewalld # 关闭内存交换 sudo swapoff -a # 修改文件驱动 sudo vi /lib/systemd/syst...
minikube start 失败
mwh1233的博客
09-26 418
需要先删除先前的juju相关的tmp文件，然后关闭保护。
Linux下minikube启动失败(It seems like the kubelet isn‘t running or healthy)
2301_76323084的博客
04-02 641
最近我根据上述的技术体系图搜集了几十套腾讯、头条、阿里、美团等公司21年的面试题，把技术点整理成了视频（实际上比预期多花了不少精力），包含知识脉络 + 诸多细节，由于篇幅有限，这里以图片的形式给大家展示一部分。
minikube 国内镜像源启动报错
小喽喽
03-25 5206
minikube启动命令 minikube.exe start --image-mirror-country cn --iso-url=https://kubernetes.oss-cn-hangzhou.aliyuncs.com/minikube/iso/minikube-v1.8.0.iso --registry-mirror=https://xxxxxx.mirror.aliyuncs...
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

千里马不常有

整理不易，点滴助力就是不竭动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值