Minikube windows安装

原创已于 2026-07-01 14:24:40 修改 · 217 阅读

3 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

云计算

于 2026-06-30 13:45:00 首次发布

1. 什么是 Minikube？

Minikube 是一个用于在本地计算机上运行单节点 Kubernetes 集群的工具。它通过虚拟机或容器的方式，在本地快速创建一个轻量级的 Kubernetes 环境，非常适合开发、测试和学习 Kubernetes。

主要特点：

快速启动本地 Kubernetes 集群
支持多种驱动（Docker、Hyper-V、VirtualBox 等）
与标准 Kubernetes API 完全兼容
轻量级，资源消耗相对较小

2. 系统要求

在安装 Minikube 之前，请确保您的系统满足以下最低要求：

2.1 硬件要求

CPU：2 核或以上
内存：2 GB 或以上（建议 4 GB）
磁盘空间：20 GB 可用空间

2.2 软件要求

操作系统：Windows 10/11、macOS 或 Linux
虚拟化支持：需要在 BIOS/UEFI 中启用虚拟化技术（Intel VT-x/AMD-V）
容器或虚拟机管理程序：需要安装以下之一：
- Docker（推荐）
- Hyper-V（Windows）
- VirtualBox
- VMware Fusion/Workstation

3. 安装 Minikube

3.1 Windows 系统安装

方法三：使用 PowerShell 安装

参考官网

# 以管理员身份打开 PowerShell
New-Item -Path 'c:\' -Name 'minikube' -ItemType Directory -Force
Invoke-WebRequest -OutFile 'c:\minikube\minikube.exe' -Uri 'https://github.com/kubernetes/minikube/releases/latest/download/minikube-windows-amd64.exe' -UseBasicParsing
$env:Path += ';C:\minikube'
[Environment]::SetEnvironmentVariable('Path', $env:Path, [EnvironmentVariableTarget]::User)

3.2 macOS 系统安装

方法一：使用 Homebrew 安装（推荐）

brew install minikube

方法二：手动下载安装

# 下载 Minikube 二进制文件
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64

# 安装到系统路径
sudo install minikube-darwin-amd64 /usr/local/bin/minikube

# 清理下载文件
rm minikube-darwin-amd64

3.3 Linux 系统安装

方法一：使用包管理器安装

Ubuntu/Debian：

# 下载最新版 Minikube
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64

# 安装到系统路径
sudo install minikube-linux-amd64 /usr/local/bin/minikube

# 清理下载文件
rm minikube-linux-amd64

CentOS/RHEL/Fedora：

# 下载最新版 Minikube
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64

# 安装到系统路径
sudo install minikube-linux-amd64 /usr/local/bin/minikube

# 清理下载文件
rm minikube-linux-amd64

方法二：使用 Snap 安装（Ubuntu）

sudo snap install minikube

4. 配置驱动

Minikube 支持多种驱动，您需要根据系统环境选择合适的驱动：

4.1 Docker 驱动（推荐）

如果已安装 Docker，这是最简单的方式：

# 查看当前驱动
minikube config get driver

# 设置 Docker 驱动
minikube config set driver docker

4.2 其他常用驱动

# 设置 Hyper-V 驱动（Windows）
minikube config set driver hyperv

# 设置 VirtualBox 驱动
minikube config set driver virtualbox

# 设置 VMware 驱动
minikube config set driver vmware

5. 启动 Minikube 集群

5.1 基本启动命令

# 使用默认配置启动
minikube start

# 指定驱动启动
minikube start --driver=docker

# 指定 Kubernetes 版本
minikube start --kubernetes-version=v1.28.0

# 指定内存和 CPU
minikube start --memory=4096 --cpus=2

5.2 首次启动常见问题解决

问题 1：虚拟化未启用

症状： 启动时提示 “VT-x/AMD-v hardware acceleration is not available”
解决方案：

重启计算机进入 BIOS/UEFI 设置
找到虚拟化相关选项（Intel VT-x、AMD-V、SVM 等）
启用虚拟化支持
保存设置并重启

问题 2：驱动问题

症状： “No default driver found”
解决方案：

# 列出所有可用驱动
minikube config view

# 设置默认驱动
minikube config set driver docker

问题 3：资源不足

症状： 启动失败，提示内存或 CPU 不足
解决方案：

# 减少资源分配
minikube start --memory=2048 --cpus=1

# 或增加系统资源后重试

6. 验证安装

6.1 检查集群状态

# 查看集群状态
minikube status

# 查看节点信息
kubectl get nodes

# 查看所有 Pod
kubectl get pods -A

6.2 运行测试应用

# 部署一个测试 Nginx
kubectl create deployment nginx --image=nginx:latest

# 暴露服务
kubectl expose deployment nginx --port=80 --type=NodePort

# 获取服务 URL
minikube service nginx --url

# 访问测试页面
curl $(minikube service nginx --url)

6.3 查看 Dashboard

# 开启 Dashboard
minikube dashboard

# 或在后台运行
minikube dashboard --url

7. 常用命令

7.1 集群管理

# 暂停集群
minikube pause

# 恢复集群
minikube unpause

# 停止集群
minikube stop

# 删除集群
minikube delete

# 重启集群
minikube restart

7.2 配置管理

# 查看所有配置
minikube config view

# 设置配置项
minikube config set memory 4096
minikube config set cpus 2

# 取消设置
minikube config unset memory

7.3 插件管理

# 列出可用插件
minikube addons list

# 启用插件
minikube addons enable ingress
minikube addons enable metrics-server

# 禁用插件
minikube addons disable ingress

8. 故障排除

8.1 常见错误及解决方案

错误 1：minikube start 卡住

# 查看详细日志
minikube start --alsologtostderr -v=7

# 或删除后重新创建
minikube delete
minikube start

错误 2：无法拉取镜像

# 使用阿里云镜像
minikube start --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers

# 或配置镜像加速
minikube start --registry-mirror=https://docker.mirrors.ustc.edu.cn

错误 3：端口冲突

# 指定不同端口
minikube start --ports=8080:80,8443:443

8.2 日志查看

# 查看 Minikube 日志
minikube logs

# 查看特定组件日志
minikube logs --component=kube-apiserver

# 导出所有日志
minikube logs --file=minikube.log

9. 性能优化建议

9.1 资源配置优化

# 根据系统资源调整
minikube start --memory=8192 --cpus=4 --disk-size=50g

# 启用 GPU 支持（如果可用）
minikube start --driver=docker --gpus=all

9.2 网络优化

# 使用更快的网络模式
minikube start --network-plugin=cni --cni=calico

# 或使用 host-gateway 模式
minikube start --network=host-gateway

9.3 存储优化

# 使用 SSD 存储
minikube start --mount --mount-string="/data:/data"

# 或配置持久卷
minikube start --extra-config=apiserver.enable-admission-plugins=DefaultStorageClass

9.4 镜像加速

minikube delete

minikube start --driver=hyperv --memory=2048 --cpus=2 --disk-size=20g  --hyperv-use-dynamic-memory

#1.32.0
minikube start --driver=docker --image-mirror-country=cn
#1.38.0

minikube start  --driver=docker --image-mirror-country=cn --registry-mirror=https://docker.xuanyuan.me
或者
minikube start --driver=docker --image-mirror-country=cn --registry-mirror=https://registry.docker-cn.com
或者
minikube start --driver=docker --registry-mirror=https://registry.cn-hangzhou.aliyuncs.com --kubernetes-version=v1.32.2