minikube在linux上安装后需满足容器运行时、禁用swap、加载内核模块、配置镜像源等前置条件，启动时必须指定--driver=docker和--image-mirror-country=cn，否则易卡在镜像拉取或kubelet启动失败；验证以minikube kubectl -- get nodes显示ready为准。
Minikube 在 Linux 上能直接跑起来，但默认配置经常卡在镜像拉取、网络不通或权限报错上。核心问题不是“装不装得上”，而是“装完能不能立刻 kubectl get nodes 出 Ready”。
确认容器运行时和系统前置条件
Minikube 不是独立运行的，它依赖宿主机的容器运行时（docker 或 containerd）和内核模块。跳过这步，minikube start 会卡在 “Waiting for control plane” 或直接报 Failed to validate driver。
- 必须关闭 swap：
sudo swapoff -a，并注释/etc/fstab中含swap的行，否则 kubelet 启动失败 - 确保
docker已启用且当前用户在docker组：运行docker ps不报permission denied - 加载必要内核模块：
sudo modprobe br_netfilter && sudo sysctl -w net.bridge.bridge-nf-call-iptables=1，否则 Calico/CNI 插件无法初始化 - 国内环境建议提前配置镜像源，避免卡在
Pulling images required by Kubernetes v1.x.x...
下载安装与启动时的关键参数
二进制安装最稳，但 --driver 和 --image-mirror-country 这两个参数漏掉一个，就可能白等十分钟。
- 下载命令要带
-L（跟随重定向），否则拿到的是 HTML 页面：curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64 - 启动时必须显式指定驱动：
minikube start --driver=docker（即使已装 Docker，默认也不自动选） - 国内用户务必加
--image-mirror-country=cn，否则所有 Kubernetes 系统镜像（如k8s.gcr.io/kube-apiserver）全部超时 - 如果后续要暴露服务到宿主机（比如用
minikube service访问 NodePort），建议加--listen-address=0.0.0.0，否则默认只监听虚拟网卡地址
验证集群状态和调试常见失败点
minikube status 显示 “Running” 不代表 Kubernetes 就绪；真正要看的是 minikube kubectl -- get nodes 是否输出 Ready。很多失败其实发生在 kubelet 启动后、CNI 插件加载前。
- 若
get nodes卡住或报The connection to the server 192.168.49.2:8443 was refused：说明 apiserver 没起来，检查minikube logs | grep -i "failed\|error" - 若节点状态为
NotReady，大概率是 CNI 未就绪：运行minikube kubectl -- get pods -A | grep -v Running，重点关注calico-node或cni相关 Pod - 执行
minikube ssh进入虚拟机，手动运行sudo systemctl status kubelet，看是否因 cgroup driver 不一致（systemdvscgroupfs）崩溃 - 临时绕过镜像问题：用
--iso-url指向国内镜像 ISO（如阿里云源），但需注意版本匹配，否则 init phase 报错
日常使用中容易被忽略的权限和别名设置
每次敲 minikube kubectl -- 不仅费事，还容易漏掉双横线导致命令静默失败。更麻烦的是，kubectl 默认找不到 ~/.kube/config，尤其当你用非 root 用户启动 Minikube 时。
- 配置 kubectl 别名最安全的方式是写进 shell 配置：
echo 'alias kubectl="minikube kubectl --"' >> ~/.bashrc && source ~/.bashrc - 不要手动复制
/etc/kubernetes/admin.conf—— Minikube 自己管理 config，直接运行minikube update-context即可同步上下文 - 如果用
minikube dashboard打不开页面，先确认是否启用了插件：minikube addons enable dashboard，再运行命令（旧版本默认不启用） - 删除集群前记得
minikube stop，否则minikube delete可能残留/root/.minikube下的锁文件，导致下次start报 “machine does not exist”
真正卡住人的从来不是“怎么装”，而是 minikube start 成功返回后，kubectl get nodes 依然没反应——这时候得进虚拟机看 kubelet 日志，而不是重装 Minikube。
