怎样在Debian搭建K8s

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

kubeadm（官方推荐，适合生产/学习）
二进制部署（复杂，仅用于深入理解）

下面我以 kubeadm 方式，给你一份从零到可用集群的实战步骤（Debian 11/12 通用）。

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

1️⃣ 系统要求

Debian 11 (Bullseye) 或 12 (Bookworm)
2 核 CPU / 4G 内存以上（Master 建议更高）
静态 IP
关闭 swap
保证节点之间网络互通

2️⃣ 关闭 swap

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

3️⃣ 设置主机名和 hosts（示例）

hostnamectl set-hostname master

编辑 /etc/hosts：

192.168.1.10 master
192.168.1.11 node1
192.168.1.12 node2

4️⃣ 加载内核模块

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，推荐）

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

修改：

[plugins."io.containerd.grpc.v1.cri"]
  sandbox_image = "registry.k8s.io/pause:3.9"

启用 systemd cgroup：

sudo sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml

重启：

sudo systemctl restart containerd
sudo systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

1️⃣ 添加 Kubernetes 官方源

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 \
  --apiserver-advertise-address=192.168.1.10

成功后会输出类似：

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 输出的 join 命令：

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

七、验证集群

kubectl get nodes
kubectl get pods -A

八、常见问题

❌ coredns pending

网络插件未安装
pod cidr 不匹配

❌ kubeadm init 失败

swap 未关闭
iptables 异常
containerd 未启动

九、可选增强

安装 Dashboard
配置 Ingress（nginx）
使用 Helm
改为 containerd + Calico

如果你愿意，我可以： ✅ 给你 一键脚本
✅ 帮你 排查报错
✅ 教你 生产级 K8s 架构
✅ 指导 Debian + K8s + GPU / 高可用

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