小白新手Kubernetes 集群搭建与故障排查全记录：从迷茫到豁然开朗的 72 小时

引言

如果你曾尝试在国内网络环境下搭建 Kubernetes 集群，你一定会感受到那种“明明按照官方文档操作，却总是卡在各种奇怪问题上”的无力感。最近，我花了整整 3 天时间，终于成功搭建了一个 Kubernetes 单节点集群。作为k8s小白，希望把过程记录下来，有些指令以后也能用得到。

我：
终于搞定了。花了3天时间。最后只是一个版本问题，哥们你觉得值不值？
GitHub Copilot:
花了 3 天时间解决问题，虽然过程可能有些曲折，但您不仅成功搭建了 Kubernetes 集群，还深入了解了其中的细节（比如网络插件、镜像拉取、版本兼容性等）。这些经验在未来的工作中会非常有价值。值不值？ 从学习和成长的角度来看，绝对值得！每次解决复杂问题的过程，都是技术能力提升的机会。下次遇到类似问题，您会更快、更高效地解决。

1. 背景与目标

1.1 背景

作为一个开发者，我需要一个 Kubernetes 集群来测试和部署一些微服务应用。由于预算有限，我选择在一台配置不高的服务器上搭建一个单节点集群。看似简单的任务，却让我经历了一场“技术马拉松”。

1.2 目标

• 使用 kubeadm 快速初始化 Kubernetes 集群。
• 使用 Flannel 作为网络插件。
• 解决搭建过程中可能遇到的各种问题。

2. 环境准备：从零开始的 Kubernetes 环境

在正式开始之前，我需要确保服务器的基础环境满足 Kubernetes 的运行要求。

2.1 基础环境安装

首先，更新系统并安装必要的工具和依赖：

apt update
apt install -y apt-transport-https ca-certificates curl gpg ipvsadm net-tools gnupg

接着，配置 Kubernetes 官方源：

curl -fsSL https://pkgs.k8s.io/core:/stable:/v1.32/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.32/deb/ /" | tee /etc/apt/sources.list.d/kubernetes.list
apt update
apt install -y kubelet kubeadm kubectl
swapoff -a
modprobe br_netfilter
sysctl -w net.ipv4.ip_forward=1

2.2 容器运行时安装

安装 Docker

虽然 Kubernetes 推荐使用 containerd，但我还是先安装了 Docker，方便后续调试：

curl -fsSLO https://download.docker.com/linux/static/stable/x86_64/docker-28.1.1.tgz
tar xzvf docker-28.1.1.tgz --strip 1 -C /usr/local/bin
#验证安装是否成功ls 
docker --version
#设置开机启动
systemctl enable docker
systemc