1. 什么是 MinikubeMinikube 是一个用于在本地计算机上运行单节点 Kubernetes 集群的工具。它通过虚拟机或容器的方式在本地快速创建一个轻量级的 Kubernetes 环境非常适合开发、测试和学习 Kubernetes。主要特点快速启动本地 Kubernetes 集群支持多种驱动Docker、Hyper-V、VirtualBox 等与标准 Kubernetes API 完全兼容轻量级资源消耗相对较小2. 系统要求在安装 Minikube 之前请确保您的系统满足以下最低要求2.1 硬件要求CPU2 核或以上内存2 GB 或以上建议 4 GB磁盘空间20 GB 可用空间2.2 软件要求操作系统Windows 10/11、macOS 或 Linux虚拟化支持需要在 BIOS/UEFI 中启用虚拟化技术Intel VT-x/AMD-V容器或虚拟机管理程序需要安装以下之一Docker推荐Hyper-VWindowsVirtualBoxVMware Fusion/Workstation3. 安装 Minikube3.1 Windows 系统安装方法三使用 PowerShell 安装参考 官网# 以管理员身份打开 PowerShellNew-Item-Pathc:\-Nameminikube-ItemType Directory-ForceInvoke-WebRequest-OutFilec:\minikube\minikube.exe-Urihttps://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 安装推荐brewinstallminikube方法二手动下载安装# 下载 Minikube 二进制文件curl-LOhttps://storage.googleapis.com/minikube/releases/latest/minikube-darwin-amd64# 安装到系统路径sudoinstallminikube-darwin-amd64 /usr/local/bin/minikube# 清理下载文件rmminikube-darwin-amd643.3 Linux 系统安装方法一使用包管理器安装Ubuntu/Debian# 下载最新版 Minikubecurl-LOhttps://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64# 安装到系统路径sudoinstallminikube-linux-amd64 /usr/local/bin/minikube# 清理下载文件rmminikube-linux-amd64CentOS/RHEL/Fedora# 下载最新版 Minikubecurl-LOhttps://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64# 安装到系统路径sudoinstallminikube-linux-amd64 /usr/local/bin/minikube# 清理下载文件rmminikube-linux-amd64方法二使用 Snap 安装Ubuntusudosnapinstallminikube4. 配置驱动Minikube 支持多种驱动您需要根据系统环境选择合适的驱动4.1 Docker 驱动推荐如果已安装 Docker这是最简单的方式# 查看当前驱动minikube config get driver# 设置 Docker 驱动minikube configsetdriverdocker4.2 其他常用驱动# 设置 Hyper-V 驱动Windowsminikube configsetdriver hyperv# 设置 VirtualBox 驱动minikube configsetdriver virtualbox# 设置 VMware 驱动minikube configsetdriver vmware5. 启动 Minikube 集群5.1 基本启动命令# 使用默认配置启动minikube start# 指定驱动启动minikube start--driverdocker# 指定 Kubernetes 版本minikube start --kubernetes-versionv1.28.0# 指定内存和 CPUminikube start--memory4096--cpus25.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 configsetdriverdocker问题 3资源不足症状启动失败提示内存或 CPU 不足解决方案# 减少资源分配minikube start--memory2048--cpus1# 或增加系统资源后重试6. 验证安装6.1 检查集群状态# 查看集群状态minikube status# 查看节点信息kubectl get nodes# 查看所有 Podkubectl get pods-A6.2 运行测试应用# 部署一个测试 Nginxkubectl create deployment nginx--imagenginx:latest# 暴露服务kubectl expose deployment nginx--port80--typeNodePort# 获取服务 URLminikubeservicenginx--url# 访问测试页面curl$(minikubeservicenginx--url)6.3 查看 Dashboard# 开启 Dashboardminikube dashboard# 或在后台运行minikube dashboard--url7. 常用命令7.1 集群管理# 暂停集群minikube pause# 恢复集群minikube unpause# 停止集群minikube stop# 删除集群minikube delete# 重启集群minikube restart7.2 配置管理# 查看所有配置minikube config view# 设置配置项minikube configsetmemory4096minikube configsetcpus2# 取消设置minikube configunsetmemory7.3 插件管理# 列出可用插件minikube addons list# 启用插件minikube addonsenableingress minikube addonsenablemetrics-server# 禁用插件minikube addons disable ingress8. 故障排除8.1 常见错误及解决方案错误 1minikube start卡住# 查看详细日志minikube start--alsologtostderr-v7# 或删除后重新创建minikube delete minikube start错误 2无法拉取镜像# 使用阿里云镜像minikube start --image-repositoryregistry.cn-hangzhou.aliyuncs.com/google_containers# 或配置镜像加速minikube start --registry-mirrorhttps://docker.mirrors.ustc.edu.cn错误 3端口冲突# 指定不同端口minikube start--ports8080:80,8443:4438.2 日志查看# 查看 Minikube 日志minikube logs# 查看特定组件日志minikube logs--componentkube-apiserver# 导出所有日志minikube logs--fileminikube.log9. 性能优化建议9.1 资源配置优化# 根据系统资源调整minikube start--memory8192--cpus4--disk-size50g# 启用 GPU 支持如果可用minikube start--driverdocker--gpusall9.2 网络优化# 使用更快的网络模式minikube start --network-plugincni--cnicalico# 或使用 host-gateway 模式minikube start--networkhost-gateway9.3 存储优化# 使用 SSD 存储minikube start--mount--mount-string/data:/data# 或配置持久卷minikube start --extra-configapiserver.enable-admission-pluginsDefaultStorageClass10. 下一步学习建议成功安装 Minikube 后您可以学习 Kubernetes 基础概念Pod、Deployment、ServiceConfigMap、SecretPersistentVolume、StorageClass尝试部署实际应用部署多容器应用配置服务发现设置健康检查探索高级功能使用 Helm 包管理配置 Ingress 控制器设置自动扩缩容HPA迁移到生产环境了解云厂商的 Kubernetes 服务学习集群运维最佳实践掌握监控和日志收集提示本文档基于 Minikube v1.32.0 编写不同版本可能略有差异。建议访问 Minikube 官方文档 获取最新信息。