Kubeadm部署双栈Kubernetes集群时的IPv6子网配置及路由问题

首先，咱们先解决你遇到的kubeadm报错问题——这个错误的原因很明确：Kubernetes双栈模式要求Pod的IPv6子网前缀长度不能比节点所在的子网更“窄”（也就是前缀位数不能更多）。你的节点在2001:1234:1234:1::/64这个/64子网里，所以Pod的IPv6子网必须是/64或者更短的前缀（不过IPv6标准里一般都是用/64作为子网段，所以直接分配一个专属的/64给Pod就好）。

第一步：调整kubeadm的子网配置 #

从你的2001:1234:1234::/48大网段里划一个全新的/64子网给Pod，比如2001:1234:1234:4::/64，同时服务的IPv6子网可以用一个更小的段（比如/112，足够容纳大量服务IP）。修改后的kubeadm初始化命令应该是这样的：

kubeadm init \
    --apiserver-advertise-address=192.168.1.10 \
    --control-plane-endpoint=example.com \
    --pod-network-cidr=10.244.0.0/16,2001:1234:1234:4::/64 \
    --service-cidr=10.96.0.0/16,2001:1234:1234:5::/112

这样就能绕过之前的前缀长度报错问题了。

第二步：解决Pod子网的路由可达性问题 #

接下来你关心的“新的Pod子网怎么在UDM-SE上路由”，核心是让UDM-SE知道2001:1234:1234:4::/64这个子网的流量要发往K8s集群的节点。这里分两种常见的CNI插件场景来说：

场景1：用Flannel作为CNI插件

Flannel会自动在每个K8s节点上配置Pod子网的内部路由，但UDM-SE不知道这个子网的存在，所以需要手动在UDM-SE上添加一条静态路由：

• 目标网段：2001:1234:1234:4::/64
• 下一跳地址：你K8s集群中任意一个节点的IPv6地址（比如2001:1234:1234:1::10）
• 如果有多个节点，UDM-SE支持ECMP路由的话，可以添加多条下一跳指向不同节点，实现流量分摊；如果没有ECMP，指向集群的控制平面负载均衡地址（如果有的话）会更可靠。

场景2：用Calico作为CNI插件

Calico支持通过BGP自动向网络设备宣告路由，不需要手动加静态路由：

1. 在Calico的配置中开启BGP功能（默认一般是开启的）
2. 添加UDM-SE的IPv6地址作为BGP邻居，让Calico节点主动把Pod子网的路由同步给UDM-SE
3. 确保UDM-SE上也配置了对应的BGP邻居（指向K8s节点的IPv6地址），这样双向的路由就能自动同步了

额外注意事项 #

• 先确认你的K8s节点本身的IPv6地址是全局可路由的，并且UDM-SE和节点之间的IPv6连通性正常（可以用ping6测试）
• 节点上的防火墙要允许IPv6流量，尤其是ICMPv6（IPv6严重依赖ICMP做邻居发现、路径MTU探测等，不能禁用）
• 如果用其他CNI插件（比如Weave），原理类似：要么手动在UDM-SE加静态路由，要么配置插件自动向UDM-SE宣告Pod子网路由

备注：内容来源于stack exchange，提问作者Dreamystify