在开始安装前，请确保您的云服务器满足以下基本要求：

• 操作系统：建议使用Ubuntu 20.04 LTS或CentOS 7/8
• 硬件配置：至少2核CPU、4GB内存（生产环境建议更高配置）
• 网络环境：确保各节点间网络互通，建议关闭防火墙或配置放行规则
• 磁盘空间：系统盘至少20GB可用空间

特别注意：不同云厂商可能需要额外配置安全组规则，确保以下端口开放：6443、2379-2380、10250-10252等。

Kubernetes需要容器运行时环境，我们以Docker为例：

# Ubuntu系统
sudo apt-get update
sudo apt-get install -y docker.io
sudo systemctl enable docker
sudo systemctl start docker

# CentOS系统
sudo yum install -y docker
sudo systemctl enable docker
sudo systemctl start docker

安装完成后，建议配置Docker镜像加速器（各云厂商通常提供专属加速地址）。

1. 添加Kubernetes源

# Ubuntu
sudo apt-get update && sudo apt-get install -y apt-transport-https curl
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee -a /etc/apt/sources.list.d/kubernetes.list

# CentOS
cat < /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF

2. 安装kubeadm、kubelet和kubectl

# Ubuntu
sudo apt-get update
sudo apt-get install -y kubelet kubeadm kubectl
sudo apt-mark hold kubelet kubeadm kubectl

# CentOS
sudo yum install -y kubelet kubeadm kubectl
sudo systemctl enable kubelet

在主节点上执行初始化命令（根据实际情况替换apiserver-advertise-address）：

sudo kubeadm init --pod-network-cidr=10.244.0.0/16 \
--apiserver-advertise-address=<您的服务器内网IP>

初始化完成后，按照提示执行以下命令配置kubectl：

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

重要提示：请妥善保存输出的join命令，后续添加工作节点时需要用到。

选择安装Flannel网络插件：

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

验证安装是否成功：

kubectl get pods --all-namespaces

在每个工作节点上重复第二、三步的安装步骤，然后使用主节点初始化时提供的join命令加入集群：

sudo kubeadm join <主节点IP>:6443 --token  \
--discovery-token-ca-cert-hash sha256:

在主节点上验证节点状态：

kubectl get nodes

• 镜像拉取失败：尝试手动拉取或配置国内镜像源
• 节点NotReady：检查网络插件是否正常安装
• 证书过期：使用kubeadm certs renew命令更新
• 云平台特殊问题：各云厂商文档通常有针对性的解决方案