Debian部署K8s要啥配置

在 Debian 上部署 Kubernetes（K8s）的配置要求，取决于你是单节点测试还是生产集群。下面按最低 / 推荐 / 生产三个层次给你一个清晰清单，并顺带说明 Debian 的注意事项。

一、硬件配置要求

1️⃣ 单节点（学习 / 测试 / kubeadm）

适合：学习、开发、测试环境
方式：kubeadm + 单 Master（可带 worker）

✅ 可跑：

• kubeadm
• 少量 Pod
• 不跑大规模业务

2️⃣ 多节点（标准集群）

适合：生产或接近生产环境

Master 节点（控制平面）

Worker 节点

✅ 建议：

• 至少 3 个 Master（高可用）
• Worker 数量按业务扩容

二、软件 & 系统要求（Debian 重点）

✅ 支持的 Debian 版本

• Debian 11 (Bullseye) ✅ 稳定
• Debian 12 (Bookworm) ✅ 推荐
• 不建议用太老版本（如 Debian 10）

✅ 内核要求

• Kernel ≥ 4.19
• 推荐开启：
  • overlay
  • br_netfilter

uname -r

✅ 系统基础配置（必须）

1️⃣ 禁用 swap（K8s 强制）

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

2️⃣ 内核模块

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

modprobe overlay
modprobe br_netfilter

3️⃣ 网络参数

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（官方推荐）

apt install -y containerd

配置：

containerd config default > /etc/containerd/config.toml
sed -i 's/SystemdCgroup = false/SystemdCgroup = true/' /etc/containerd/config.toml
systemctl restart containerd

✅ Docker（不推荐新集群）

Kubernetes 已弃用 dockershim

四、K8s 组件版本建议

五、网络插件（必选）

常见选择：

Calico 示例：

kubectl apply -f https://docs.projectcalico.org/manifests/calico.yaml

六、最小可跑示例（Debian 单节点）

# 1. 禁用 swap
# 2. 安装 containerd
# 3. 安装 kubeadm kubelet kubectl
# 4. 初始化
kubeadm init --pod-network-cidr=10.244.0.0/16

# 5. 配置 kubectl
mkdir -p $HOME/.kube
cp /etc/kubernetes/admin.conf $HOME/.kube/config

# 6. 安装网络插件
kubectl apply -f calico.yaml

七、生产环境额外建议

• ✅ 使用 静态 IP
• ✅ 内网 DNS / hosts
• ✅ 防火墙放行：
  • 6443
  • 10250
  • Calico / Flannel 端口
• ✅ 时间同步（NTP）
• ✅ 高可用 etcd（3 节点）

八、总结一句话

Debian 部署 K8s 推荐：Debian 12 + containerd + kubeadm + Calico，Master 8G 内存起步，Worker 按业务扩容。

如果你愿意，我可以：

• ✅ 帮你写 完整 Debian + kubeadm 一键脚本
• ✅ 帮你设计 生产级 K8s 架构图
• ✅ 告诉你 哪些 Debian 包最容易踩坑

你现在是 学习 / 测试 / 生产 哪种场景？