基于Kubeadm安装Kubernetes时自定义IP范围的方法

秋涛姑娘_1691

秋涛姑娘_1691

2026-08-26

663人浏览

原创

kubeadm init不能仅靠--pod-network-cidr指定网段,必须通过配置文件显式定义networking.podSubnet和serviceSubnet,且需与所选CNI插件(如Calico、Flannel)的配置严格一致,否则导致网络插件初始化失败或集群异常。

基于kubeadm安装kubernetes时自定义ip范围的方法

不能直接在 kubeadm init 命令行里指定 Pod 或 Service 网段,必须通过配置文件传入 podSubnet 和 serviceSubnet —— 否则默认用 10.96.0.0/12(Service)和 10.244.0.0/16(Flannel 默认),但这两个值不通用,且与 Calico、Cilium 等 CNI 插件的期望常有冲突。

networking 字段必须显式写进 ClusterConfiguration

很多人误以为加个 --pod-network-cidr 参数就够了,其实从 kubeadm v1.19+ 开始,该参数仅用于向 kube-controller-manager 透传,**不会影响 etcd 中存储的集群网络配置**,也不被 CNI 插件读取。真正起效的是配置文件中 networking 下的字段:

  • podSubnet:供 CNI 插件(如 Calico、Flannel)初始化时对齐 IPAM,必须和你后续部署的 CNI 配置一致
  • serviceSubnet:决定 ClusterIP 分配范围,修改后会影响所有 Service 的 VIP 地址空间
  • dnsDomain:通常保持 cluster.local,改了需同步更新 CoreDNS ConfigMap

示例片段(kubeadm-config.yaml):

networking:
  podSubnet: 172.16.0.0/12
  serviceSubnet: 10.103.0.0/16
  dnsDomain: cluster.local

注意:podSubnet 值必须和你选用的 CNI 插件 YAML 中的 cidr 或 ipam.subnet 完全一致,否则节点上 calico-node 或 flanneld 启动失败,报错类似 failed to configure default pool: invalid CIDR。

不同 CNI 对 podSubnet 的解析逻辑差异很大

不是所有 CNI 都无条件信任 kubeadm 配置里的 podSubnet,它们加载方式不同:

Kubernetes 301363
Kubernetes 301363

从抖音视频学习: Kubernetes — 【2026最新】这绝对是B站讲的最好的Kubernetes系统精讲教程,全程干货无废话!

下载
  • Flannel:只认自己 YAML 里的 net-conf.json 中的 Network 字段,kubeadm 的 podSubnet 仅作校验,不覆盖
  • Calico:会读取 kubeadm 配置生成 installation CR,自动注入 spec.calicoNetwork.ipPools[0].cidr,前提是使用官方 manifest(如 tigera-operator)
  • Cilium:完全忽略 kubeadm 的 podSubnet,必须在 Helm values 或 CiliumClusterwideNetworkPolicy 中显式设 ipam.mode=cluster-pool + clusterPoolIPv4CIDR

所以别指望写一次 podSubnet 就全局生效。部署前务必查清你选的 CNI 文档里“如何指定 Pod 网段”那一节,再反推 kubeadm 配置要不要写、怎么写。

kubeadm init 失败后改 subnet 不能只改配置文件

如果 kubeadm init 已执行过但失败(比如因网段冲突卡在 etcd 启动),不能简单改完配置重跑 —— 因为 /etc/kubernetes/manifests/etcd.yaml 里已经固化了初始 --advertise-client-urls 和数据目录,且 etcd 数据库中存有旧的 network config。

  • 必须先运行 kubeadm reset -f 清理残留(包括 /var/lib/etcd)
  • 确认 swapoff -a、iptables -P FORWARD ACCEPT 等前置项仍有效(重置后可能恢复)
  • 若之前手动改过 /etc/cni/net.d/ 下的配置,要一并删掉,否则 CNI 初始化时会跳过自动生成逻辑

常见症状:节点 Ready 但 kubectl get nodes 显示 NotReady,kubectl describe node 报 NetworkPluginNotReady: cni plugin not initialized,大概率是 CNI 配置和 kubeadm 声明的网段对不上,或 etcd 里残留旧状态。

最易被忽略的一点:kubeadm 不验证 podSubnet 和 serviceSubnet 是否重叠。如果你填了 podSubnet: 10.0.0.0/8 和 serviceSubnet: 10.96.0.0/12,它们实际包含关系,Kubernetes 不报错,但 CoreDNS、kube-proxy 的 iptables 规则会混乱,导致 DNS 解析失败或 ClusterIP 访问异常。务必人工校验两个 CIDR 无交集。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Golang云原生微服务Kubernetes_Golang怎么集成Kubernetes开发云原生服务
Golang云原生微服务Kubernetes_Golang怎么集成Kubernetes开发云原生服务

Golang云原生微服务Kubernetes (K8s) 是指 使用 Go 语言(Golang)编写的云原生微服务,并利用 Kubernetes 平台进行容器化部署、自动化管理、弹性伸缩和高效编排的一整套现代应用架构方案。

2025.12.22

116

5

Go云原生应用与Kubernetes服务部署实战
Go云原生应用与Kubernetes服务部署实战

本专题围绕 Go 语言在云原生环境中的应用展开,讲解容器化部署、Kubernetes 编排、服务发现、健康检查与弹性扩缩容机制。通过真实云端案例,帮助开发者构建可扩展的云原生微服务架构。

2026.06.29

228

19

CVE-2026-114938高危漏洞修复
CVE-2026-114938高危漏洞修复

Java4Shell是OpenJDK Base64解码路径中的远程代码执行漏洞,编号CVE-2026-114938,2026年11月17日披露,官方已发布17.0.21.1、21.0.13.1等修复版本,建议优先升级 。本专题围绕Java4Shell(CVE-2026-114938)持续更新,从漏洞原理、受影响版本、受影响产品到修复与自查一站式汇总,适合Java开发、运维与安全人员快速定位风险。ARM64环境不受影响,x86-64环境请

2026.11.22

0

11

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

20

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

20

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

60

8

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

2026.11.20

0

10

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

2026.11.20

40

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kubernetes官方教程手册
Kubernetes官方教程手册

共0课时 | 0人学习

Kubernetes官方中文文档
Kubernetes官方中文文档

共0课时 | 0人学习