为什么Debian k8s装失败

Debian 上 Kubernetes（k8s）安装失败的原因非常多，通常在环境准备、系统配置、网络/源、组件兼容性这几个方面踩坑。下面按最常见原因 → 排查方法给你梳理一下。

一、最常见失败原因（90% 在这里）

1️⃣ 系统不满足 k8s 要求

Kubernetes 官方要求：

Debian 版本：推荐 Debian 11/12
内核：≥ 3.10（实际建议 ≥ 5.x）
CPU / 内存：至少 2C2G（master）
不能是双网卡或 hostname 冲突

✅ 检查：

cat /etc/os-release
uname -a
free -h

2️⃣ swap 没关（必失败）

kubelet 默认不允许 swap 开启

swapoff -a
sed -i '/swap/d' /etc/fstab

检查：

free -h

3️⃣ 防火墙 / iptables 问题

Debian 默认可能开了 nftables 或 ufw

✅ 推荐：

systemctl stop ufw
systemctl disable ufw

或放行端口：

6443
10250
2379-2380
30000-32767

4️⃣ 时间不同步（证书直接失败）

timedatectl

✅ 安装：

apt install -y chrony
systemctl enable --now chrony

5️⃣ 容器运行时没装对（非常常见）

K8s 现在 不再支持 docker 直接驱动

✅ 正确方式：

containerd（推荐）
或 CRI-O

检查：

systemctl status containerd

安装 containerd：

apt install -y containerd
containerd config default > /etc/containerd/config.toml
systemctl restart containerd

⚠️ 注意：

必须配置 SystemdCgroup = true

6️⃣ apt 源或 GPG 错误

很多人卡在：

NO_PUBKEY
404 Not Found

✅ 正确 k8s 源：

curl -fsSL https://pkgs.k8s.io/core/stable/v1.29/deb/Release.key | gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg

echo "deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core/stable/v1.29/deb/ /" > /etc/apt/sources.list.d/kubernetes.list

二、初始化失败（kubeadm init）

7️⃣ kubeadm init 报错

常见错误：

preflight errors
port 6443 is in use
cgroup driver mismatch

✅ 常用排错：

kubeadm init --v=5
journalctl -xeu kubelet

8️⃣ 网络插件没装（node 一直 NotReady）

装完 master 后 必须装 CNI

三、国内环境专属问题

9️⃣ 镜像拉不下来

ImagePullBackOff

✅ 解决：

使用国内镜像源
或手动 docker pull / ctr pull

四、最快定位方法（贴错误给我）

如果你愿意，可以把具体报错贴出来，例如：

kubeadm init 输出
journalctl -u kubelet
卡在哪一步

我可以直接告诉你 是哪一条配置错了。

五、如果你愿意，我可以：

✅ 给你一份 Debian 12 + containerd + kubeadm 一步到位脚本
✅ 或帮你判断 该用 kubeadm / k3s / microk8s

你现在是：

单节点？
多节点？
云服务器还是虚拟机？

告诉我，我直接按你的环境给你方案。