当请求满足指定的转发条件时，请求会被转发到该服务器组。 ## **前提条件** * 已创建 ALB 实例，详见[创建实例](https://docs.volcengine.com/docs/6406/113664)。 * 已创建监听器，详见[创建监听器](https://docs.volcengine.com/docs/LoadBalancer/Managingalistener)。 * 已创建服务器组并添加后端服务器，详见[创建和管理服务器组](https://docs.volcengine.com/docs/LoadBalancer/Creatingandmanagingaservergroup)。 ## 操作说明 * 转发至、重定向至、返回固定响应三者必须且仅支持有一个，且必须在其他转发动作之后。 * 只能选择与当前 ALB 实例处于同一 VPC 下的服务器组。 * 在一条自定义转发规则中，您最多可以添加 5 个服务器组。 * 若转发动作添加了限速，那么限速必须在最前面。 ## 操作步骤 1. 登录[ALB控制台](https://console.volcengine.com/alb)。 2. 在左侧导航树中，选择**实例管理**。 3. 单击目标ALB实例右侧的**配置监听器**按钮。 4. 在**监听器**页签中，单击目标监听器右侧的**编辑转发规则**按钮。 5. 在**转发规则**页签中，单击 **添加转发规则**。 6. 在**添加转发规则**页面，参照以下说明配置相关参数。 1. **配置转发条件** |参数 |说明 | |---|---| |域名 |指定一个或多个域名。当您指定多个域名时，这些域名之间是“或”的关系。

* 域名不区分大小写。指定的域名需遵守以下规范：

* 仅允许英文字母、数字和以下特殊字符：`. - _ *`。

* 须至少包含一个半角句号（.），但不能以半角句号（.）作为开头和结尾。

* 支持1～128 个字符。

* 域名可以是精确域名，也可以是泛域名：

* 精确域名：须符合域名规范。

* 泛域名

* 星号（\*）可以代替 1 个或多个字符。

* 星号（\*）必须在域名开头或结尾。

* 一个域名中最多只能包含一个星号（\*）。

* 星号（\*）前后不能有除了半角句号（.）以外的字符。

* 示例：

* 合法域名示例：`www.test.com`、`*.com`、`www.test.*`。

* 非法域名示例： `*aaa.com`、`www.*.com`。

> **注意**

> 泛域名只用于匹配与其同级别的域名。例如，\*.example.com 可以匹配 www.example.com，但不能匹配 example.com、www.abc.example.com。
| |URL 路径 |指定一条或多条路径。当您指定多条路径时，这些路径之间是“或”的关系。

* 路径长度支持0～128 个字符。

* 支持精确路径和正则表达式：

* 精确路径

* 输入规范：

* 值必须以正斜线（/）开头。

* 仅允许英文字母、数字和以下特殊字符： `- _ / . % ? # * & ＝`。

* 正斜线（/）不能连用。

* 默认为精准匹配，也支持星号（\*）和半角问号（?）作为通配符使用。

* 取值示例：

* 精准匹配：路径配置为`/api/v1/users`，请求`/api/v1/users`可匹配成功。

* 前缀匹配：路径配置为`~^/api/.*`，请求`/api/v1/users`和`/api/v2`均可匹配成功。

* 正则表达式

* 输入规范：

* 值必须以波浪号（~）开头，且波浪号（~）只能出现一次。

* 仅允许英文字母、数字和以下特殊字符：`. - _ / ＝ ? ~ ^ * $ : ( ) [ ] + \|`。

* `~` 开头表示区分大小写。`~*` 开头表示不区分大小写。

* 取值示例：`~^/api/v[0-9]+/users/.*$` | |HTTP 标头 |设置 HTTP 标头。HTTP 标头以**键值对**形式表示。每个键可以对应多个值，这些值之间是“或”的关系。同一条转发规则内，键必须唯一。如果您需要添加多个 HTTP 标头，单击**添加转发条件**。

* 输入的键需遵守以下规范：

* 仅允许英文字母、数字、连字符（\-）和下划线（_）。

* 不能为 “Cookie” 和 “Host”。

* 支持1～40 个字符。

* 输入的值需遵守以下规范：

* 允许可打印的 ASCII 字符。

* 不能以空格作为开头和结尾。

* 支持1～128 个字符。 | |HTTP 请求方法 |选择一个或多个 HTTP 请求方法。当您选择多个请求方法时，这些请求方法之间是“或”的关系。

支持以下请求方法：HEAD、GET、POST、OPTIONS、PUT、PATCH、DELETE。 | |查询字符串 |设置查询字符串。查询字符串以键值对形式表示。同一个转发条件下，多个键值对之间是“或”的关系。多个转发条件下，键值对之间为“且”的关系。同一条转发规则内，键值对必须唯一。

* 输入的键需遵守以下规范：

