K8s集群Debian怎部署

下面给你一个在 Debian 上部署 Kubernetes（K8s）集群的实操级教程，以 kubeadm + containerd 为例（目前最主流、官方推荐方案），适用于 Debian 11 / 12。

一、环境准备

1. 节点规划（示例）

角色	主机名	IP
Master	k8s-master	192.168.10.10
Worker	k8s-node1	192.168.10.11

建议：

2核4G 起步（Master）

关闭 swap

所有节点时间同步

2. 所有节点执行（Master + Node）

✅ 修改主机名

hostnamectl set-hostname k8s-master

✅ 配置 hosts

cat >> /etc/hosts <<EOF
192.168.10.10 k8s-master
192.168.10.11 k8s-node1
EOF

✅ 关闭 swap

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

✅ 内核参数

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

✅ 加载模块

modprobe br_netfilter

二、安装容器运行时（containerd）

apt update
apt install -y containerd

生成默认配置

mkdir -p /etc/containerd
containerd config default > /etc/containerd/config.toml

修改 SystemdCgroup

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

systemctl restart containerd
systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

添加 Kubernetes apt 源

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
apt install -y kubelet kubeadm kubectl
systemctl enable kubelet

四、初始化 Master 节点

kubeadm init \
  --apiserver-advertise-address=192.168.10.10 \
  --pod-network-cidr=10.244.0.0/16

初始化完成后，按提示执行：

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

五、安装网络插件（Calico）

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

等待：

kubectl get pods -n kube-system

六、Worker 节点加入集群

在 Master 初始化输出中会有类似：

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

在 Node 上执行即可。

七、验证集群

kubectl get nodes

状态应为 Ready

八、常见问题

❌ 节点 NotReady

网络插件未安装
containerd Cgroup 配置错误

❌ kubeadm init 失败

swap 未关闭
时间不同步

九、可选增强

安装 Helm
部署 Dashboard
使用 MetalLB / Ingress
高可用 Master（keepalived + haproxy）

如果你需要： ✅ Debian 12 专属
✅ 离线部署
✅ 生产级高可用
✅ 使用 Docker 而不是 containerd

告诉我你的具体需求，我可以给你定制方案。