Debian K8s安装要注意啥

在 Debian 上部署 Kubernetes（K8s）时，有几个容易踩坑但非常关键的点。下面按「系统准备 → 容器运行时 → K8s 安装 → 网络与运维」给你梳理一份实用清单。

一、系统准备（非常重要）

1. 系统版本

推荐 Debian 11 (Bullseye) 或 Debian 12 (Bookworm)
内核建议 ≥ 5.10
不建议用太老的内核（< 4.19）

uname -a
cat /etc/debian_version

2. 关闭 Swap（必须）

K8s 默认不允许使用 swap：

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

3. 关闭防火墙或放行端口

测试环境可直接关：

sudo ufw disable

生产环境需放行：

6443（API Server）
10250（kubelet）
30000–32767（NodePort）

4. 设置主机名与 hosts

sudo hostnamectl set-hostname master

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

5. 内核参数（必做）

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

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

Docker 已不再被 K8s 直接支持（1.24+）

安装 containerd

sudo apt update
sudo apt install -y containerd
sudo mkdir -p /etc/containerd
containerd config default | sudo tee /etc/containerd/config.toml

修改：

SystemdCgroup = true

sudo systemctl restart containerd
sudo systemctl enable containerd

三、安装 Kubernetes 组件

1. 添加 K8s apt 源

sudo apt install -y apt-transport-https ca-certificates curl
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

sudo apt update

2. 安装 kubelet / kubeadm / kubectl

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 \
  --cri-socket=unix:///run/containerd/containerd.sock

初始化后：

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

五、网络插件（必装）

六、Node 加入集群

在 Master 上获取命令：

kubeadm token create --print-join-command

在 Node 上执行（需先装好 containerd + kubelet）

七、常见坑总结

❌ 忘了关 swap → kubelet 起不来
❌ 用 Docker 而不是 containerd
❌ 内核参数没配 → Pod 网络异常
❌ 版本不匹配（kubeadm / kubelet / kubectl）
❌ Debian 源没更新导致装不到新版

八、进阶建议

用 kubeadm + containerd + Calico 组合最稳
生产环境建议：
- 多 Master（堆叠 etcd）
- 使用 HAProxy / Keepalived
学习用：Minikube / Kind（比裸装省事）

如果你愿意，我可以：

✅ 给你一套 Debian 12 一键安装脚本
✅ 帮你规划 单节点 / 多节点 / 高可用 架构
✅ 针对 生产 or 测试环境 给不同方案

你现在是 学习用 还是 生产部署？