* 允许英文小写字母、数字和除了`#[]{}\|<>&"`以外的可打印特殊字符。

* 不能包含空格。

* 支持1～100 个字符。

* 输入的值需遵守以下规范：

* 允许英文小写字母、数字和除了`#[]{}\|<>&"`以外的可打印特殊字符。

* 不能包含空格。

* 支持1～128 个字符。 | |Cookie |添加一个或多个Cookie。

* 输入的Cookie 键需遵守以下规范：

* Cookie 键不能为空。

* 支持 1~100 个字符。

* 支持可见字符和通配符星号（\*）和半角问号（?），如果是字母必须为小写字母。

* 不支持空格和`;#[]{}\|<>&"`。

* 不能全由`*`和`？`组成。

* 输入Cookie 值需遵守以下规范：

* Cookie 值不能为空。

* 支持 1~100个字符。

* 支持可见字符和通配符星号（\*）和半角问号（?），如果是字母必须为小写字母。

* 不支持空格和`;#[]{}\|<>&"`。

* 不能全由`*`和`？`组成。

> **说明**

> 转发条件添加Cookie的功能正在邀测中，如需试用，请联系客户经理。
| |SourceIP |仅匹配到SourceIP的请求才能被转发。

* 仅支持输入IPv4地址/IPv4地址段，且IP地址必须带掩码。

* 不支持0.0.0.0/x类型的地址段，x为任意数字。

* 转发条件中包含SourceIP，只有请求来源匹配到SourceIP地址段或地址的请求才能匹配到该规则。

* 一条规则SourceIP类型条件最多支持5个值。

> **说明**

> 转发条件添加SourceIP的功能正在邀测中，如需试用，请联系客户经理。
| 2. **配置转发动作** * **可选转发动作** **限速** 当请求数量超过配置的 QPS 时，ALB 会拒绝超出限制的请求。 |参数 |说明 | |---|---| |QPS |配置QPS。

* 当客户端请求数量超过配置的 QPS 时，ALB 会拒绝超出限制的请求，并返回 503 状态码给客户端。

* 限速功能默认关闭。当您开启该功能后，您需要输入 QPS 的值。取值范围：100~150000。 | **重写** ALB 改写请求路径或域名，然后使用新路径或域名向后端服务器转发请求。 |参数 |说明 | |---|---| |路径 |指定新的路径。当请求满足指定的转发条件时，请求会被转发到新的路径。路径需遵守以下规范：

* 路径长度不能超过 128 个字符。

* 路径必须以正斜线（ / ）开头。

* 路径中只能包含英文字母、数字和以下特殊字符：`- _ / . % ? # &＝`。不允许使用连续的正斜线（/）。

* 若您在转发条件指定的路径中使用圆括号`( )`创建了捕获组，则可以在转发动作指定的路径中使用`${1}`、`${2}`、`${3}`等占位符。这些占位符与捕获组按顺序对应，${1} 表示第一个捕获组，${2} 表示第二个捕获组，以此类推。在处理请求时，ALB 会将这些占位符替换为相应捕获组匹配到的路径片段。例如，假设转发条件中指定的路径为`/volc/(.*)/(.*)/aaa`，转发动作中指定的路径为`/${1}/${2}`。如果请求路径为`/volc/ccc/bbb/aaa`，ALB 会将 ${1} 替换为 ccc，将 ${2} 替换为 bbb。最终的转发路径为`/ccc/bbb`。 | |域名 |指定新的域名。当请求满足指定的转发条件时，请求会被转发到新的域名。域名需遵守以下规范：

* 不填默认与原请求域名一致。

* 主机名长度为 3~128 个字符，支持小写字母 a~z、数字、短划线（\-）、半角句号（.）以及通配符星号（\*）、等号（=）、波浪线（~）、下划线（_）、加号（+）、反斜线（\）、脱字号（^）、感叹号（!）、美元符号（$）、和（&）、竖线（\|）、半角圆括号（()）、方括号（[]）和半角问号（?）。

* 主机名至少包含一个半角句号（.），且半角句号（.）不能出现在开头或结尾。

* 最右侧的域标签只能包含字母和通配符，不能包含数字或短划线（\-），最左侧的域标签允许是星号（\*）。

* 短划线（\-）不能出现在其它域标签的开头或结尾。通配符星号（\*）和半角问号（?）可以出现在域标签的任意位置。 | **跨域** 客户端请求的协议、域名、端口中任意一个与服务器返回页面的地址存在差异，即为跨域。 > **说明** > 跨域转发动作正在邀测中，如需试用，请联系客户经理。 |参数 |说明 | |---|---| |允许的访问来源 |设置允许通过浏览器访问服务器资源的站点。

* 支持配置通配符“\*”，也允许配置多个值，以逗号分隔，最多设置32个值。

