文档中心

容器服务

请输入

创建集群

创建 IPv4/IPv6 双栈集群

容器服务通过 IPv4/IPv6 双栈方案提供对 IPv6 网络的支持，以便用户可以在 Kubernetes 集群中使用 IPv6 地址。本文为您介绍如何搭建 IPv4/IPv6 双栈集群。

说明

【邀测·申请试用】：创建 IPv4/IPv6 双栈集群功能目前处于邀测阶段，如需使用，请提交申请。

背景信息

随着互联网的发展，IPv4 地址已经逐渐枯竭，IPv6 作为下一代互联网协议，具有更加丰富的地址空间和更加安全的特性。为了满足用户对 IPv6 的需求，双栈过渡是最佳选择。

前提条件

IPv4/IPv6 双栈功能目前在各产品侧均处于邀测阶段，例如：VPC（强依赖）、CLB（强依赖）、ALB、VCI 等，请确保使用场景内已经为当前账号添加所有依赖资源的 IPv4/IPv6 白名单权限。若依赖资源缺少白名单权限，请提交申请或联系您各产品业务对接人员。

使用限制

仅 Kubernetes 版本为 1.24.10-vke.6 以上的集群支持使用 IPv4/IPv6 双栈功能。

仅支持在 VPC-CNI 容器网络模型中使用 IPv4/IPv6 双栈集群。

IPv4/IPv6 双栈集群中仅支持添加拥有 IPv6 地址的节点，同理，添加节点池时会过滤出拥有 IPv6 地址的节点。

前提条件中提到的 VPC、CLB 为创建双栈集群的强依赖资源，务必确保已经开通白名单权限，其他按需开通即可。

操作步骤

步骤一：创建 IPv4/IPv6 双栈私有网络及子网

前提条件中提及的准备工作完成后，可参考以下步骤，创建一个 IPv4/IPv6 双栈私有网络及子网，供创建双栈集群使用。

说明

IPv6 私有网络相关更多介绍，参见：搭建 IPv6 私有网络。

登录私有网络控制台。

在私有网络管理页面的左侧导航栏，选择私有网络。

在私有网络列表页面，单击左上角创建私有网络，配置相关参数。其中：

在网络段中，勾选 IPv6 CIDR 配置项，开启该私有网络的 IPv6 功能。

在子网中，配置不同子网的 IPv6 CIDR。

单击确定，完成配置。

步骤二：创建 IPv4/IPv6 双栈集群

IPv4/IPv6 双栈私有网络及子网创建完成后，即可参考以下步骤，创建 IPv4/IPv6 双栈集群。

登录容器服务控制台。

在集群管理页面的左侧导航栏，选择集群。

在集群列表页面，单击左上角创建集群。

在创建集群对话框，单击自定义托管集群区域下的立即创建。

在创建集群页面根据向导配置集群信息。其中：

在 IP 版本中，选择 IPv6 双栈配置项。

在私有网络中，选择已开启 IPv4/IPv6 双栈的私有网络。

在 Pod 子网中，选择已开启 IPv4/IPv6 双栈的子网。

说明

本场景针对网络配置中 IPv6 相关详细介绍，其他配置的详细介绍参见创建托管集群。

完成集群其他参数配置，创建集群。

步骤三：（可选）开启 IPv6 公网带宽

IPv4/IPv6 双栈集群中创建完成后，集群中的节点和 Pod 均会从 VPC 中分配 IPv6 地址。但该地址只具备私网访问能力。如果节点或 Pod 需要通过 IPv6 地址访问公网，则需要在 IPv6 网关实例中开启对应网卡的 IPv6 公网带宽功能。

注意

请保证您的私有网络及子网已绑定 IPv6 网关。详情请参见私有网络开启 IPv6。若无法访问 IPv6 网关控制台，请联系您的客户经理。

本文介绍如何开启集群节点的 IPv6 公网带宽功能，使其能够通过 IPv6 地址访问公网。如需配置 Pod 的 IPv6 公网带宽功能，请参见为 Pod 配置 IPv6 公网带宽。

单击私有网络对应的 IPv6 网关名称，进入网关详情页面。

选择 IPv6 公网带宽页签，使用节点的 IPv6 网卡地址进行检索。

单击目标 IPv6 操作栏中的开通公网带宽，开启该 IPv6 地址的公网带宽功能，允许其访问公网。配置详情，请参见开通 IPv6 公网带宽。

结果验证

查看集群

集群创建预计需要 15~20 分钟，请您耐心等待，您也可以返回集群列表查看状态。

验证 IPv6 公网访问

使用 ECS Terminal 登录节点。详情请参见 ECS Terminal。

执行以下命令，验证连通性。

ping6 ipv6.baidu.com

预期结果如下。

最近更新时间：2026.03.13 10:40:55

这个页面对您有帮助吗？

有用

无用