文档中心

容器服务

请输入

容器网络

为 Pod 配置 IPv6 公网带宽

在 IPv4/IPv6 双栈集群中，Pod 分配的 IPv6 地址默认未开通 IPv6 公网带宽功能，不能与公网互通。本文介绍如何在创建 Pod 时，为其开通 IPv6 公网带宽功能，使其能够通过 IPv6 访问公网。

背景信息

当您创建 IPv4/IPv6 双栈私有网络（VPC）及子网，并使用该私有网络和子网创建 IPv4/IPv6 双栈集群时，系统会为集群中的节点、Pod 分配 IPv6 地址。默认情况下，集群中的 Pod 仅具备 IPv6 地址，只支持私网访问能力。如果 Pod 需要通过 IPv6 地址访问公网，则需要遵循本文介绍的配置方法，在创建 Pod 时，为该 Pod 启用 IPv6 公网带宽功能。

前提条件

已创建 IPv4/IPv6 双栈集群。详情请参见创建 IPv4/IPv6 双栈集群。

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

（可选）如需使用共享带宽包，需提前创建 IPv4/IPv6 双栈协议类型的共享带宽包。请参见创建共享带宽包。

使用限制

建议统一通过本文介绍的方式配置 Pod 的 IPv6 公网带宽功能。配置完成后，请勿在 IPv6 网关控制台上手动修改配置（例如：计费方式、带宽上线等）。否则会导致两侧的配置不一致，可能造成集群中 Pod 使用 IPv6 访问公网异常或访问时不符合预期。

Pod 的 IPv6 公网带宽功能仅支持在首次创建时配置，配置成功后修改 Annotation 不生效。

Trunk ENI 不支持开启 IPv6 公网带宽。

仅 VPC-CNI 网络模型集群，支持为 Pod 配置 IPv6 公网带宽功能。

一个 VPC 最多只能配置一个 IPv6 网关。

IPv6 网关实例存在如下限制：

单个账号、在单个地域最多支持可开通 20 个 IPv6 公网带宽。

每个 IPv6 网关实例最多支持创建 200 个仅主动出规则。

说明

更多限制详情，请参见约束限制。

如需提高上述配额上限，请前往配额中心申请。

操作步骤

步骤一：安装组件

登录容器服务控制台。

在左侧导航栏中选择集群，单击目标集群名称，进入集群管理页面。

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

选择网络页签，将鼠标移动到 vpc-cni-controlplane 组件卡片上，单击部署，在弹出的配置框内开启 Pod 绑定公网 IP 功能。

说明

若存量集群已经安装 vpc-cni-controlplane 组件，请确保组件已经升级到 v1.5.3 及以上版本。详情请参见升级组件。

步骤二：为 Pod 配置 IPv6 公网带宽

容器服务通过实例注解（Annotation）方式为 Pod 配置 IPv6 公网带宽。

注意

为 Pod 配置 IPv6 公网带宽时，不区分 Pod 是否调度到普通节点还是 VCI 节点上。

以无状态负载为例，您可以在配置时添加 Annotation，为 Pod 配置 IPv6 公网带宽。示例和说明如下：

创建工作负载的 YAML 文件。示例文件deployment-demo.yaml代码如下：

apiVersion: apps/v1
kind: Deployment
metadata:
name: deployment-demo
namespace: default
spec:
replicas: 1
selector:
matchLabels:
app: demo
template:
metadata:
labels:
app: demo
annotations:
vke.volcengine.com/ipv6gateway-bandwidth-attributes: | # 为 Pod 开通 IPv6 公网带宽功能
{
"billingType": 2,
"bandwidth": 100,
"bandwidthPackageId": "bwp-13g2o0a09***",
"egressOnlyRule": false
}
spec:
containers:
- name: demo
image: doc-cn-beijing.cr.volces.com/vke/nginx-demo:v1.0
ports:
- containerPort: 80

关键参数说明，如下表所示。

参数	类型	是否必选	描述
billingType	Integer	是	IPv6 公网带宽的计费方式。取值： 2：按量计费-按带宽上限计费。 3：按量计费-按实际流量计费。
bandwidth	Integer	否	IPv6 公网带宽的带宽上限，单位为 Mbps。当BillingType 取值为2时，取值范围为 1～500。当BillingType 取值为3时：取值范围为 1～200。未配置时，默认为 1Mbps。说明带宽上限允许超过配置上限，如有需求，请请联系客户经理。详情请参见约束限制。
bandwidthPackageId	String	否	IPv6 共享带宽包 ID。共享带宽包详情，请参见创建共享带宽包。
egressOnlyRule	Boolean	否	是否同步创建仅主动出规则。取值： true：同步创建仅主动出规则。 false：（默认值）不创建仅主动出规则。说明为集群中的 Pod 开通 IPv6 公网带宽时，若您不希望该 IPv6 地址被公网的 IPv6 终端访问，可以通过配置本参数，同步创建仅主动出规则，拒绝公网的 IPv6 终端访问该 Pod。

执行以下命令，创建工作负载。

kubectl apply -f deployment-demo.yaml

结果验证

当 Pod 为Running状态后，您可以采取如下方式，确认配置是否正确。

单击 Pod 名称，进入 Pod 详情页面。查看 Pod 注解。正常情况下，系统将为 Pod 打上vke.volcengine.com/ipv6gateway-bandwidth-status注解，并展示 IPv6 网关实例 ID、EIP ID 等信息。

说明

为 Pod 添加状态注解ipv6gateway-bandwidth-status与 Pod 启动为异步流程，如果您需要避免 “Pod 正常启动但网络资源不可用” 的异常场景，可以使用 initContainer 持续监测该注解状态，等待该注解正常后再启动业务 Pod。

ping6 ipv6.baidu.com

预期结果如下。

最近更新时间：2026.04.07 11:56:00

这个页面对您有帮助吗？

有用

无用