K8s集群Debian如何搭

下面给你一个从零在 Debian 上搭建 Kubernetes（K8s）集群的实操流程，以 kubeadm 方式为主（官方推荐、最通用）。示例基于 Debian 11/12，适用于 1 个 master + 若干 worker。

一、环境准备

1. 机器规划（示例）

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

建议：

2 CPU / 2G 以上

禁止 swap

各节点时间同步

2. 基础设置（所有节点）

# 设置主机名
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/modules-load.d/k8s.conf <<EOF
br_netfilter
EOF
modprobe br_netfilter

# 内核参数
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

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

K8s 已弃用 Docker，推荐 containerd

apt update
apt install -y containerd

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

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

systemctl restart containerd
systemctl enable containerd

三、安装 kubeadm / kubelet / kubectl

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
apt-mark hold kubelet kubeadm kubectl

四、初始化 Master 节点

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

初始化成功后：

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

⚠️ 保存好输出的：

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

五、安装网络插件（CNI）

以 Flannel 为例：

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

查看状态：

kubectl get nodes
kubectl get pods -n kube-flannel

六、加入 Worker 节点

在 worker 上执行 master 输出的 join 命令：

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

七、验证集群

kubectl get nodes
kubectl get pods -A

状态全部 Ready 即成功 ✅

八、常见可选组件

Dashboard
Metrics Server
Ingress（nginx / traefik）
Helm

九、常见问题

节点 NotReady → CNI 没装
kubectl 没权限 → kubeconfig 没配置
时间不同步 → 安装 chrony
国内拉镜像慢 → 配置 registry.aliyuncs.com 镜像

如果你愿意，我可以：

✅ 给你 一键脚本
✅ 教你 高可用 Master
✅ 用 kind / k3s（轻量）
✅ 针对 国内网络优化

你现在是 学习 / 生产 / 虚拟机实验？