如何快速部署Debian k8s

在 Debian 上快速部署 Kubernetes（k8s），最推荐、最省事的方式是 使用 kubeadm + 官方源，适合生产/测试环境。
下面给你一套 从零到可用集群 的精简流程（单 master，可扩展 worker）。

一、环境准备（所有节点）

1️⃣ 系统要求

Debian 11 / 12（推荐 12）
2 CPU + 2GB 内存（最低）
禁用 swap
各节点网络互通

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

2️⃣ 设置主机名 & hosts（可选）

hostnamectl set-hostname master

cat <<EOF >> /etc/hosts
192.168.1.10 master
192.168.1.11 node1
EOF

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

1️⃣ 安装依赖

sudo apt update
sudo apt install -y curl gnupg2 software-properties-common

2️⃣ 安装 containerd

sudo apt install -y containerd

3️⃣ 生成默认配置

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

4️⃣ 启用 systemd cgroup

编辑：

sudo nano /etc/containerd/config.toml

修改：

[plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc]
  runtime_type = "io.containerd.runc.v2"
  [plugins."io.containerd.grpc.v1.cri".containerd.runtimes.runc.options]
    SystemdCgroup = true

重启：

sudo systemctl restart containerd
sudo systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

1️⃣ 添加 Kubernetes 官方源

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

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 /etc/kubernetes/admin.conf $HOME/.kube/config
sudo chown $(id -u):$(id -g) $HOME/.kube/config

五、安装网络插件（Flannel 最简单）

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

检查：

kubectl get nodes
kubectl get pods -A

六、加入 Worker 节点（可选）

在 worker 节点执行 master 输出的：

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

七、快速验证

kubectl run test --image=nginx
kubectl get pods -o wide

⚡ 更快的方式（可选）

方式	场景
k3s	单机 / 边缘 / 快速测试
kind	本地开发
minikube	学习

k3s（最快）

curl -sfL https://get.k3s.io | sh -

八、常见问题速查

# 查看节点
kubectl get nodes

# 查看组件
kubectl get pods -n kube-system

# 重置集群
sudo kubeadm reset

如果你愿意，我可以：

✅ 给你 一键脚本
✅ 部署 高可用 k8s
✅ 部署 k8s + ingress + dashboard
✅ 对比 kubeadm vs k3s vs k0s

你打算 学习 / 测试 / 生产 用？