跳转到主内容
websoft网络软件专家 - 深耕网络技术,打造实用软件!

flannel 网络插件报 "failed to create SubnetManager" 或 lease 冲突

Flannel报“failed to create SubnetManager”或lease冲突,本质是backend子网分配机制失效,常见于etcd数据不一致、节点残留状态或多个flannel实例争抢同一subnet lease;需检查etcd中/flannel网络配置与subnets租约、确认etcd endpoint及prefix、清理过期subnet、校验节点时间同步。 Flannel 报
"failed to create SubnetManager"
或 lease 冲突,本质是 backend 子网 分配机制失效,常见于 etcd 数据不一致、节点残留状态、或多个 flannel 实例争抢同一 subnet lease。 检查 etcd 中的 flannel 网络状态 Flannel 依赖 etcd 存储子网租约(lease)和网络配置。若 etcd 中残留过期 lease 或 subnet 键损坏,会导致新节点无法注册 subnet。 确认 flannel 使用的 etcd endpoint 和 key prefix(默认
/coreos.com/network
)是否正确,可通过
ps aux | grep flanneld
查看
--etcd-endpoints
和
--etcd-prefix
用 etcdctl 检查 subnet 分配情况:
etcdctl get /coreos.com/network/config
(应返回有效 JSON,如
{"Network":"10.244.0.0/16", "Backend":{"Type":"vxlan"}}
)
etcdctl get --prefix /coreos.com/network/subnets/
(列出所有已分配的子网,每条对应一个节点) 若发现大量过期 IP(如节点已下线但子网未释放),可手动清理(谨慎!先备份):
etcdctl del /coreos.com/network/subnets/10.244.5.0-24
确认节点间时间同步与 etcd lease 有效性 Flannel 使用 etcd 的 lease 机制绑定子网,lease TTL 默认 24h(可配)。若节点系统时间偏差大,或 etcd 集群时钟不同步,可能导致 lease 提前过期或续约失败。 php版微信js-sdk支付接口类 php版微信js-sdk支付接口类 下载 在所有节点执行
timedatectl status
,确保 NTP 正常且偏差 检查 flannel 启动参数中是否显式设置了
--subnet-lease-renew-margin
(单位秒),默认 60;若网络延迟高或 etcd 响应慢,建议调大至 180–300 观察 etcd lease 列表:
etcdctl lease list
,再对每个 lease 执行
etcdctl lease timetolive
,确认活跃 lease 未过期 排查多实例或残留进程冲突 同一节点运行多个 flanneld 进程(如旧进程未退出、systemd 重启异常、或容器化部署重复启动),会竞争写入相同 subnet key,触发 lease 冲突。 执行
ps aux | grep flanneld
,确认仅有一个 flanneld 进程,且参数一致(尤其
--iface
、
--ip-masq
、
--kube-subnet-mgr
) 若使用
--kube-subnet-mgr
(对接 Kubernetes API 而非 etcd),需确保集群中只有一个组件(如 kube-controller-manager 或独立 flannel)负责 subnet 分配,避免 etcd + API 双写冲突 删除 node 上残留的 flannel 网络命名空间和 veth 接口:
ip link show | grep flannel | awk '{print $2}' | xargs -I{} ip link delete {}
清理后重启 flanneld 验证配置一致性与 backend 兼容性 部分 backend(如 vxlan)对内核版本、网卡 offload 设置敏感;配置不一致也会导致 SubnetManager 初始化失败。 确认所有节点内核支持所选 backend(如 vxlan 需
CONFIG_VXLAN=m/y
,可用
zcat /proc/config.gz | grep VXLAN
或
modprobe vxlan && lsmod | grep vxlan
验证) 检查 flannel config 中
Backend.Type
是否统一(如全集群用
vxlan
,勿混用
host-gw
) 若使用自定义 iface(
--iface=eth1
),确保该网卡在所有节点存在且可路由;否则 flannel 可能因获取本机 IP 失败而无法创建 SubnetManager

相关文章