文档中心

容器服务

ALB Ingress

通过控制台创建 ALB Ingress

ALB Ingress 基于火山引擎应用型负载均衡（Application Load Balancer，ALB）之上提供更为强大的 Ingress 流量管理方式，满足在云原生应用场景下对大规模七层流量处理稳定性和可用性的需求。

注意

配置 ALB Ingress 前，请务必仔细阅读 ALB Ingress 使用注意事项。

前提条件

（可选）配置 HTTPS 协议的 ALB Ingress 时，需要提前完成证书配置。详情请参见 ALB Ingress 配置 HTTPS 协议。

注意

如需使用证书中心的证书，请首先登录您的火山引擎账号，然后单击服务授权，并在弹出的页面中单击立即授权，完成跨服务授权。

（可选）如需对接 ALB 标准版实例，请将 alb-ingress-controller 组件升级至 v0.35.0 及以上版本。详情请参见升级组件。

（可选）如需配置 ALB 实例的以下功能，请将 alb-ingress-controller 组件升级至 v0.31.0 及以上版本。详情请参见升级组件。

如需为 ALB 配置 WAF 防护功能，需要提前创建 Web 应用防火墙实例。详情请参见创建 WAF 实例。

如需为 ALB 配置访问日志投递功能，需要提前创建日志项目和日志主题。详情请参见日志项目、日志主题。

如需为 ALB 的监听器配置访问控制（ACL）功能，需要提前配置访问控制策略组。详情请参见访问控制。

如需为 ALB 的监听器添加个性化配置，需要提前完成个性化配置。详情请参见个性化配置。

操作步骤

登录容器服务控制台。

单击左侧导航栏中的集群。

在集群列表页面，单击需要配置路由规则的目标集群。

在集群管理页面的左侧导航栏中，选择服务与路由 > 路由规则，单击创建路由规则。

根据如下说明，配置路由规则。

基本配置

参数	说明
名称	根据系统提示，配置路由规则的名称。在同一个命名空间下，名称必须唯一。
命名空间	选择路由规则所属的命名空间。建议选择您自定义的命名空间，或系统默认创建的 default 命名空间。命名空间相关介绍，请参见命名空间概述。
注解	单击添加注解，为路由规则添加注解并配置键值对。也可通过配置路由规则 YAML 文件中特定的注解内容，以实现更加丰富的七层负载均衡能力和更加多样的服务路由规则。详细说明，请参见通过 Annotation 配置 ALB Ingress。

Ingress 配置

参数
说明
ingress 类型
配置 Ingress Controller 的类型，本例中选择应用型负载均衡 ALB。

负载均衡器配置

