如何在Debian部署K8s

以下是在 Debian 上部署 Kubernetes（k8s） 的通用生产级流程，以 kubeadm 方式为例（官方推荐、最常用）。
示例基于 Debian 11/12，适用于 单控制平面或高可用集群。

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

1. 系统要求

Debian 11（Bullseye）或 12（Bookworm）
2 CPU 及以上
2GB+ 内存
禁用 swap
各节点网络互通

2. 设置主机名与 hosts

hostnamectl set-hostname master
# 或 node1 / node2

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

3. 禁用 swap

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

4. 加载内核模块

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

modprobe overlay
modprobe br_netfilter

5. 内核参数

cat <<EOF | 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）

1. 安装 containerd

apt update
apt install -y containerd

2. 生成默认配置

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

3. 启用 systemd cgroup

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

4. 启动 containerd

systemctl restart containerd
systemctl enable containerd

三、安装 Kubernetes（kubeadm、kubelet、kubectl）

1. 添加 Kubernetes APT 源

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

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

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

2. 安装 k8s 组件

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

四、初始化控制平面（仅 master 节点）

1. 初始化集群

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

2. 配置 kubectl（master）

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

五、安装网络插件（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

六、添加 Worker 节点

在 worker 节点执行：

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

七、验证集群

1. 查看节点

kubectl get nodes

2. 查看组件状态

kubectl get pods -n kube-system

八、可选优化

1. 允许 master 运行 Pod

kubectl taint nodes --all node-role.kubernetes.io/control-plane-

2. 安装 Dashboard

kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml

九、常见问题

问题	解决
swap 未关闭	`swapoff -a`
cgroup 不一致	containerd 开启 systemd cgroup
节点 NotReady	CNI 未安装
token 过期	`kubeadm token create`

十、总结

✅ Debian 上部署 Kubernetes 推荐流程：

准备系统
安装 containerd
安装 kubeadm
kubeadm init
安装 CNI
加入 worker 节点

如果你需要：

高可用（HA）多 master
离线部署
生产安全加固
Debian + k3s / microk8s
指定版本（1.28 / 1.30）

可以直接告诉我你的 使用场景和节点数量。