下面是在 Debian（11/12）上安装 Kubernetes（k8s） 的通用、稳定步骤，适用于 kubeadm 方式（官方推荐）。

一、环境准备（所有节点）

1️⃣ 系统要求

Debian 11 (Bullseye) 或 Debian 12 (Bookworm)
2 CPU 及以上
内存 ≥ 2GB
禁用 swap
唯一 hostname、MAC、product_uuid

2️⃣ 设置主机名（每个节点）

sudo hostnamectl set-hostname master
# 或 node1 / node2

sudo vi /etc/hosts

示例：

192.168.1.10 master
192.168.1.11 node1
192.168.1.12 node2

3️⃣ 关闭 swap（必须）

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

4️⃣ 关闭防火墙（或放行端口）

sudo systemctl disable --now ufw

或放行 k8s 端口（生产环境建议）

5️⃣ 加载内核模块

sudo modprobe overlay
sudo modprobe br_netfilter

开机自动加载：

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

6️⃣ 设置 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

sudo sysctl --system

二、安装容器运行时（containerd）

1️⃣ 安装 containerd

sudo apt update
sudo apt install -y containerd

2️⃣ 生成默认配置

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

3️⃣ 启用 systemd cgroup

编辑：

sudo vi /etc/containerd/config.toml

找到：

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

改为：

SystemdCgroup = true

4️⃣ 重启 containerd

sudo systemctl restart containerd
sudo systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

1️⃣ 添加 Kubernetes APT 源

sudo apt install -y apt-transport-https ca-certificates curl gpg

curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.29/deb/Release.key | \
sudo 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/ /" | \
sudo tee /etc/apt/sources.list.d/kubernetes.list

✅ 可替换 v1.29 为你需要的版本

2️⃣ 安装

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

四、初始化 Master 节点

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

成功后会输出类似：

kubeadm join 192.168.1.10:6443 --token xxx --discovery-token-ca-cert-hash sha256:xxx

配置 kubectl

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

五、安装网络插件（CNI）

六、Worker 节点加入集群

在 worker 节点执行 master 输出的：

sudo kubeadm join 192.168.1.10:6443 \
  --token xxx \
  --discovery-token-ca-cert-hash sha256:xxx

七、验证集群

kubectl get nodes

输出示例：

NAME     STATUS   ROLES    AGE   VERSION
master   Ready    master   5m    v1.29.x
node1    Ready    <none>   2m    v1.29.x

八、常见问题

❌ swap 未关闭

sudo swapoff -a

❌ cgroup 不一致

containerd 必须启用 SystemdCgroup = true

❌ 节点 NotReady

kubectl describe node

九、总结流程

系统准备
 → 安装 containerd
 → 安装 kubeadm
 → kubeadm init
 → 安装 CNI
 → worker join

如果你需要：

✅ Debian + 单节点
✅ 生产级高可用
✅ 离线安装
✅ 指定版本（1.28 / 1.30）

告诉我你的使用场景，我可以直接给你定制方案。

Debian安装K8s步骤是啥