Ubuntu搭建K8s集群执行kubeadm init命令报错排查指南
2026-8-29
Ubuntu部署K8s集群kubeadm init报错排查流程
在Ubuntu节点部署Kubernetes（k8s）集群时，若master节点执行kubeadm init过程中出现报错，可对照以下标准部署流程逐一核查配置疏漏。
所有master、worker节点必须完成的通用配置
- 安装并启用容器运行时
- 更新软件源索引：
sudo apt-get update - 安装Docker容器运行时：
sudo apt-get install docker.io
- 更新软件源索引：
- 安装并配置k8s基础运行环境
- 更新软件源索引：
sudo apt-get update - 安装HTTPS源依赖组件：
sudo apt-get install -y apt-transport-https ca-certificates curl - 导入K8s官方软件源GPG密钥：
sudo curl -fsSLo /usr/share/keyrings/kubernetes-archive-keyring.gpg https://packages.cloud.google.com/apt/doc/apt-key.gpg - 写入K8s软件源配置：
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 - 重新更新软件源索引，使新添加的K8s源生效：
sudo apt-get update - 安装k8s核心组件：
sudo apt-get install -y kubelet kubeadm kubectl - 锁定k8s组件版本，避免自动升级引发集群版本不兼容问题：
sudo apt-mark hold kubelet kubeadm kubectl
- 更新软件源索引：
仅master节点需要执行的配置操作
- 初始化集群API Server（必须使用root权限运行）
执行初始化命令：kubeadm init --apiserver-advertise-address=<master节点集群通信内网IP> --pod-network-cidr=192.168.0.0/16注意：
--apiserver-advertise-address参数后必须填写master节点实际对内通信的IP地址，参数留空会直接触发初始化报错
典型报错示例：
内容的提问来源于stack exchange，提问作者mayur madan
相关产品推荐
相关产品推荐
