配置监听转发规则

规则名称

可选，不输入时系统自动生成。

转发条件

选择条件类型添加以下条件，您也可以单击添加转发条件添加多个。

• 域名：添加一个或多个域名。域名匹配规则长度限制为3~128个字符，支持星号（*）和半角问号（?）作为通配符使用（其中*可以代表任何字符串，?仅代表单个字符串），包括精准域名、通配符域名、正则表达式域名。域名配置规则详见转发规则配置示例与域名路径匹配规则。

  • 精准匹配：请求域名与配置域名完全一致，如www.example.com。

  • 通配符匹配：使用*匹配任意长度字符串（包含.），?匹配单个字符，如*.example.com可匹配api.example.com、www.example.com等。

  • 正则表达式匹配：使用正则表达式进行域名匹配，域名匹配不区分大小写。如^www\.example\.(com|cn)$可同时匹配.com和.cn结尾的域名。

• 路径：添加一条或多条路径。包括正则表达式类型的路径和非正则表达式类型的路径。路径配置规则详见转发规则配置示例与域名路径匹配规则。

  • 精准匹配：如/api/v1/users仅匹配完全一致的路径。

  • 通配符匹配：如/api/*匹配所有以/api/开头的路径（包含多级子路径），/*匹配所有路径。路径匹配区分大小写。

  • 正则表达式匹配：如^/api/(.*)/list$匹配以/api/开头且以/list结尾的路径，正则路径匹配时可选择区分或不区分大小写。

• HTTP标头：在键是字段输入HTTP标头的名称，值是字段输入HTTP标头的内容，可添加多条标头内容。HTTP标头的键长度限制为1~40个字符，只允许包含大小写英文字母、数字、下划线（_）和中划线（-），匹配不区分大小写。标头的值长度限制为1~128个字符，支持可打印字符，开头和结尾不能为空格，支持星号（*）和半角问号（?）作为通配符。

  示例：键user-agent，值*Mozilla/4.0*（表示匹配值中包含Mozilla/4.0的所有请求）。

• 查询字符串：添加一个或多个查询字符串的键值对。键的长度为1~100个字符，值的长度为1~128个字符，支持小写字母（输入仅支持小写字母，但实际匹配时不区分大小写）、通配符星号（*）和半角问号（?）等可见字符，不支持空格和#[]{}\|<>&等特殊字符。

  示例：URL为www.example.com/test/test1?x=1&y=2时可配置为x：1或y：2。

• HTTP 请求方法：添加一个或多个HTTP请求方法。包括：HEAD、GET、POST、OPTIONS、PUT、PATCH、DELETE。

• Cookie：添加一个或多个Cookie。键的长度为1~100个字符，值长度为1~128个字符，支持小写字母（输入仅支持小写字母，但实际匹配时不区分大小写）、通配符星号（*）和半角问号（?）等可见字符，不支持空格和[]{}<>\#|&等特殊字符。

  示例：键key，值value。

• SourceIp：添加一个或多个IP地址或者IP地址段，不支持0.0.0.0/x类型的地址段，x为任意数字。

  示例：192.168.1.1/32

转发动作

选择动作类型添加以下动作，您也可以单击添加动作添加多个。

• 转发至：在服务器组列表中选择目标服务器组。目前支持的服务器组类型包括服务器类型、IP类型和函数计算类型。您可以添加多个服务器组，通过设置各服务器组间的权重来控制流量分发比例，单个服务器组权重取值范围为0~100。添加多个服务器组时，还可以开启服务器组间会话保持（该功能需确保所有添加的服务器组开启了会话保持功能）。

  在添加多个服务器组时，支持选择HTTP和HTTPS两种不同后端协议的服务器组。

  单个服务器组的权重上限支持提升至10000，如有需要请联系商务经理申请。

• 重定向至：在协议和状态码列表选择一个协议和一个状态码，以及分别输入跳转的目的域名、端口、路径和查询字符串。该转发动作中协议、域名、端口、路径、查询值不能全部为默认值或为空。

  重定向至中关于路径的增强配置规则，请参见重写和重定向中路径的增强配置规则。

  ${x}表示引用请求中的相应值，如果保持默认，表示使用请求中的默认值。

  关于状态码的更多信息，请参见HTTP协议常用标准状态码说明。

• 返回固定响应：输入响应状态码，然后选择填写响应正文类型（可选）和响应正文（可选）。响应状态码必须是2xx、4xx、5xx的数字型字符串，x为任意数字。

• 重写：在ALB内部将请求的域名、路径或查询修改为指定值后再转发至后端服务器，客户端浏览器地址栏中的 URL 不会发生变化。

  重写动作必须与转发至动作配合使用才能生效。

  重写与重定向至的区别：重写是ALB内部处理，改变后端接收到的路径，客户端 URL 不变；重定向返回 3xx 状态码，客户端浏览器跳转到新 URL。

  简单示例：将/app/page重写为/v2/page，可设置转发条件路径为/app/page（精准匹配），重写路径为/v2/page。如需匹配/app/下所有子路径并重写，请使用正则表达式方式，参见重写和重定向中路径的增强配置规则。

• 写入Header：输入头字段名称和头字段内容，将覆盖请求中已有的头变量。其中标头键长度为1~40字符，支持大小写英文字母、数字、下划线（_）和中划线（-），标头的值长度限制为1~128个字符，支持英文字母、数字及常见标点符号，开头和结尾不能为空格。

• 删除Header：输入头字段名称，将删除请求Header中的该键值对内容。

  请求方向写入Header和删除Header不允许将头字段名称设置为以下字段（不区分大小写）：slb-id、slb-ip、x-forwarded-for、x-forwarded-proto、x-forwarded-eip、x-forwarded-port、x-forwarded-client-srcport、x-forwarded-host、connection、upgrade、content-length、transfer-encoding、keep-alive、te、host、cookie、remoteip、authority。这些字段为ALB系统保留字段或HTTP协议关键字段，修改可能导致请求转发异常或连接中断。

• 限速：请根据需要配置以下参数。

  • QPS(总限速)：输入每秒请求数，取值范围：1~1000000。

  • QPS(基于客户端源IP限速)：输入基于客户端源IP限速，取值范围：1~1000000。同时配置QPS(总限速)和QPS(基于客户端源IP限速)时，基于客户端源IP限速值要小于总限速值。

  限速动作必须与转发至动作配合使用。限速值以内的请求转发至目标服务器组；超出限速值时，默认返回503状态码，也可附加重定向至或返回固定响应动作处理超出限速值的请求。

  开启QPS(基于客户端源IP限速)后，ALB从X-Forwarded-For头字段中获取源IP。如果请求经过多层代理，需要在监听中打开查找真实客户端源IP开关，确保获取到正确的客户端源IP。更多信息，请参见创建监听。

• 流量镜像至：在服务器组列表中选择目标服务器组。支持选择服务器类型和IP类型的后端服务器组。

• 跨域：配置CORS跨域访问策略，ALB自动处理OPTIONS预检请求并返回CORS响应头，无需后端服务器处理。相比通过写入Header动作手动设置Access-Control-Allow-Origin等响应头，跨域动作配置更简单。

  什么是跨域

  客户端发送的请求URL的协议、域名或者端口三者之间任意一个与当前返回的页面URL不同即为跨域。请求包括简单请求和预检请求。跨域动作适用于前后端分离架构等场景，例如前端部署在www.example.com，API服务部署在api.example.com，前端通过浏览器调用API时会触发跨域限制。

  • 允许的访问来源：设置允许通过浏览器访问服务资源的站点。

  • 允许的方法：选择跨域访问时允许的HTTP方法。包括：GET，POST、PUT、DELETE、HEAD、OPTIONS、PATCH。

  • 允许的请求头部：除了浏览器内置的基础Header，设置跨域访问时允许的Header。

  • 允许的响应头部：允许浏览器、JavaScript脚本访问的响应头部。

  • 允许的携带凭证：跨域访问时是否允许携带凭证信息，默认允许。

  • 浏览器缓存时间：对于预检请求，设置OPTIONS预检请求在浏览器的最大缓存时间。单位：秒。取值范围：-1~172800。

规则名称

可选，不输入时系统自动生成。

如果满足以下请求方向条件（选填）：

选择请求方向的转发条件，也可以单击添加请求方向转发条件添加多个。各条件的配置说明请参见请求方向转发规则标签页。

且满足以下响应方向条件

选择响应方向的转发条件，您也可以单击添加响应方向转发条件添加多个。

• 响应中的状态码：返回给客户端响应中的状态码，取值100~599。支持输入范围，多个状态码用半角逗号（,）分隔，例如：200-233,301。

• 响应中的标头：响应中的HTTP标头。在键是字段输入HTTP标头的名称，值是字段输入HTTP标头的内容，可添加多条标头内容。

转发动作

选择响应方向的动作类型，您也可以单击添加动作添加多个。

• 返回固定响应：输入响应状态码，然后选择填写响应正文类型（可选）和响应正文（可选）。响应状态码必须是2xx、4xx、5xx的数字型字符串，x为任意数字。

• 写入Header：输入响应方向头字段名称和头字段内容，将覆盖响应报文中已有的头变量。

• 删除Header：输入响应方向头字段名称，将删除响应报文中对应的键值对内容。

  响应方向写入Header和删除Header不允许将头字段名称设置为以下字段（不区分大小写）：connection、upgrade、content-length、transfer-encoding。这些字段为HTTP协议关键字段，修改可能导致响应传输异常。