如何安装debian上的k8s

下面给你一份**在 Debian 上安装 Kubernetes（k8s）**的实用指南，适用于 Debian 11 / 12，使用 containerd + kubeadm（官方推荐方案）。

一、环境准备

1. 节点规划（示例）

1 台 Master（控制平面）
若干 Worker（可选）

⚠️ 生产环境建议至少 3 个 Master（高可用）

2. 系统要求

Debian 11/12
2 CPU 以上
2GB 内存以上
关闭 swap
网络互通

二、系统初始化（所有节点）

1. 关闭 swap

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

2. 设置主机名

sudo hostnamectl set-hostname master
# worker 节点
sudo hostnamectl set-hostname node1

3. 配置 hosts（可选但推荐）

cat <<EOF | sudo tee -a /etc/hosts
192.168.1.10 master
192.168.1.11 node1
EOF

4. 加载内核模块

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

sudo modprobe overlay
sudo modprobe br_netfilter

5. 内核参数

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. 安装依赖

sudo apt update
sudo apt install -y ca-certificates curl gnupg

2. 安装 containerd

sudo apt install -y containerd

3. 生成配置

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

4. 修改 SystemdCgroup

编辑：

sudo nano /etc/containerd/config.toml

修改：

SystemdCgroup = true

5. 启动 containerd

sudo systemctl restart containerd
sudo systemctl enable containerd

四、安装 kubeadm / kubelet / kubectl

1. 添加 Kubernetes apt 源

sudo apt install -y apt-transport-https curl
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 等

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 -i /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
kubectl get pods -A

九、常见问题

❌ node 处于 NotReady

CNI 未安装
containerd 未设置 SystemdCgroup

❌ kubeadm 初始化失败

sudo kubeadm reset

十、可选进阶

高可用 Master（keepalived + haproxy）
使用 Cilium 替代 Flannel
安装 Helm
使用 k3s（轻量方案）

如果你愿意，可以告诉我：

是 单机学习 还是 生产环境
Debian 版本
是否用 root / 普通用户
是否要 离线安装

我可以直接给你定制命令清单。