Debian怎么安装K8s

在 Debian 上安装 Kubernetes（K8s）通常有两种主流方式：

kubeadm（官方推荐，最常用）
二进制手动安装（复杂，适合深入理解）

下面我以 Debian 11 / 12 为例，给你一套 生产可用、最标准的 kubeadm 安装流程。

一、环境准备

1️⃣ 系统要求

Debian 11（Bullseye）或 Debian 12（Bookworm）
2 核 CPU / 2GB 内存以上
禁用 swap
唯一 hostname、MAC、product_uuid

2️⃣ 关闭 swap（必须）

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

3️⃣ 设置主机名（每个节点唯一）

sudo hostnamectl set-hostname master

4️⃣ 配置内核参数（k8s 需要）

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

sudo modprobe overlay
sudo modprobe br_netfilter

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）

K8s 已弃用 Docker，推荐使用 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 nano /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.28 / v1.30 替换 v1.29

2️⃣ 安装

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

四、初始化 Kubernetes 集群（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 节点执行：

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

七、验证集群

kubectl get nodes
kubectl get pods -A

八、常见问题

❓ kubeadm init 卡住

检查 swap 是否关闭
检查 containerd 是否运行
检查端口 6443 / 10250

❓ coredns pending

没装 CNI（网络插件）

九、可选增强

安装 Helm
使用 Calico / Cilium 替代 Flannel
安装 Dashboard
配置 Ingress

如果你愿意，我可以： ✅ 给你 Debian + K8s 一键脚本
✅ 帮你 排查安装报错
✅ 教你 本地单节点 / 多节点 / 生产级部署

你现在是在 物理机 / 虚拟机 / 云服务器 / WSL 上装？