kubeadm init卡住主因是kubelet未启动或control-plane不可达，根源在于6处配置不一致：containerd的SystemdCgroup必须为true、kubelet.service需显式含--kubeconfig等参数、config.yaml中cgroupDriver须与containerd对齐、swap须彻底禁用、br_netfilter需加载、hostname须合法唯一。
kubeadm init 卡住不是网络慢，而是 kubelet 根本没起来或连不上 control-plane —— 6 处配置不一致，卡死就成定局。
containerd 的 SystemdCgroup 必须设为 true
从 k8s v1.24 起，kubelet 强制要求 cgroup 驱动为 systemd，而 containerd 默认配置里 SystemdCgroup = false。这会导致 kubelet 启动后无法正确挂载 cgroup，直接 crash 或静默失败。
- 检查：
sudo cat /etc/containerd/config.toml | grep SystemdCgroup，若输出SystemdCgroup = false就必须改 - 修复：运行
sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml，再sudo systemctl restart containerd - 验证：
sudo ctr info | grep runtime应显示systemd相关字样；否则说明配置未生效或 containerd 没重载
kubelet 启动参数不能靠“默认”
很多人以为 kubeadm init 会自动注入所有参数，其实它只生成 /etc/systemd/system/kubelet.service.d/10-kubeadm.conf，而主 service 文件 /etc/systemd/system/kubelet.service 若被手动修改过、或系统自带模板残留，就可能丢掉关键参数，比如 --kubeconfig 和 --pod-manifest-path。
- 现象：
ps aux | grep kubelet输出里没有--kubeconfig /etc/kubernetes/kubelet.conf，说明凭证根本没加载 - 必须显式补全：编辑
/etc/systemd/system/kubelet.service，在ExecStart=行末尾追加--kubeconfig=/etc/kubernetes/kubelet.conf --pod-manifest-path=/etc/kubernetes/manifests - 然后执行：
sudo systemctl daemon-reload && sudo systemctl restart kubelet，再sudo systemctl status kubelet看是否 “active (running)”
cgroupDriver 在 config.yaml 和运行时必须对齐
即使 containerd 设了 SystemdCgroup = true，如果 /var/lib/kubelet/config.yaml 里还写着 cgroupDriver: cgroupfs，kubelet 启动时会直接报错退出（日志里搜 cgroup 就能看到冲突）。
- 查当前值：
sudo grep cgroupDriver /var/lib/kubelet/config.yaml - 统一改成：
cgroupDriver: systemd（注意缩进，YAML 对空格敏感） - 别忘了重启：
sudo systemctl restart kubelet；否则改了等于没改 - 额外提醒：如果你用 cri-dockerd，dockerd 本身也得配
{"exec-opts": ["native.cgroupdriver=systemd"]}，否则和 kubelet 再次打架
swap、br_netfilter、hostname 这三样必须“彻底”清零
教程常写“关闭 swap”，但只跑 swapoff -a 是临时的；/etc/fstab 里留着 swap 行，重启后又回来，kubeadm 会直接拒绝初始化。同理，br_netfilter 模块没加载、net.bridge.bridge-nf-call-iptables 没设为 1，后续网络插件（如 Calico）根本起不来，control-plane Pod 会卡在 Pending。
- swap：确认
cat /etc/fstab | grep swap输出为空；否则用sudo sed -i '/ swap / s/^/#/' /etc/fstab注释掉整行 - br_netfilter：
sudo modprobe br_netfilter && echo 'br_netfilter' | sudo tee /etc/modules-load.d/k8s.conf - sysctl：
echo 'net.bridge.bridge-nf-call-iptables = 1' | sudo tee /etc/sysctl.d/k8s.conf && sudo sysctl --system - hostname：克隆虚拟机后务必改
/etc/hostname+/etc/hosts，并确保sudo cat /sys/class/dmi/id/product_uuid全节点唯一（重复会导致 etcd 初始化失败）
最易被忽略的是：这些配置项之间存在强依赖链——containerd 配错 → kubelet 启动失败 → config.yaml 不被读取 → cgroupDriver 看似改了实则无效。卡住不是某一步错了，而是整条链断了一环。动手前先跑一遍那 6 个文件清单（/etc/containerd/config.toml、/etc/systemd/system/kubelet.service、/var/lib/kubelet/config.yaml 等），比反复 kubeadm reset 重试高效得多。
