怎样在Debian上运行K8s

在 Debian 上部署 Kubernetes 的实操步骤

一环境与前置准备

节点规划：至少 1 台 Master + 1 台 Worker；推荐 Debian 12，各节点需具备唯一 主机名/MAC/Product UUID，并开启 NTP 时间同步。
硬件建议：每节点至少 2 核 CPU、2 GB 内存、20 GB 磁盘。
网络要求：节点间互通；控制面端口 6443 对外开放；如需 NodePort 服务，开放 30000–32767。
容器运行时：使用 containerd（推荐）或 Docker。
安全基线：临时与永久 关闭 Swap；开启桥接流量转发；按需放行防火墙端口。

二所有节点通用配置

更新系统与基础工具

sudo apt update && sudo apt upgrade -y
sudo apt install -y apt-transport-https ca-certificates curl

加载内核模块与网络转发

sudo tee /etc/modules-load.d/k8s.conf <<EOF
overlay
br_netfilter
EOF
sudo modprobe overlay
sudo modprobe br_netfilter

sudo tee /etc/sysctl.d/99-kubernetes.conf <<EOF
net.bridge.bridge-nf-call-iptables  = 1
net.bridge.bridge-nf-call-ip6tables = 1
net.ipv4.ip_forward                 = 1
EOF
sudo sysctl --system

关闭 Swap

sudo swapoff -a
sudo sed -i '/ swap / s/^\(.*\)$/#\1/g' /etc/fstab

安装并启用容器运行时（二选一）

containerd（推荐）

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

Docker

curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
echo "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list
sudo apt update && sudo apt install -y docker-ce docker-ce-cli containerd.io
sudo systemctl enable --now docker

安装 kubeadm、kubelet、kubectl（使用新版签名与仓库）

# 以 1.33 为例，可按需替换为其他稳定版本
VERSION=v1.33
sudo curl -fsSL https://pkgs.k8s.io/core:/stable:/${VERSION}/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:/${VERSION}/deb/ /" | \
  sudo tee /etc/apt/sources.list.d/kubernetes.list
sudo apt update
sudo apt install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl
sudo systemctl enable --now kubelet

防火墙放行（示例 UFW；如使用 firewalld/云安全组，放行等价端口）

sudo ufw allow 6443/tcp
sudo ufw allow 2379:2380/tcp
sudo ufw allow 10250/tcp
sudo ufw allow 10251/tcp
sudo ufw allow 10252/tcp
sudo ufw allow 30000:32767/tcp
sudo ufw reload

以上步骤覆盖系统、内核、容器运行时与 k8s 组件的基础安装与网络准备。

三初始化控制平面 Master

初始化集群（Pod 网段按所选 CNI 调整）

# Flannel 常用 10.244.0.0/16；Calico 常用 192.168.0.0/16
sudo kubeadm init --pod-network-cidr=10.244.0.0/16

配置 kubectl

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

安装 CNI 网络插件（二选一）

Flannel

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

Calico

kubectl apply -f https://docs.projectcalico.org/manifests/tigera-operator.yaml
kubectl apply -f https://docs.projectcalico.org/manifests/custom-resources.yaml

验证

kubectl cluster-info
kubectl get nodes
kubectl get pods -A

上述命令完成控制面初始化、kubectl 配置与网络插件部署，节点就绪后即可纳管工作节点。

四加入 Worker 节点

在 Master 上生成加入命令（若 token 过期可重建）

# 生成新的 join 命令并打印
kubeadm token create --print-join-command

在 Worker 节点执行输出的 join 命令

sudo kubeadm join <MASTER_IP>:6443 \
  --token <TOKEN> \
  --discovery-token-ca-cert-hash sha256:<HASH>

在 Master 上验证
```
kubectl get nodes
```

以上完成节点加入与集群扩容。

五常见问题与维护

镜像拉取失败（国内网络）：预先拉取所需镜像并重新打 tag，或使用国内镜像源/代理。示例（按需替换版本标签）：

docker pull registry.aliyuncs.com/google_containers/kube-apiserver:v1.33.4
docker tag  registry.aliyuncs.com/google_containers/kube-apiserver:v1.33.4 \
  k8s.gcr.io/kube-apiserver:v1.33.4
# 其余组件同理：kube-controller-manager、kube-scheduler、kube-proxy、pause、etcd、coredns

重置与清理（重装时使用）

sudo kubeadm reset -f
sudo rm -rf /etc/cni/net.d
sudo iptables -F && sudo iptables -t nat -F && sudo iptables -t mangle -F && sudo iptables -X
sudo systemctl restart containerd

版本与升级建议：保持 kubelet 与 API Server 版本偏差不超过 1 个次版本；升级前备份 etcd 与关键应用。
生产建议：启用 高可用控制面（多 Master）、持久化存储、RBAC、网络策略 与 审计日志；按需配置 镜像加速 与 私有仓库。

最新问答

相关标签