容器服务
容器服务
容器服务
文档指南
请输入
容器服务 VKE
产品动态
Kubernetes 版本发布记录
组件发布记录
监控组件
DNS 组件
GPU 组件
Sandbox 组件
安全公告
产品公告
历史公告
用户指南
集群
节点池
授权
网络
容器网络
服务（Service）
路由（Ingress）
APIG Ingress
ALB Ingress
自定义转发规则配置示例
CLB Ingress
Nginx Ingress
Gateway API
工作负载
存储
数据管理中心（DMC）
对象存储（TOS）
FSX 访问方式
文件存储（NAS）
FSX 访问方式
弹性文件存储（EFS）
文件存储（vePFS）
FSX 访问方式
vePFS Client 访问方式
NFS 访问方式
大数据文件存储（CloudFS）
弹性伸缩
工作负载弹性伸缩
事件驱动伸缩（KEDA）
组件管理
网络组件
监控组件
DNS 组件
GPU 组件
Sandbox 组件
异构计算
调度管理
可观测性
基础观测
诊断与巡检
最佳实践
网络
可观测性
安全合规
API 参考
集群管理
节点池管理
组件管理
机型镜像管理
云原生观测
巡检诊断
弹性容器实例
附录
开发指南
常见问题
通用 FAQ
集群 FAQ
集群管理
集群升级
节点与节点池 FAQ
授权 FAQ
工作负载 FAQ
服务与路由 FAQ
存储 FAQ
弹性伸缩 FAQ
可观测性 FAQ
配额 FAQ
组件 FAQ
容器镜像 FAQ
AI 云原生
推理套件
Helm 模板 AI 应用
Deepseek 实践
Qwen 实践
最佳实践
MiniMax 模型部署
Qwen 模型部署
弹性容器实例 VCI
最新动态
用户指南
虚拟节点
VKE 集群使用虚拟节点
自建/跨云集群使用虚拟节点
创建 VCI 实例
VCI Agent Sandbox
安全合规
- 文档首页
容器服务容器服务 VKE用户指南网络路由（Ingress）CLB Ingress使用 Annotation 配置 CLB Ingress
复制全文
下载 pdf使用 Annotation 配置 CLB Ingress
文档反馈
问问助手CLB Ingress 支持通过注解（Annotation）实现更加丰富的 CLB 能力配置。本文主要介绍使用 Annotation 配置 CLB Ingress 的主要场景和配置方法。
注意
- 配置 CLB Ingress 前，请务必仔细阅读 CLB Ingress 使用注意事项。
- ALB Ingress 提供更加丰富的功能和可靠性，为保障您业务的安全和稳定，建议在集群中优先选择 ALB Ingress 实现业务发布。详情请参见 ALB Ingress。
- 注解的内容需要严格区分大小写。
配置监听器
说明
监听器支持在对接已有 CLB 实例时配置，也支持在创建新的 CLB 实例时配置。本例以对接已有 CLB 实例为例。
CLB Ingress 支持通过 Annotation 配置监听器。示例和注解说明如下：
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
ingress.vke.volcengine.com/loadbalancer-id: "clb-rrxpqzg37eo0v0x58******"
# 指定使用的负载均衡 ID
ingress.vke.volcengine.com/loadbalancer-scheduler: "wrr"
# 配置监听器调度算法。取值：wrr(加权轮询)、wlc(加权最小连接数)、sh（源地址哈希）
ingress.vke.volcengine.com/loadbalancer-protocol: "http"
# 配置监听器协议。取值：http 、https
ingress.vke.volcengine.com/loadbalancer-port: "80"
# 配置监听器的监听端口，取值范围为 1-65535。http 协议默认监听 80 端口，https 协议默认监听 443 端口
name: clb-ingress # 自定义路由规则名称
namespace: default # 指定命名空间
spec:
ingressClassName: clb
rules:
- host: example.com # 需要对外提供访问的域名
http:
paths:
- backend:
service:
name: service-demo-a # 需要对接的服务名称
port:
number: 80 # 需要对接服务的端口号
path: /foo # 请求匹配的路径
pathType: Prefix # 路径类型：Exact（精确匹配）/Prefix（前缀匹配）
- backend:
service:
name: service-demo # 需要对接的服务名称
port:
number: 80 # 需要对接服务的端口号
path: /bar # 需要设定的访问路径信息
pathType: Prefix # 路径类型：Exact（精确匹配）/Prefix（前缀匹配）
Annotation 说明如下表所示。
字段 | 类型 | 是否必须 | 描述 | 默认值 |
字段 | 类型 | 是否必须 | 描述 | 默认值 |
ingress.vke.volcengine.com/loadbalancer-scheduler | String | 否 | 负载均衡器使用的调度算法。取值：
| wrr |
ingress.vke.volcengine.com/loadbalancer-protocol | String | 否 | 负载均衡实例的监听协议。取值：
| http |
ingress.vke.volcengine.com/loadbalancer-port | Integer | 否 | 负载均衡器对外的监听端口，注册到负载均衡服务地址上的端口。取值范围为 1～65535。 |
|
配置直通 Pod 模式
说明
- 直通 Pod 模式仅在 VPC-CNI 容器网络模式的集群下生效。
- 直通 Pod 模式支持在对接已有 CLB 实例时使用，也支持在创建新的 CLB 实例时使用。本例以对接已有 CLB 实例为例。
CLB Ingress 支持通过 Annotation 配置直通 Pod 模式。示例和注解说明如下：
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
ingress.vke.volcengine.com/loadbalancer-id: "clb-rrxpqzg37eo0v0x58******"
ingress.vke.volcengine.com/loadbalancer-pass-through: "true"
# 开启 Pod 直通模式
name: clb-ingress # 路由规则的名称
namespace: default # 路由规则所在的命名空间
spec:
ingressClassName: clb
rules:
- host: example.com # 需要对外提供访问的域名
http:
paths:
- backend:
service:
name: service-demo # 需要对接的服务名称
port:
number: 80 # 需要对接服务的端口号
path: / # 请求匹配的路径
pathType: Prefix # 路径类型：Exact（精确匹配）/Prefix（前缀匹配）
Annotation 说明如下表所示。
字段 | 类型 | 是否必须 | 描述 | 默认值 |
字段 | 类型 | 是否必须 | 描述 | 默认值 |
ingress.vke.volcengine.com/loadbalancer-pass-through | String | 是 | 是否启用负载均衡器直通 Pod 模式。取值：
| true |
配置健康检查
说明
健康检查功能支持在对接已有 CLB 实例时使用，也支持在创建新的 CLB 实例时使用。本例以对接已有 CLB 实例为例。
CLB Ingress 支持通过 Annotation 配置健康检查。示例和注解说明如下：
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
annotations:
ingress.vke.volcengine.com/loadbalancer-id: "clb-rrxpqzg37eo0v0x58******"
# 指定使用的负载均衡 ID
ingress.vke.volcengine.com/loadbalancer-healthcheck-enabled: "true"
# 配置是否开启健康检查。取值：true、false，本场景取值：true
ingress.vke.volcengine.com/loadbalancer-healthcheck-path: "/"
# 指定健康检查路径。默认为 /
ingress.vke.volcengine.com/loadbalancer-healthcheck-method: "GET"
# 选择健康检查的方法，取值为 GET 或 HEAD
ingress.vke.volcengine.com/loadbalancer-healthcheck-httpcode: "http_2xx,http_3xx"
# 设置健康检查的状态码，取值：http_2xx（默认）、http_3xx（默认）、http_4xx和http_5xx
ingress.vke.volcengine.com/loadbalancer-healthcheck-timeout: "2"
# 等待健康检查响应的时间，取值范围为 1～60 秒
ingress.vke.volcengine.com/loadbalancer-healthcheck-interval: "2"
# 设置健康检查的时间间隔，取值范围：1～300 秒
ingress.vke.volcengine.com/loadbalancer-healthy-threshold: "3"
# 判断后端服务器正常的健康检查次数，取值范围为 2～10
ingress.vke.volcengine.com/loadbalancer-unhealthy-threshold: "3"
# 判断后端服务器异常的健康检查次数，取值范围为 2～10
name: clb-ingress # 路由规则的名称
namespace: default # 路由规则所在的命名空间
spec:
ingressClassName: clb
rules:
- host: example.com #对外提供访问的域名
http:
paths:
- backend:
service:
name: service-demo # 对接的服务名称
port:
number: 80 # 对接服务的端口号
path: /
pathType: Prefix # 路径类型：Exact（精确匹配）/Prefix（前缀匹配）
Annotation 说明如下表所示。
字段 | 类型 | 是否必须 | 描述 | 默认值 |
字段 | 类型 | 是否必须 | 描述 | 默认值 |
ingress.vke.volcengine.com/loadbalancer-healthcheck-enabled | String | 是 | 表示是否启用健康检查。取值：
| true |
ingress.vke.volcengine.com/loadbalancer-healthcheck-path | String | 否 | 表示健康检查路径。 | / |
ingress.vke.volcengine.com/loadbalancer-healthcheck-method | String | 否 | 配置健康检查的方法。取值：GET、HEAD。 | GET |
ingress.vke.volcengine.com/loadbalancer-healthcheck-httpcode | String | 否 | 设置健康检查的状态码。取值：http_2xx、http_3xx、http_4xx 和 http_5xx | http_2xx,http_3xx |
ingress.vke.volcengine.com/loadbalancer-healthcheck-timeout | String | 否 | 指定等待健康检查响应的超时时间。
| 2 |
ingress.vke.volcengine.com/loadbalancer-healthcheck-interval | String | 否 | 指定执行健康检查的时间间隔。
| 2 |
ingress.vke.volcengine.com/loadbalancer-healthy-threshold | String | 否 | 健康检查连续成功多少次后，将后端服务器的健康检查状态由 Fail 判定为 Success。
| 3 |
ingress.vke.volcengine.com/loadbalancer-unhealthy-threshold | String | 否 | 健康检查连续失败多少次后，将后端服务器的健康检查状态由 Success 判定为 Fail。
| 3 |
最近更新时间：2026.04.07 14:29:43
这个页面对您有帮助吗？
有用
有用
无用
无用