参数	说明
直通 Pod 模式	仅 VPC-CNI 容器网络模型集群中显示该参数。默认开启，开启后不再通过 NodePort 转发，直接关联 Pod 作为负载均衡器的后端，同时支持健康检查。注意 ALB 负载均衡器允许的后端服务器数有限，需自行规划和保证。详细限制，请参见 ALB 约束限制。
负载均衡器	按需选择已有或自动创建一个负载均衡器。支持公网访问和私网访问两种访问模式。使用已有：支持使用已有的和本集群关联创建的 ALB。复用同一个 ALB 实例时，不覆盖已有的监听器规则，因此请确保监听器的转发规则不冲突。自动创建：自动创建新的 ALB 实例。您需要配置以下参数，详细参数说明，请参见创建应用型负载均衡实例：名称：根据系统提示的命名规则，自定义负载均衡器的名称。实例版本：配置 ALB 实例的版本类型，支持标准版和基础版。不同类型实例支持的功能略有不同，详情请参见 ALB 实例类型概述。子网：为负载均衡器实例提供私网部署环境，分配私网 IP 地址。说明支持选择多可用区的子网，满足容器业务应用的高可用能力。负载均衡器实例创建成功后，不支持修改私网 IP 地址。线路类型：提供公网服务的线路类型，不同类型的线路在性能和计费标准上存在差异，支持 BGP(多线)、融合 BGP、中国移动、中国电信、中国联通。注意除 BGP（多线）外，其他线路类型均为 EIP 产品的邀测功能，如需使用，请联系客户经理申请。计费方式：负载均衡器的计费方式，当前支持如下两种：按量计费-按带宽上限：指定带宽上限后，将按照使用时长计费，与实际流量无关。按量计费-按实际流量：指定带宽上限后，将按照实际使用的出公网流量计费，与使用时长无关。带宽上限：公网 IP 的带宽上限，单位为 Mbps。实例创建后，您可以随时按需调整公网带宽上限。共享带宽包：默认不配置。您可根据实际需求，勾选加入共享带宽包，并选择已经创建的共享带宽包。说明共享带宽包是一种支持复用和共享带宽的云资源。将单个地域内多个公网 IP 或 IPv6 公网带宽添加到一个共享带宽包实例中，共享一条带宽，可以帮助您降低公网带宽的使用成本。详情请参见什么是共享带宽包。 IP 版本：IP 地址版本类型。当前仅支持 IPv4。删除保护：是否开启 ALB 实例删除保护功能。启用后将无法使用控制台或 OpenAPI 直接删除 ALB 实例，可防止误删除。当需要删除 ALB 实例时，需要首先在 ALB 实例的基本信息页面关闭该功能。
访问日志投递 TLS	配置 ALB 实例的访问日志投递功能。启用该功能后，允许将 ALB 实例的日志投递到日志服务（Tinder Log Service，TLS），并支持在 ALB 控制台对访问日志实时检索与分析。单击编辑配置，在弹出的页面中开启日志投递，并指定日志项目和日志主题。
开启 WAF 防护	配置 ALB 实例的 WAF 防护功能，支持基于火山引擎 Web 应用防火墙产品，为 ALB 实例开启域名防护。启用该功能后，WAF 会监测流过 ALB 的流量，对攻击流量进行清洗，提升应用安全性。
后端服务器组	配置接收流量转发的后端服务器组的调度算法和健康检查：调度算法：指定监听器转发请求时需要遵循的规则。加权轮询（WRR）：基于权重值进行流量的分发，权重值越高的后端服务器，被轮询到的次数（概率）越高。加权最小连接数（WLC）：优先将流量分发给当前连接数与权重比值最小的后端。源地址哈希（SH）：基于源 IP 地址的一致性哈希，相同源地址的请求会调度到相同的后端服务器。健康检查：按需选择是否启用健康检查。若启用健康检查，需要配置以下参数：健康检查方法：对后端服务器进行健康检查的请求方法，支持 GET 或 HEAD，默认采用 GET 方法。使用 HEAD 方法，服务器仅返回 HEAD 头部信息，可以降低后端开销，但要求服务器支持 HEAD 方法。使用 GET 方法，要求服务器支持 GET 方法。健康检查域名：配置健康检查域名后，ALB 会将域名配置到 host 字段中；如果没有配置域名，则 host 字段为空，ALB 不会在请求中附带 host 字段，而是默认域名为后端服务器组内网 IP。健康检查路径：健康检查路径默认为/。如果您用来进行健康检查的页面不是应用服务器的默认首页，则需要指定具体的检查路径。正常状态码：如收到此处选中类型的响应码，则判定该服务器为正常状态。默认选中 2xx 和 3xx。响应超时：等待健康检查响应的时间。如果后端服务器在指定的时间内没有正确响应，则判定为健康检查异常。检测间隔：执行健康检查的时间间隔。默认间隔为 2 秒，表示每 2 秒对后端服务器进行一次健康检查。注意检测间隔时间需大于响应超时时间。健康阈值：判断后端服务器正常的健康检查次数。默认为 3 次，表示连续执行 3 次健康检查，结果均为“正常”的后端服务器则判定为健康检查正常。不健康阈值：判断后端服务器异常的健康检查次数。默认为3次，表示连续执行 3 次健康检查，结果均为“异常”的后端服务器则判定为健康检查异常。

监听配置

参数	说明
协议	后端服务器组监听的协议，支持 HTTP 和 HTTPS 协议。创建完成路由规则时，ALB 实例根据您的监听配置，自动创建监听器，名称默认为k8s_<随机生成的字符串>。
HTTP/2	当协议选择 HTTPS 时，支持配置是否开启 HTTP/2。未启用该功能时，监听器将不能处理来自客户端的 HTTP/2 协议请求。
端口号	后端服务器组监听的端口号。若不填写，则 HTTP 协议时，默认监听80端口； HTTPS 协议时，默认监听443端口。
证书	当协议选择 HTTPS 时，需要选择服务器证书，以支持数据传输加密认证。您需要通过创建密钥，绑定服务器证书，默认全部域名使用同一个密钥。在证书来源下拉菜单中选择证书的来源，支持全部来源、应用负载均衡 ALB 或证书中心。在保密字典下拉菜单中选择对应的保密字典，若无保密字典，可以单击创建保密字典创建：名称：根据系统提示的命名规则，设置密钥名称。同一个命名空间下名称须唯一。命名空间：选择与本路由规则相同的命名空间。证书来源：选择加密证书来源，支持应用负载均衡 ALB、证书中心和 TLS 证书。项目：证书来源为应用负载均衡 ALB、证书中心时，需要选择证书所在的项目。服务器证书：证书来源为应用负载均衡 ALB、证书中心时，选择服务器证书。上传证书：证书来源为 TLS 证书时，上传 TLS 证书文件。上传密钥：证书来源为 TLS 证书时，上传 TLS 证书密钥。 ALB Ingress 的 HTTPS 协议除了默认全部域名绑定同一个密钥外，支持单击添加证书，给指定域名使用指定的密钥。若请求的域名与指定域名匹配，则使用该域名指定的密钥；若不匹配指定的域名，则使用默认全部域名使用的密钥。
访问控制	配置 ALB 监听器的访问控制（ACL）功能。单击编辑配置，在弹出的页面中开启访问控制。控制模式：开启监听器访问控制后，需要配置访问控制模式。取值：白名单：该模式下，仅所选策略组内的 IP 地址能访问。黑名单：该模式下，所选策略组内的 IP 地址无法访问。策略组：配置访问策略对应的策略组。说明最多允许选择 5 个策略组。每个策略组最多可以包含 300 个 IP 地址条目。每个 IP 地址条目可以是一个 IP 地址或者一个 CIDR 地址段。关于策略组的更多内容，请参见访问控制。
个性化配置	配置 ALB 监听器的个性化配置。单击编辑配置，在弹出的页面中开启个性化配置，并选择已存在的个性化配置策略。

