minikube：本地 K8s 实验场指南

项目地址：https://github.com/kubernetes/minikube 定位：本地 K8s 集群（默认单节点）的一键搭建工具——学习、开发、演示的标准答案，K8s 官方维护。

元信息	说明
语言	Go
星标	30k+ ⭐
协议	Apache 2.0
支持驱动	Docker / Podman / VirtualBox / Hyper-V / KVM / QEMU / VMware / bare-metal
跨平台	Linux / macOS / Windows（含 ARM64 Apple Silicon）

1、背景：本地集群的不可替代性

云时代"直接用云上集群"很方便，但本地集群有不可替代的价值：

学习：搞坏随时重建（云上搞坏要花钱+提心吊胆）
开发：inner loop 秒级迭代（改 manifest → apply → 看 pod）
测试：验证 Helm chart / operator 在"干净集群"的行为
离线：飞机上/内网环境照样能干活

minikube 的定位是"功能最全的本地 K8s"：addons 生态、多驱动、Ingress/Registry/监控一键开——对比 K3s（第 21 篇，更轻、面向生产边缘）与 Kind（面向 CI），它赢在"开箱即用的完整体验"。

2、核心能力地图

┌─────────────────────── minikube ───────────────────────┐
│ 集群管理：start/stop/delete/pause，多集群 profile       │
│ 驱动抽象：VM（隔离好）或容器（启动快）二选一              │
│ Addons：ingress dashboard registry metrics-server       │
│         istio volumesnapshots... 30+ 一键开关           │
│ 开发配套：minikube tunnel（LoadBalancer 直连本地）       │
│           minikube mount（宿主目录挂进 VM）              │
│           minikube docker-env（复用本地镜像缓存）        │
│           minikube cp / ssh / logs                      │
└─────────────────────────────────────────────────────────┘

3、快速上手：从零到 Ingress 可访问

# 1) 安装（任选）
brew install minikube                       # macOS
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 \
  && sudo install minikube-linux-amd64 /usr/local/bin/minikube

# 2) 起集群（默认 docker 驱动，资源给足才不卡）
minikube start --cpus=4 --memory=8g --driver=docker --kubernetes-version=v1.30.0

# 3) 部署 + 验证
kubectl create deployment web --image=nginx
kubectl expose deployment web --port=80 --type=NodePort
minikube service web          # 浏览器直达（自动处理端口映射）

# 4) 开 Ingress 走"准生产"路径
minikube addons enable ingress
kubectl apply -f - <<EOF
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata: { name: web }
spec:
  rules:
    - http: { paths: [ { path: /, pathType: Prefix,
        backend: { service: { name: web, port: { number: 80 } } } } ] }
EOF
# hosts 加一条 127.0.0.1 web.local → curl http://web.local/

# 5) LoadBalancer 服务（本地没有云 LB？）
minikube tunnel              # 前台跑着，EXTERNAL-IP 从 <pending> 变 127.0.0.1

4、高频场景配方

4.1、本地镜像免推送（最实用的三条路径）

# A) 复用 minikube 内的 docker daemon（镜像直接 build 进去）
eval $(minikube docker-env)      # 当前 shell 的 docker 命令指向集群
docker build -t myapp:dev .      # 不需要 push 到任何 registry

# B) minikube image load 直接灌镜像
minikube image load myapp:dev

# C) 本地 registry addon
minikube addons enable registry

4.2、Dashboard 与监控

minikube dashboard                        # 官方面板（学习期友好）
minikube addons enable metrics-server     # kubectl top 可用
minikube addons enable metrics-server && kubectl top pods

4.3、多版本/多集群并存

minikube start -p v130 --kubernetes-version=v1.30.0
minikube start -p v127 --kubernetes-version=v1.27.16
minikube profile list                     # 两个集群并存，验证版本兼容性神器

4.4、开发联调

