文档中心

容器服务

请输入

自定义转发规则配置示例

配置返回固定响应

ALB Ingress 支持配置返回固定响应，当请求经过 ALB 时，ALB 可以直接返回固定响应，不向后端服务器继续转发。

注意

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

前提条件

使用限制

操作步骤

通过控制台配置

配置项	说明
转发条件	配置转发条件，包括域名、路径和 HTTP 标头。转发条件允许单独配置，也可以组合配置。当配置多个转发条件组合时，这些转发条件之间是且的关系。例如，假设您在一条转发规则中同时配置了域名和路径，只有同时匹配指定域名和路径的请求，才会匹配这条转发规则。同一转发条件下允许配置多个值，这些值之间是或的关系。例如，假设您在域名转发条件下配置了多个值，当请求的域名匹配其中任何一个值时，即满足该转发条件。
转发动作	转发动作选择返回固定响应，并配置返回内容。 HTTP 响应码：固定响应返回码，支持 2xx、4xx、5xx 系列状态码。响应正文类型：固定响应返回内容格式，支持 text/plain、text/css、text/html、application/javascript 和 application/json。响应正文：固定响应返回的具体内容，取值范围为 0~1024 个字符。

通过 kubectl 命令行配置

ALB Ingress 支持通过 Annotation 配置返回固定响应，示例和注解说明如下：

注意

注解中的{{service-name}}字段必须与spec.rules中配置的后端服务名称对应一致，例如在本例中，正确的注解为ingress.vke.volcengine.com/loadbalancer-actions.service-demo。

ingress.vke.volcengine.com/loadbalancer-actions.{{service-name}}注解中的参数说明如下表所示。

字段	类型	描述	默认值
type	String	自定义转发规则的动作类型，当配置固定响应时，必须配置为FixedResponse。	无
fixedResponseConfig.content	String	固定响应的内容，取值范围为 0~1024 个字符。	无
fixedResponseConfig.contentType	String	固定响应返回内容格式，支持 text/plain、text/css、text/html、application/javascript 和 application/json。	无
fixedResponseConfig.httpCode	String	固定响应返回码，支持 2xx、4xx、5xx 系列状态码。	无

结果验证

查看配置

访问验证

说明

验证功能前，您需要在集群中部署后端应用和服务。本例中以 nginx 镜像，服务提供路径为/为例。部署方式可参见使用 ALB Ingress 实现业务发布。

使用 ALB Ingress 中配置的域名访问服务。其中14.***.***.***为 ALB 公网 IP 地址。

预期结果如下，当访问请求的域名为example.com，原始路径为/时，系统直接返回了固定的响应，并没有向后端服务器转发。

最近更新时间：2026.07.07 10:58:03

这个页面对您有帮助吗？

有用

无用