debian部署k8s报错怎么解

在 Debian 上部署 Kubernetes 时常见的报错有很多，需要先看具体报错信息才能精准定位。不过我可以先把最常见的几类问题 + 对应解决方案给你列出来，你对照看看，或者直接把报错贴出来我帮你分析。

一、常见基础环境问题（最常见）

1️⃣ swap 未关闭

报错示例

[ERROR Swap]: running with swap on is not supported

✅ 解决：

sudo swapoff -a
sudo sed -i '/ swap / s/^/#/' /etc/fstab

2️⃣ 防火墙 / 端口不通

报错示例

dial tcp 10.96.0.1:443: connect: no route to host

✅ 解决（测试环境可直接关）：

sudo ufw disable

或放行端口：

• 6443
• 10250
• 2379-2380
• 10250、10251、10252

3️⃣ 内核参数 / 桥接未开启

报错示例

[ERROR FileContent--proc-sys-net-bridge-bridge-nf-call-iptables]: 1

✅ 解决：

cat <<EOF | sudo tee /etc/modules-load.d/k8s.conf
br_netfilter
EOF

cat <<EOF | sudo tee /etc/sysctl.d/k8s.conf
net.bridge.bridge-nf-call-iptables  = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.ip_forward                 = 1
EOF

sudo sysctl --system

二、containerd / Docker 问题

4️⃣ containerd 未配置 cgroup

报错示例

failed to create kubelet: misconfiguration: kubelet cgroup driver

✅ 解决（containerd）：

sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml

# 修改
SystemdCgroup = true

sudo systemctl restart containerd

5️⃣ crictl 或镜像拉不到

报错示例

failed to pull image "k8s.gcr.io/pause:3.9"

✅ 解决（国内环境）：

kubeadm init \
  --image-repository registry.aliyuncs.com/google_containers

三、kubeadm init 常见失败

6️⃣ CPU / 内存不足

报错

[ERROR NumCPU]: the number of available CPUs is less than 2

✅ 至少：

• Master：2C2G
• Node：1C1G+

7️⃣ kubeadm 版本不一致

✅ 检查：

kubeadm version
kubelet --version
kubectl version

必须 大版本一致

四、节点 NotReady

kubectl get nodes
# STATUS: NotReady

✅ 常见原因：

• 网络插件没装（Flannel / Calico）

kubectl apply -f https://docs.projectcalico.org/manifests/calico.yaml

五、你可以直接这样给我信息（最快）

请把以下信息贴出来：

1. Debian 版本
2. k8s 版本
3. 容器运行时（Docker / containerd）
4. 完整报错日志
5. 到哪一步失败（init / join / NotReady）

我可以直接帮你 一步一步排错。