kubeadm init卡在wait-control-plane或节点NotReady,90%因环境未清理、cgroup驱动不一致、--pod-network-cidr与网络插件不匹配;需彻底关闭swap、关闭防火墙、规范主机名、统一cgroup驱动(systemd)、正确配置containerd及匹配CNI网段。

直接上结论:用 kubeadm 是当前 Linux 下最可控、最可复现的路径,但不是“装完就能跑”,卡在 kubeadm init 或节点 NotReady 的根本原因,90% 出在环境没清干净、cgroup 驱动不一致、--pod-network-cidr 和网络插件不匹配这三处。
为什么 kubeadm init 一直卡在 wait-control-plane
这不是命令慢,是 kubelet 根本没起来,控制平面静态 Pod(如 kube-apiserver)压根没被调度。常见真实原因:
-
swap没彻底关:仅sudo swapoff -a不够,必须注释掉/etc/fstab中所有含swap的行,否则重启后自动启用,kubelet 启动时静默失败 - 防火墙开着:
firewalld或ufw默认拦截 6443、10250、2379 等端口,导致 etcd 和 apiserver 无法通信 - 主机名非法:含下划线(
k8s_master)、大写字母(K8S-MASTER)或点号开头,kubeadm 会拒绝生成证书 - cgroup 驱动错位:containerd 或 Docker 配置了
cgroupfs,但 kubelet 要求systemd;检查/var/lib/kubelet/config.yaml中cgroupDriver: systemd是否存在,且/etc/containerd/config.toml中SystemdCgroup = true已生效
containerd 配置必须改的两处
从 kubeadm v1.24 开始,Docker 不再被直接支持,containerd 是默认推荐运行时。但装完不能直接用,必须手动调两处:
- 生成配置后必须改驱动:
sudo containerd config default | sudo tee /etc/containerd/config.toml,然后编辑该文件,把SystemdCgroup = false改成SystemdCgroup = true - 确保
kubelet启动时能连上 socket:kubeadm init必须显式指定--cri-socket=unix:///run/containerd/containerd.sock,否则它会默认找/var/run/dockershim.sock(已废弃) - 别跳过重启:
sudo systemctl restart containerd && sudo systemctl enable containerd,否则旧配置仍在内存中
Calico 和 Flannel 的 pod-network-cidr 怎么选
这个参数不是随便填的,它决定了整个集群 Pod 网络地址段,且必须和 CNI 插件 YAML 里定义的完全一致,否则 Node 会卡在 NotReady,日志里反复出现 CNI plugin not found 或 Failed to create pod sandbox。
- Flannel 默认认
10.244.0.0/16:部署时用kubeadm init --pod-network-cidr=10.244.0.0/16,再kubectl apply -f https://github.com/flannel-io/flannel/releases/download/v0.24.0/kube-flannel.yml - Calico 默认认
192.168.0.0/16:如果 init 时用了--pod-network-cidr=10.244.0.0/16,就必须改 Calico YAML 里的IP_POOL_CIDR字段,否则所有 Pod 处于Pending - 别混用:Flannel 不支持 NetworkPolicy,Calico 支持但更重;若只是本地验证,Flannel 更轻量;若后续要对接云厂商 VPC 或需策略控制,优先 Calico
kubectl 连不上或报 certificate expired 怎么办
初始化成功后提示的三行配置命令(mkdir -p $HOME/.kube 那段)必须立刻执行,且不能漏掉 sudo chown。否则 kubectl 默认读 $HOME/.kube/config,而该文件权限不对或路径错误就会报 localhost:8080 was refused 或 x509: certificate has expired。
- 检查当前配置来源:
echo $KUBECONFIG,非空时可能指向了错误路径 - 验证证书是否过期:
openssl x509 -in /etc/kubernetes/pki/apiserver.crt -noout -dates,kubeadm 默认证书只有一年有效期 - 续期命令不是重装:
kubeadm certs renew all && sudo systemctl restart kubelet,然后重新分发admin.conf - 工作节点 join 后仍
NotReady?先ssh进去查sudo journalctl -u kubelet -n 100 --no-pager,看是不是 CNI socket 路径不对或镜像拉取失败
真正容易被忽略的是:所有节点的 kubelet、kubeadm、kubectl 必须小版本号完全一致(比如都是 v1.28.12),差一个 patch 版本都可能导致 control plane 不可用或 join 拒绝——这不是警告,是实际发生的故障。


















