Debian中K8s安装失败怎么办

Debian 上 Kubernetes 安装失败排查与修复

一快速自检清单

资源与系统：至少准备2 核 CPU、2 GB 内存、20–50 GB 磁盘，系统为Debian 稳定版，内核不低于3.10，并具备稳定网络与NTP 时间同步。
禁用 Swap：Kubernetes 不支持启用 Swap 的环境，执行：sudo swapoff -a，并在 /etc/fstab 中注释含 swap 的行，永久生效。
容器运行时：安装并启动 containerd（或 Docker，二者择一）。示例：sudo apt update && sudo apt install -y containerd && sudo systemctl enable --now containerd。
安装组件：添加 Kubernetes APT 源并安装 kubelet、kubeadm、kubectl，然后执行 sudo apt-mark hold kubelet kubeadm kubectl 防止被升级破坏版本一致性。
初始化命令要点：控制平面节点执行 kubeadm init，常见参数包括 --apiserver-advertise-address=<本机IP>、--pod-network-cidr=10.244.0.0/16（与所选网络插件匹配）、必要时指定 --image-repository 使用国内镜像源。
配置 kubectl：mkdir -p $HOME/.kube && sudo cp -i /etc/kubernetes/admin.conf $HOME/.kube/config && sudo chown $(id -u):$(id -g) $HOME/.kube/config。
安装网络插件：如 Flannel：kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml。
节点就绪：工作节点加入后，使用 kubectl get nodes 检查状态是否为 Ready。

二常见故障与修复

镜像拉取失败：国内环境可指定镜像仓库（如 registry.aliyuncs.com/google_containers），或提前用 crictl pull/docker pull 拉取所需镜像并重新打标签；若使用 containerd，确保 /etc/containerd/config.toml 的 sandbox_image 与拉取镜像一致。
预检失败（常见为 Swap 未关闭、端口被占用、内核参数不当）：关闭 Swap、释放端口、按需设置内核参数（如启用桥接转发 net.bridge.bridge-nf-call-iptables=1 等）。
端口未放行：若启用 UFW，放行关键端口（示例）：sudo ufw allow 6443,2379,2380,10250,10251,10252,10255/tcp && sudo ufw reload；如使用 firewalld/iptables，做等价的放行规则。
节点 NotReady：多因网络插件未就绪或 kube-proxy 异常，检查 kubectl get pods -n kube-system，确认 flannel/cilium/kube-proxy 运行正常；必要时重新应用网络插件清单。
组件版本不兼容：核对 kubelet/kubeadm/kubectl 与要部署的 Kubernetes 版本一致，参考官方兼容矩阵，避免混装。
kubeconfig 配置错误：确认 $HOME/.kube/config 存在且有效，执行 kubectl config view 校验当前上下文与集群信息。

三关键日志与定位命令

查看 kubelet 日志：sudo journalctl -u kubelet -xe，关注启动失败原因（镜像、cgroup、swap、端口冲突等）。
查看系统日志：sudo journalctl -xe 或 /var/log/syslog，定位网络、服务、权限相关错误。
查看集群组件日志：kubectl logs -n kube-system <pod-name>，优先排查 coredns、kube-proxy、flannel 等系统 Pod。
查看节点与组件状态：kubectl get nodes、kubectl get pods -A -o wide，快速判断网络插件与控制平面是否就绪。

四一键纠偏脚本示例

#!/usr/bin/env bash
set -e

# 0) 基本环境
sudo apt update && sudo apt install -y ca-certificates curl gnupg lsb-release

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

# 2) 安装 containerd（若已安装可跳过）
sudo apt install -y containerd
sudo systemctl enable --now containerd

# 3) 安装 kubelet/kubeadm/kubectl
curl -fsSLo /usr/share/keyrings/kubernetes-archive-keyring.gpg https://packages.cloud.google.com/apt/doc/apt-key.gpg
echo "deb [signed-by=/usr/share/keyrings/kubernetes-archive-keyring.gpg] https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list > /dev/null
sudo apt update
sudo apt install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl

# 4) UFW 放行（如启用）
sudo ufw allow 6443,2379,2380,10250,10251,10252,10255/tcp || true
sudo ufw reload || true

# 5) 初始化控制平面（按需修改参数）
API_IP=$(ip -4 addr show scope global | grep -oP '(?<=inet\s)\d+(\.\d+){3}' | head -n1)
sudo kubeadm init \
  --apiserver-advertise-address=$API_IP \
  --pod-network-cidr=10.244.0.0/16 \
  --image-repository=registry.aliyuncs.com/google_containers

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

# 7) 安装 Flannel 网络插件
kubectl apply -f https://raw.githubusercontent.com/coreos/flannel/master/Documentation/kube-flannel.yml

echo "Init done. Run on worker nodes:"
echo "  sudo kubeadm join $API_IP:6443 --token <token> --discovery-token-ca-cert-hash sha256:<hash>"

说明：请将 <token> 与 <hash> 替换为 kubeadm init 输出中的实际值；如使用云厂商或受限网络，请提前准备镜像或使用内网镜像仓库。

五仍未解决时请准备的信息

执行 kubeadm init 的完整输出与关键报错片段。
sudo journalctl -u kubelet -xe 的最后 100 行。
kubectl get nodes -o wide 与 kubectl get pods -A -o wide 的结果。
当前系统信息：uname -a、lsb_release -a、free -m、df -h、ip a、sudo ufw status 或防火墙规则。
使用的 Kubernetes 版本与容器运行时版本（kubelet --version、crictl version 或 docker version）。

最新问答

相关标签