minikube mount ./src:/host-src            # 宿主代码挂进 VM
kubectl port-forward svc/web 8080:80      # 本地访问服务（调试利器）
minikube ssh                              # 进节点看 containerd/网络/内核

5、生产实践视角（实验场的"工程化"）

1. 资源给足再开工：默认 2C2G 跑不动几个插件；建议 4C8G 起（Ingress+metrics+业务），Apple Silicon 用户记得 --memory 上限受 Docker Desktop 配置约束；
2. 驱动选择：日常开发用 docker 驱动（秒级启动）；需要测内核特性/CNI 行为时用 VM 驱动（隔离真实内核）；Linux 服务器上可直接 --driver=none（裸跑，注意污染宿主）；
3. "搞坏了就重建"的工作流：minikube delete && minikube start ... 比修一个状态混乱的集群快得多——保持集群是一次性的心智，重要数据/manifest 全部在 Git（与第 5 篇声明式呼应）；
4. CI 里别用 minikube：它面向交互式单机；CI 跑测试用 Kind（秒级起停、每 job 独立）或 K3s（第 21 篇，更接近真实节点）——工具各就各位；
5. 网络限制环境：--image-mirror-country=cn --image-repository=registry.cn-hangzhou.aliyuncs.com/google_containers 解决拉取 k8s 组件超时；代理场景配 --docker-env HTTP_PROXY=...；
6. 与真实集群的差异清单（心里有数）：默认单节点（没有跨节点网络/调度问题）、LoadBalancer/StorageClass 是模拟的、节点故障/升级场景测不了——这些去第 11 篇 hard way 或云上多节点环境补课。

6、横向对比（本地 K8s 三剑客终局对比）

维度	minikube	Kind	K3s/k3d（第 21 篇）
启动速度	1-3 分钟	~10 秒	30s / 5s(k3d)
形态	VM/容器（默认单节点）	容器化多"节点"	轻量发行版
Addons 生态	✅ 30+ 一键	少量内置	Helm 自装
多节点模拟	可选（--nodes）	✅（伪多节点）	✅（k3d 真 agent）
学习友好度	最高（dashboard/tunnel）	中	中
CI 适用	一般	最佳	好

决策速判：学习期用 minikube（所见即所得），CI 用 Kind（速度），轻量生产/边缘用 K3s（真实）——三者不是竞争，是同一技术栈在不同场景的投影。

7、常见问题排查

1. Q：minikube start 卡在拉镜像？ A：网络问题占 90%。加镜像参数（见第 5 节）或配代理 --docker-env HTTPS_PROXY；也可 --download-only 预热。
2. Q：Ingress 域名访问不通？ A：本地没有 DNS——minikube tunnel + hosts 文件，或直接用 minikube ip + curl -H "Host: web.local"。理解"Ingress 靠 Host 头路由"顺便就学会了。
3. Q：磁盘满了？ A：minikube 的容器/VM 会积累镜像与 etcd 数据。定期 minikube delete（注意备份 etcd 里的 CRD 数据要先导出）；docker system prune 清宿主缓存。
4. Q：Apple Silicon 上镜像报 exec format error？ A：ARM 节点跑 amd64 镜像。方案：镜像构建 multi-arch（docker buildx --platform linux/arm64），或 QEMU 模拟（慢，仅应急）。

8、总结

minikube 是 K8s 学习曲线上的"训练轮"：功能完整、代价低、坏了就重装。正确姿势是把它当一次性实验场——manifest 进 Git、集群随手重建、复杂场景逐步迁移到 Kind/云上。配合第 5 篇（原理）、第 11 篇（手工搭建）、第 19 篇（k9s 操作）、第 21 篇（K3s 生产化），从入门到生产的路径就此闭环。

9、参考资料

• 官方文档：https://minikube.sigs.k8s.io/docs/
• GitHub：https://github.com/kubernetes/minikube
• addons 列表：https://minikube.sigs.k8s.io/docs/handbook/addons/
• 本系列第 5、11、19、21 篇