Debian部署K8s需啥配置

在 Debian 上部署 Kubernetes（K8s），通常分为 系统要求、软件配置、网络与安全 三部分。下面以 生产可用、使用 kubeadm 为例说明（Debian 11/12 通用）。

一、硬件与系统基础配置

1. 节点规划（最小建议）

节点类型	数量	配置
Master（控制平面）	1~3	2C4G 起（生产建议 4C8G）
Worker（工作节点）	≥2	2C4G 起

学习环境可 1 Master + 1 Worker

2. 系统版本

Debian 11 (Bullseye) / Debian 12 (Bookworm)
内核 ≥ 5.x（推荐）
64 位系统

3. 基础系统设置

# 禁用 swap
swapoff -a
sed -i '/swap/s/^/#/' /etc/fstab

# 设置主机名
hostnamectl set-hostname master01

# 配置 hosts
cat >> /etc/hosts <<EOF
192.168.1.10 master01
192.168.1.11 node01
EOF

二、内核与系统参数

1. 加载内核模块

cat > /etc/modules-load.d/k8s.conf <<EOF
br_netfilter
EOF

modprobe br_netfilter

2. 网络参数

cat > /etc/sysctl.d/k8s.conf <<EOF
net.bridge.bridge-nf-call-iptables  = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.ip_forward                 = 1
EOF

sysctl --system

三、容器运行时（必须）

K8s 1.24+ 不再内置 Docker，需安装容器运行时：

推荐：containerd

apt update
apt install -y containerd

# 生成默认配置
mkdir -p /etc/containerd
containerd config default > /etc/containerd/config.toml

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

systemctl restart containerd
systemctl enable containerd

四、安装 Kubernetes 组件

1. 添加 K8s 源

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

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/ /" > /etc/apt/sources.list.d/kubernetes.list

apt update

2. 安装 kubeadm / kubelet / kubectl

apt install -y kubelet kubeadm kubectl
systemctl enable kubelet

五、初始化集群（Master）

kubeadm init \
  --pod-network-cidr=10.244.0.0/16 \
  --kubernetes-version=v1.29.0

初始化完成后：

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

六、网络插件（必装）

Flannel（最简）

kubectl apply -f https://github.com/flannel-io/flannel/releases/latest/download/kube-flannel.yml

或 Calico（生产推荐）

七、Worker 节点加入

在 Master 初始化后复制：

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

八、生产部署额外建议

防火墙：开放 6443 / 10250 等端口
时间同步（NTP）
高可用：多 Master + HAProxy / Keepalived
存储：部署 CSI（如 Rook / NFS）
监控：Prometheus + Grafana

如果你愿意，我可以：

给你 一键部署脚本
区分 学习 / 生产环境
指定 Debian 版本 + K8s 版本

你现在是打算 学习测试 还是 生产部署？