Debian部署K8s报错怎么办

在 Debian 上部署 Kubernetes（k8s） 时，报错的原因很多，需要先定位阶段和具体错误信息。下面我按「常见阶段 + 典型报错 + 解决方案」给你一个排查速查表，你可以对照使用；如果还不行，把完整报错贴出来，我可以精准帮你分析。

一、先确认基础环境（90% 的问题在这里）

1️⃣ 系统版本

cat /etc/os-release

✅ 推荐：

Debian 11 (Bullseye)
Debian 12 (Bookworm)

2️⃣ 内核参数 & 模块

uname -r
lsmod | grep br_netfilter

如果没有：

modprobe br_netfilter
modprobe overlay

并写入开机加载：

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

3️⃣ 关闭 swap（必做）

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

否则 kubeadm init 必报错。

4️⃣ 防火墙 & SELinux

Debian 默认无 SELinux，但注意：

iptables -F
iptables -P INPUT ACCEPT
iptables -P FORWARD ACCEPT
iptables -P OUTPUT ACCEPT

或：

systemctl disable --now ufw

二、容器运行时报错（containerd / docker）

✅ 推荐：containerd

错误示例

failed to create containerd

解决

systemctl status containerd
journalctl -u containerd -xe

常见原因

没生成默认配置

mkdir -p /etc/containerd
containerd config default > /etc/containerd/config.toml

SystemdCgroup 没开

[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
  SystemdCgroup = true

然后：

systemctl restart containerd

三、kubeadm init 常见报错

❌ 报错 1：端口被占用

Port 10250 is in use

✅ 解决：

ss -lntp | grep 10250
kill -9 <pid>

❌ 报错 2：cgroup 驱动不一致

cgroup driver mismatch

✅ 解决（kubelet + containerd 一致）：

cat <<EOF > /etc/systemd/system/kubelet.service.d/20-extra-args.conf
[Service]
ExecStart=
ExecStart=/usr/bin/kubelet --cgroup-driver=systemd
EOF
systemctl daemon-reload
systemctl restart kubelet

❌ 报错 3：镜像拉取失败

failed to pull image

✅ 方案 1（国内）：

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

✅ 方案 2：手动拉镜像

crictl pull registry.aliyuncs.com/google_containers/pause:3.9

四、kubectl 报错

❌ 报错

The connection to the server localhost:8080 was refused

✅ 解决：

mkdir -p $HOME/.kube
cp /etc/kubernetes/admin.conf $HOME/.kube/config
chown $(id -u):$(id -g) $HOME/.kube/config

五、节点 NotReady

kubectl get nodes

检查：

kubectl describe node
journalctl -u kubelet

✅ 常见原因：

网络插件没装（Calico / Flannel）
CNI 配置错误

六、网络插件问题（最常见）

Calico 示例

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

Flannel

kubectl apply -f https://github.com/flannel-io/flannel/releases/latest/download/kube-flannel.yml

七、快速自检清单 ✅

✅ swapoff -a
✅ systemd 时间同步
✅ containerd 正常运行
✅ 内核模块加载
✅ 防火墙放行
✅ cgroup 驱动一致
✅ 网络插件已安装

八、我可以直接帮你定位（推荐）

请你直接贴出以下信息之一：

完整报错日志
执行到哪一步报错（kubeadm init / join / kubectl）
Debian 版本 + k8s 版本

例如：

Debian 12
kubeadm init 报错：
[ERROR Port-10250]: Port 10250 is in use

我可以一步一步带你修 ✅