* 每个值必须以http://或者https://开头，后跟一个域名或者一级的泛域名(\*.test.abc.example.com)。

* 每个值支持设置端口，端口范围 1~65535。 | |允许的方法 |选择跨域访问时允许的HTTP方法。

* 支持GET、POST、PUT、DELETE、HEAD、OPTIONS、PATCH。

* 支持多选。 | |允许的请求头部 |除了浏览器内置的基础Header，设置跨域访问时允许的Header。

* 可以配置通配符“\*”，也允许配置多个值，以逗号分隔，最多设置32个值。

* 每个值只允许大小写字母、数字以及不在首尾的"\-"和"_"，最长32个字符。 | |允许的响应头部 |允许浏览器、JavaScript脚本访问的响应头部

* 可以配置通配符“\*”，也允许配置多个值，以逗号分隔，最多设置32个值。

* 每个值只允许大小写字母、数字以及不在首尾的"\-"和"_"，最长32个字符。 | |允许携带凭证 |跨域访问时是否允许携带凭证信息。

* 允许

* 不允许 | |浏览器缓存时间 |设置浏览器缓存 CORS 预检结果的时长，单位为秒。取值范围 \-1~172800（最长 48 小时）。

* \-1：不缓存，每次跨域请求前都重新发送 OPTIONS 预检。

* 正整数：预检结果缓存时长，缓存期内浏览器不再发送 OPTIONS，直接发起实际请求。 | **写入Header** 在请求头里新增一条` 键：值` 数据，随请求一起发给后端服务器。 |参数 |说明 | |---|---| |键 |输入头字段的名称。

* 长度为 1~40 个字符，支持大小写字母 a~z、数字、下划线（_）和短划线（\-）

* 字段名称不能重复。

* 无论大写还是小写，不支持： x\-real\-ip，x\-forwarded\-for，x\-forwarded\-proto，x\-alb\-waf\-requestid，x\-alb\-waf\-real\-port，upgrade，connection，x\-vport，x\-vip，x\-clb\-cluster，x\-toutiao\-lb\-ip，x\-vni，content\-length，transfer\-encoding，keep\-alive，host，cookie，authority。 | |值类型 |头字段内容类型。取值如下：

* 自定义：您自定义头字段内容。

* 系统定义：系统定义头字段内容。 | |值 |输入头字段的内容。

* 值类型选择系统定义时，系统自动在头字段写入内容，可选的内容如下：

* $remote_addr（客户端IP地址）

* $remote_port（客户端端口）

* $scheme（请求协议）

* $load_balancer_id（ALB实例的ID）

* $vport（监听端口）

* $endpoint_id（终端节点ID）

> **说明**

> $endpoint_id参数正在邀测中，如需试用，请联系客户经理。

* 值类型选择自定义时，您可自定义头字段内容，需遵循以下规范：

* 限制长度为 1~128 个字符。

* 支持通配符星号（\*）、半角问号（?）和 ASCII 码值`ch >= 32 && ch < 127`范围内的可打印字符，不支持`$`，不支持`"`。

* 开头和结尾不能为空格。

* 结尾不能为`\`。 | * **转发至** ALB 将请求转发至您指定的服务器组。 |参数 |说明 | |---|---| |后端服务器组 |选择请求被转发到的服务器组。

* 只能选择与当前 ALB 实例处于同一 VPC 下的服务器组。

* 当请求满足指定的转发条件时，请求会被转发到该服务器组。

* 在一条自定义转发规则中，您最多可以添加 5 个服务器组。

* 当添加多个服务器组时，您可以为每个服务器组分别设置权重。服务器组的默认权重为 100，您可以将权重修改为 0 至 100 范围内的任意值。当服务器组的权重设为 0 时，表示 ALB 不会转发客户端流量至该服务器组。 | |服务器组间会话保持 |是否开启服务器组间会话保持。仅配置多个后端服务器组时，可以配置此参数。

* 若开启了服务器组间会话保持，则 ALB 通过 Cookie 把同一客户端的请求固定到同一服务器组：首次命中后在响应中植入 Cookie，后续请求携带该 Cookie 即回原服务器组。会话保持优先级高于服务器组权重：请求携带 Cookie 时直接命中原服务器组，不再按权重分配。

* 开启此功能后，需要设置超时时间。超时时间的取值范围是 1~86400，默认值是 1000。单位是秒。

* 服务器组间会话保持功能默认关闭。 | 4. **其他参数** |参数 |说明 | |---|---| |描述 |输入转发规则的描述信息。描述需遵守以下规范：

* 不能超过 255 个字符。

* 必须以英文字母或汉字开头。

* 只能包含英文字母、汉字、数字、空格以及以下特殊字符`,._=-，。`。 | 6. 单击**确定**按钮，完成操作。

负载均衡