直接用 minikube 可在 5 分钟内使 kubectl get nodes 输出 ready，因其封装了 etcd、coredns 等组件并完全隔离运行；而 kubeadm 单节点需手动处理 swap、sysctl、cni 等多项配置，易因任一环节出错导致 pod 卡在 pending 或 crashloopbackoff。
直接用 minikube，5 分钟内跑通 kubectl get nodes 输出 Ready —— 其他方式在单节点实验场景下纯属增加复杂度。
为什么不用 kubeadm 初始化单节点？
它确实更“标准”，但代价是：必须手动禁用 swap、反复调试 sysctl 参数、选对 containerd 或 cri-dockerd 版本、处理镜像拉取失败、再配 CNI 插件才能让 coredns 启动。哪怕只错一个 systemd 服务状态或 CIDR 冲突，kubectl get pods -A 就会卡在 Pending 或 ContainerCreating。
而 minikube 把这些全封装进一个二进制里，连 etcd、coredns、metrics-server 都预装好，启动即用。
- 不碰宿主机内核参数，不改
/etc/fstab - 不启停
docker或containerd服务，只用它当驱动 - 所有 Kubernetes 组件运行在独立容器中，和宿主机完全隔离
- 支持
minikube dashboard直接开 Web 控制台，不用额外装kubernetes-dashboard
minikube start --driver=docker 必须加的三个参数
只执行 minikube start 很容易因资源不足或默认驱动失败而卡住。实际验证有效的最小集是：
-
--driver=docker：强制使用 Docker 作为底层运行时（不是podman或none），避免 VirtualBox 依赖和权限问题 -
--cpus=2：Ubuntu 24.04 下低于 2 核会导致kube-apiserver启动超时 -
--memory=4096：低于 3.5GB 时coredns常因 OOM 被 kill，kubectl get pods -A显示CrashLoopBackOff
完整命令：
minikube start --driver=docker --cpus=2 --memory=4096
首次运行会拉取 gcr.io/k8s-minikube/kicbase 镜像（国内可提前用 docker pull registry.cn-hangzhou.aliyuncs.com/google_containers/kicbase:v0.0.43 加速）。
kubectl 连不上 minikube 的真实原因
错误现象：The connection to the server 127.0.0.1:8443 was refused 或 Unable to connect to the server: EOF。
这不是证书或配置问题，而是 minikube 没真正跑起来。先确认状态：
minikube status
如果输出含 host: Stopped 或 apiserver: Stopped，说明启动失败。此时别急着查 kubeconfig，直接看日志：
minikube logs | tail -30
高频原因只有两个：
- Docker 服务没运行：
sudo systemctl is-active docker返回inactive→ 执行sudo systemctl start docker - 用户没加入
docker组：id -nG不含docker→ 执行sudo usermod -aG docker $USER并重新登录终端
只要 minikube status 显示全部 Running，kubectl 就能自动读到正确上下文，无需手动复制 admin.conf。
后续验证和清理要留心的点
minikube 启动后，kubectl get nodes 和 kubectl get pods -A 都应返回正常状态。但注意：
-
minikube默认不启用Ingress控制器，需要minikube addons enable ingress才能跑Ingress资源 -
minikube的Service类型为NodePort时，端口映射走的是minikube ip，不是localhost；访问前务必执行minikube service <service-name></service-name>自动打开浏览器 - 彻底清理不要只删
.minikube目录，得运行minikube delete --purge，否则残留的 Docker 容器可能占用端口导致下次启动失败
真正麻烦的从来不是“怎么装”，而是“装完之后发现 Pod 起不来却不知道从哪查”。minikube 把这个路径压到了最短——只要 docker 活着，它就大概率活着。
