Debian安装K8s需要啥配置

在 Debian 上安装 Kubernetes（K8s）时，配置要求取决于你是要单节点测试还是生产集群。下面我按最常见、最稳妥的方式给你一份完整配置清单，适用于 Debian 11 / 12。

一、最低硬件配置（官方建议）

1️⃣ Master（控制平面）节点

2️⃣ Worker（工作）节点

✅ 学习 / 测试：1 台 2C4G 即可
✅ 生产：至少 3 Master + 3 Worker

二、系统要求（非常重要）

✅ 操作系统

• Debian 11（Bullseye）
• Debian 12（Bookworm）✅ 推荐

✅ 内核

uname -r

建议：

• 4.19 或以上
• 开启 overlay / br_netfilter

三、必需的系统配置（必须做）

1️⃣ 禁用 swap（K8s 强制要求）

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

2️⃣ 设置主机名 & hosts

hostnamectl set-hostname master

cat <<EOF >> /etc/hosts
192.168.1.10 master
192.168.1.11 node1
EOF

3️⃣ 加载内核模块

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

modprobe overlay
modprobe br_netfilter

4️⃣ 设置 sysctl（网络参数）

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

sysctl --system

四、容器运行时（二选一）

✅ 推荐：containerd（官方默认）

安装 containerd

apt update
apt install -y containerd

生成默认配置

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

启用 Systemd Cgroup

修改：

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

systemctl restart containerd
systemctl enable containerd

五、安装 Kubernetes 组件

1️⃣ 添加 Kubernetes APT 源

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

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

2️⃣ 安装 kubeadm / kubelet / kubectl

apt update
apt install -y kubelet kubeadm kubectl
apt-mark hold kubelet kubeadm kubectl

六、初始化集群（Master 节点）

kubeadm init \
  --pod-network-cidr=10.244.0.0/16

初始化成功后：

mkdir -p $HOME/.kube
cp /etc/kubernetes/admin.conf $HOME/.kube/config

七、安装网络插件（必须）

✅ Flannel（最简单）

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

八、Worker 节点加入集群

在 master 上执行：

kubeadm token create --print-join-command

然后在 worker 节点执行输出内容。

九、常见 Debian 问题

❗ 防火墙

ufw disable

❗ IPv6（有问题可临时关）

sysctl -w net.ipv6.conf.all.disable_ipv6=1

十、总结一句话

Debian 安装 K8s 最稳妥配置：

• Debian 11/12
• 2C2G+
• containerd
• 禁用 swap
• 正确 sysctl
• Flannel 网络

如果你愿意，我可以： ✅ 给你 一条一条命令的完整脚本 ✅ 帮你 排查 kubeadm init 报错 ✅ 教你 Debian + k3s / microk8s 轻量方案

直接告诉我你的用途（学习 / 生产 / 虚拟机 / 云服务器）即可。