转发配置

参数	说明
转发规则	请求的访问地址与转发规则匹配时，该请求会被转发到对应的服务（Service）处理。单击添加转发策略，可添加多条转发策略。域名：请求的域名与此处设置的域名匹配时，请求会被转发到指定的服务。注意不支持以*结尾的域名。路径：请求的路径与此处设置的路径匹配时，请求会被转发到指定的服务。支持正则表达式和非正则表达式路径匹配方式，详情请参见匹配正则表达式路径。路径匹配规则：当实例版本选择基础版时，可选择前缀匹配模式，匹配该前缀的所有路径均允许访问。例如映射 URL 为/foo，则/foo/v1，/foo/v2都可以访问后端服务。服务：请求被转发到的目标服务和端口。若无可用服务，请参考服务创建服务。注意当集群的容器网络模型为 Flannel 时，仅支持关联和选择 NodePort、LoadBalancer 类型的服务。当集群的容器网络模型为 VPC-CNI 时：若 Ingress 开启了直通 Pod 模式，则支持关联和选择 NodePort、LoadBalancer、ClusterIP 类型的服务。若 Ingress 未开启直通 Pod 模式，则仅支持关联和选择 NodePort、LoadBalancer 类型的服务。流量限速：【邀测·申请试用】当实例版本选择基础版时，支持配置每秒请求数（QPS），默认关闭。更多配置，请参见配置转发流量限速。
自定义转发规则	当实例版本选择标准版时，支持开启自定义转发规则。启用该功能后，允许基于域名、路径和 HTTP 标头自定义转发规则。转发条件：配置转发条件，支持域名、路径和 HTTP 标头。转发动作：配置转发动作，包括：重写：配置重写转发路径，当请求经过 ALB 时，ALB 可以直接改写请求路径，向后端服务器请求新路径内容。转发至：配置请求被转发到的目标服务、端口和权重。当请求经过 ALB 时，ALB 可以按照权重向不同后端服务进行转发。重定向至：配置重定向规则，包括：协议、域名、端口、URI 和状态码。当请求经过 ALB 时，ALB 可以按照重定向规则，将流量调度到新的目标。返回固定响应：支持自定义返回的固定响应。允许您自定义固定响应的 HTTP 状态码、响应正文类型和响应正文。说明自定义转发规则的配置详情，请参见自定义 ALB Ingress 转发规则。您可以配置多个自定义转发规则，多个转发规则的优先级为从上到下。如需调整转发规则之间的顺序，可以将鼠标悬停在指定的转发规则名称前，当鼠标光标变为时，按住鼠标左键不放，上下拖动即可改变当前转发规则的优先级。

单击确认，创建完成 ALB Ingress 路由规则。

结果验证

配置完成后，您可以在规则列表中查看对应的路由规则。包括该路由规则的命名空间、类型、VIP、监听协议和转发规则。

说明

VIP 为路由规则对应 ALB 实例提供的私网或公网 IP 地址，当需要配置 DNS 解析关系时，您可以绑定域名和该 IP 地址的解析关系。

单击路由规则名称，进入路由规则详情页面。支持查看该路由规则的基本信息、转发规则和事件。

最近更新时间：2026.07.09 17:03:42

这个页面对您有帮助吗？

有用

无用

参数	说明
ingress 类型	配置 Ingress Controller 的类型，本例中选择应用型负载均衡 ALB。