Debian安装K8s需要啥

在 Debian 上安装 Kubernetes（K8s），通常分为 准备系统 → 安装容器运行时 → 安装 K8s 组件 → 初始化集群 几个阶段。下面给你一个通用、稳定、生产可用的方案（基于 Debian 11/12 + kubeadm）。

一、系统要求（必须满足）

1️⃣ 硬件最低要求

生产环境建议 Master ≥ 2C4G

2️⃣ 系统准备

# 查看 Debian 版本
cat /etc/debian_version

✅ 推荐：

• Debian 11 (Bullseye)
• Debian 12 (Bookworm)

二、基础环境配置（所有节点）

1️⃣ 关闭 swap（必须）

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

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

sudo hostnamectl set-hostname master

3️⃣ 配置 hosts（可选但推荐）

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

4️⃣ 加载内核模块

sudo modprobe overlay
sudo modprobe br_netfilter

开机自动加载：

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

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️⃣ 安装 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

四、安装 Kubernetes（kubeadm）

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

2️⃣ 安装 kubeadm / kubelet / kubectl

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

五、初始化 Kubernetes 集群（Master 节点）

1️⃣ 初始化

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

2️⃣ 配置 kubectl

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

六、安装网络插件（CNI）

推荐：Flannel

kubectl apply -f https://raw.githubusercontent.com/flannel-io/flannel/master/Documentation/kube-flannel.yml

七、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

九、常见坑（Debian 特有）

✅ iptables 模式

update-alternatives --set iptables /usr/sbin/iptables-legacy
update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy

✅ 时间同步

sudo apt install -y chrony
sudo systemctl enable chrony

十、总结一句话

Debian 安装 K8s = 关 swap + containerd + kubeadm + CNI

如果你愿意，我可以：

• ✅ 给你 一键脚本
• ✅ 帮你选 单节点 / 高可用
• ✅ 教你 本地 / 云服务器 区别
• ✅ 给你 生产级建议

你现在用的是 物理机 / 虚拟机 / 云服务器？