求助：如何在纯IPv6环境下搭建跨网络Kubernetes集群？

从你的配置和报错来看，核心问题出在混用了IPv4的Pod网段和IPv6的集群控制平面，加上Canal网络插件默认没有适配纯IPv6环境，导致Pod网络无法正常初始化。下面是针对你的场景的完整修复和搭建步骤：

一、先清理当前故障集群 #

首先把当前有问题的集群清理掉，避免残留配置影响：

kubeadm reset -f
rm -rf ~/.kube/
iptables -F && iptables -t nat -F && iptables -t mangle -F && iptables -X
ipvsadm --clear

二、正确配置kubeadm初始化参数（纯IPv6模式） #

你的场景是纯IPv6环境，不需要启用IPv6DualStack特性，而是要指定IPv6的Pod网段和Service网段，同时确保apiserver绑定正确的IPv6地址：

kubeadm init \
--apiserver-advertise-address=2400:dd01:1032:7:4070:XXXX:XXXX:XXXX \
--pod-network-cidr=fd00:10:244::/64 \
--service-cidr=fd00:10:96::/112 \
--image-repository registry.cn-hangzhou.aliyuncs.com/google_containers \
--cri-socket /var/run/dockershim.sock \
--kubernetes-version=v1.21.0  # 建议使用支持纯IPv6的稳定版本，比如1.21+

注意：pod-network-cidr和service-cidr必须是合法的IPv6 ULA（唯一本地地址）网段，不能用IPv4网段。

三、配置支持纯IPv6的Calico网络插件 #

Canal（Calico+Flannel）默认配置是IPv4，需要修改配置文件适配IPv6：

1. 下载Calico的基础配置文件：

curl https://docs.projectcalico.org/manifests/calico.yaml -O

2. 修改配置文件中的关键参数：
   • 找到CALICO_IPV4POOL_CIDR这一行，注释掉它，添加CALICO_IPV6POOL_CIDR: fd00:10:244::/64（要和你kubeadm init时指定的pod-network-cidr一致）
   • 添加CALICO_IPV6POOL_NAT_OUTGOING: "true"
   • 找到FELIX_IPV6SUPPORT: "false"，改成"true"
3. 应用修改后的配置：

kubectl apply -f calico.yaml

四、检查节点和集群状态 #

1. 等待几分钟后，查看所有Pod状态：

kubectl get pods -A

正常情况下所有kube-system下的Pod都会进入Running状态。
2. 检查节点状态：

kubectl get nodes -o wide

确保节点的INTERNAL-IP显示的是IPv6地址，状态为Ready。

五、从节点（Ubuntu 20.04）加入集群 #

在主节点执行kubeadm token create --print-join-command，会生成一条包含IPv6地址的加入命令，复制到从节点执行即可。

关键注意事项 #

• 确保所有节点（包括主节点的Hyper-V虚拟机）的IPv6网络是连通的，用ping6 <对方IPv6地址>测试
• Docker需要配置支持IPv6，修改/etc/docker/daemon.json添加：

  {
    "ipv6": true,
    "fixed-cidr-v6": "fd00:10:200::/64"
  }
  

  然后重启Docker：systemctl restart docker
• kubelet默认会自动检测IPv6，但如果有问题，可以在/var/lib/kubelet/config.yaml中添加featureGates: {"IPv6DualStack": false}

内容的提问来源于stack exchange，提问作者mining