本文介绍如何在控制台为标准版 ALB 实例创建转发规则。 ## 组成一条转发规则由转发条件和转发动作组成。 |组成 |说明 | |---|---| |转发条件 |**转发条件用于过滤请求。一条转发规则可包含一个或多个转发条件。** |\ | ||\ | |* 标准版 ALB 实例支持的转发条件的类型包括**域名**、**URL路径**、**HTTP 标头**、**HTTP 请求方法、查询字符串、Cookie和SourceIP**。|\ | |* 配置：不同类型转发条件条件可一单独配置，也可以组合配置。|\ | | * 当多个转发条件组合配置时，这些转发条件之间是“且”的关系。例如，假设您在一条转发规则中同时配置了域名和 URL 路径，只有同时匹配配置的域名和 URL 路径的请求被视为匹配这条转发规则。|\ | | * 同一转发条件下允许配置多个值，这些值之间是“或”的关系。例如，假设您在“域名”转发条件下配置了多个值，当请求的域名匹配其中任何一个值时即满足该转发条件。 | |转发动作|**转发动作决定了请求如何被转发。** |\ | ||\ | |* 标准版 ALB 实例支持的转发动作包括“转发至”、“重定向至”、“重写”、“限速”和“返回固定响应”。|\ | |* “限速”和“重写”转发动作必须和“转发至”转发动作一起使用。“限速”、“重写”和“转发至”三者也可以一起使用。当多个转发动作组合配置时，这些转发动作之间是“且”的关系。 | ## 匹配在收到客户端请求时，ALB 会按照转发规则的优先级从高到低来依次进行匹配。 * 同一个监听器下的转发规则之间存在优先级： * 默认转发规则的优先级最低，且优先级不能调整。 * 自定义转发规则的优先级可以调整。 * 优先级的数值越小，优先级越高。在转发规则列表中，转发规则的位置越靠上，优先级越高。 * 默认情况下，新创建的转发规则的优先级高于已有的转发规则。 * 您可以通过以下方式调整自定义转发规则的优先级： * 方式一：输入值。单击**设置优先级**，输入目标值，然后单击**确定**。系统会自动调整转发规则的位置。 * 方式二：拖拽。将鼠标悬停在右上角的设置图标上，然后拖拽卡片到目标位置。在对话框中，确认提示信息，然后单击**确定**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_614d7ac38308addcd3d812e6bfc4eca2.png =665x) 关于转发规则的匹配流程，请参见[转发规则匹配（标准版）](https://www.volcengine.com/docs/6406/113670?lang=zh#944a56e9)。 ## **前提条件** * 已创建 ALB 实例，详见[创建实例](/docs/6406/113664)。 * 已创建监听器，详见[创建监听器](/docs/6406/1158625)。 * 已创建服务器组并添加后端服务器，详见[创建和管理服务器组](/docs/6406/130706)。 ## 使用限制 * 除默认转发规则外，每个实例最多可创建 100 条转发规则。 * 每条转发规则必须满足以下约束： * 至少包含一个转发条件，且所有转发条件的值总数不超过 10； * 必须且仅包含一个**转发至**或**重定向至**转发动作，该转发动作必须位于动作列表最下方； * **限速**动作必须位于转发动作列表最上方； * 限速、重写、跨域不可单独作为转发动作：限速与重写需搭配转发至或重定向至使用；跨域需搭配转发至、重定向至或返回固定响应使用。 * 可通过页面上的向上（↑）、向下（↓）箭头调整转发动作顺序。 ## 操作步骤 1. 登录[ALB控制台](https://console.volcengine.com/alb)。 2. 在**实例管理**页面，找到待配置的 ALB 实例，单击 **操作** 列的 **配置监听器**。 3. 在**监听器**页签，找到待配置的监听器，单击 **操作** 列的 **编辑转发规则**。 4. 在**转发规则**页签，单击 **添加转发规则**。 5. 在**添加转发规则**页面，参照以下说明配置相关参数。 1. **配置转发条件** |参数 |说明 | |---|---| |域名 |指定一个或多个域名。当您指定多个域名时，这些域名之间是“或”的关系。|\ | ||\ | |* 域名不区分大小写。指定的域名须满足以下要求：|\ | | * 仅允许英文字母、数字和以下特殊字符：`. - _ *`。|\ | | * 须至少包含一个半角句号（.），但不能以半角句号（.）作为开头和结尾。|\ | |* 支持1～128 个字符。|\ | |* 域名可以是精确域名，也可以是泛域名：|\ | | * 精确域名：须符合域名规范。|\ | | * 泛域名|\ | | * 星号（\*）可以代替 1 个或多个字符。|\ | | * 星号（\*）必须在域名开头或结尾。|\ | | * 一个域名中最多只能包含一个星号（\*）。|\ | | * 星号（\*）前后不能有除了半角句号（.）以外的字符。|\ | | * 示例：|\ | | * 合法域名示例：`www.test.com`、`*.com`、`www.test.*`。|\ | | * 非法域名示例： `*aaa.com`、`www.*.com`。|\ | ||\ | |:::warning|\ | |泛域名只用于匹配与其同级别的域名。例如，\*.example.com 可以匹配 www.example.com，但不能匹配 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个字符。|\ | | * 支持可见字符和通配符星号（\*）和半角问号（?），如果是字母必须为小写字母。|\ | | * 不支持空格和`;#[]{}\\|<>&"`。|\ | | * 不能全由`*`和`？`组成。|\ | ||\ | |:::tip|\ | |本功能正在邀测中，如需试用，请联系客户经理。|\ | ||\ | |:::| |SourceIP |仅匹配到sourceIP的请求才能被转发。|\ | ||\ | |* 仅支持输入IPv4地址/IPv4地址段，且IP地址必须带掩码。|\ | |* 不支持0.0.0.0/x类型的地址段，x为任意数字。|\ | |* 转发条件中包含SourceIP，只有请求来源匹配到SourceIP地址段或地址的请求才能匹配到该规则。|\ | |* 一条规则SourceIP类型条件最多支持5个值。|\ | ||\ | |:::tip|\ | |本功能正在邀测中，如需试用，请联系客户经理。|\ | ||\ | |:::| 2. **配置转发动作** * **转发至** ALB 将请求转发至您指定的服务器组。 |参数 |说明 | |---|---| |后端服务器组 |选择请求被转发到的服务器组。|\ | ||\ | |* 只能选择与当前 ALB 实例处于同一 VPC 下的服务器组。|\ | |* 当请求满足指定的转发条件时，请求会被转发到该服务器组。|\ | |* 在一条自定义转发规则中，您最多可以添加 5 个服务器组。|\ | |* 当添加多个服务器组时，您可以为每个服务器组分别设置权重。服务器组的默认权重为 100，您可以将权重修改为 0 至 100 范围内的任意值。当服务器组的权重设为 0 时，表示 ALB 不会转发客户端流量至该服务器组。更多信息，请参考[服务器组的权重](/docs/6406/113670#4fae2ffb)。 | |服务器组间会话保持 |是否开启服务器组间会话保持。|\ | ||\ | |* 该参数仅在您配置了多个服务器组时会展示出来。|\ | |* 服务器组间会话保持功能默认关闭。在您开启该功能后，您需要设置超时时间。超时时间的取值范围是 1~86400，默认值是 1000。单位是秒。|\ | ||\ | |更多信息，请参考[服务器组间的会话保持](/docs/6406/113670#bb489866)。 | * **重定向至** ALB 对请求进行重定向。例如，将 HTTP 请求重定向为 HTTPS 请求，将原域名的请求重定向到新的域名。 :::tip * 若需将监听器的全部请求重定向，您可以这样配置转发规则：域名字段为空，路径设置为～/，转发动作选择 “重定向”。 * 配置重定向参数时，须修改以下参数中的至少一个以避免重定向循环：**协议**、**域名**、**端口**和 **URI**。当请求协议与重定向协议不同时，请确保配置正确的端口、更新相关的服务器配置，以避免重定向失败。 * 如果请求中的 `Content-Length` 头部的值超过了监听器上设置的最大请求体大小（`client_max_body_size`），ALB 会直接返回 413 状态码给客户端，不会再执行重定向动作。关于如何调整监听器上设置的最大请求体大小，请参考[个性化配置](/docs/6406/119516)。 ::: |参数 |说明 | |---|---| |协议 |选择用于重定向的协议。协议可以是 HTTPS 或 HTTP。|\ | |当请求满足指定的转发条件时，请求会被重定向。 | |域名 |指定请求被重定向到的域名。|\ | ||\ | |* 如果您不指定域名，重定向到的域名与请求的域名相同。|\ | |* 域名须满足以下要求：|\ | | * 仅允许英文字母、数字、半角句号（.）和连字符（\-）。|\ | | * 须至少包含一个半角句号（.），但不能以半角句号（.）作为开头和结尾。|\ | | * 域名的每一级开头和结尾不能是连字符（\-）。|\ | | * 最多允许 128 个字符。|\ | | * 必须是符合域名规范的精确域名，例如 `www.test.com`。 | |端口 |指定请求被重定向到的端口。端口范围为 1～65535。|\ | |如果您不指定端口，重定向到的端口与请求端口相同。 | |URI |指定请求被重定向到的路径。|\ | ||\ | |* 如果您不指定路径，重定向到的路径与请求路径相同。|\ | |* 路径须满足以下要求：|\ | | * 必须以正斜线（/）开头。|\ | | * 最多允许 128 个字符。|\ | | * 仅允许英文字母、数字和以下特殊字符：`- _ / . % ? # &＝`。不允许使用连续的正斜线（/）。 | |状态码 |选择状态码，用于表示重定向响应状态。|\ | |默认状态码为 301，表示被请求的资源已永久移动到新位置。ALB 支持状态码 301、302、307 和 308。 | * **重写** 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、数字、短划线（\-）、半角句号（.）以及通配符星号（\*）、等号（=）、波浪线（~）、下划线（_）、加号（+）、反斜线（\）、脱字号（^）、感叹号（!）、美元符号（$）、and（&）、竖线（\|）、半角圆括号（()）、方括号（[]）和半角问号（?）。|\ | |* 主机名至少包含一个半角句号（.），且半角句号（.）不能出现在开头或结尾。|\ | |* 最右侧的域标签只能包含字母和通配符，不能包含数字或短划线（\-），最左侧的域标签允许是星号（\*）。|\ | |* 短划线（\-）不能出现在其它域标签的开头或结尾。通配符星号（\*）和半角问号（？）可以出现在域标签的任意位置。 | * **限速** 当请求数量超过配置的 QPS 时，ALB 会拒绝超出限制的请求。 |参数 |说明 | |---|---| |QPS |配置QPS。|\ | ||\ | |* 当客户端请求数量超过配置的 QPS 时，ALB 会拒绝超出限制的请求，并返回 503 状态码给客户端。|\ | |* 限速功能默认关闭。当您开启该功能后，您需要输入 QPS 的值。取值范围：100~150000。 | * **返回固定响应** ALB 直接将您自定义的响应返回给客户端，不再将客户端请求转发给后端服务器。 |参数 |说明 | |---|---| |HTTP响应码 |设置 HTTP 响应状态码。允许设置的响应状态码包括 2xx、4xx 和 5xx。x 可以是 0~9 范围内的任意数字。 | |响应正文类型 |设置响应正文类型。ALB 返回给客户端的响应中会携带 Content\-Type 头部。|\ | |允许设置的响应正文类型包括 text/plain、text/css、text/html、application/javascript 和 application/json。 | |响应正文 |可选。配置响应正文。最大支持 1024 个字符。 | * **跨域** 客户端请求的协议、域名、端口中任意一个与服务器返回页面的地址存在差异，即为跨域。 :::tip 本功能正在邀测中，如需试用，请联系客户经理。 ::: |参数 |说明 | |---|---| |允许的访问来源 |设置允许通过浏览器访问服务器资源的站点。|\ | ||\ | |* 支持配置通配符“\*”，也允许配置多个值，以逗号分隔，最多设置32个值。|\ | |* 每个值必须以http://或者https://开头，后跟一个域名或者一级的泛域名(\*.test.abc.example.com)。|\ | |* 每个值支持设置端口，端口范围 1~65535。 | |允许的方法 |选择跨域访问时允许的HTTP方法。|\ | ||\ | |* 支持GET、POST、PUT、DELETE、HEAD、OPTIONS、PATCH。|\ | |* 支持多选。 | |允许的请求头部 |除了浏览器内置的基础Header，设置跨域访问时允许的Header。|\ | ||\ | |* 可以配置通配符“\*”，也允许配置多个值，以逗号分隔，最多设置32个值。|\ | |* 每个值只允许大小写字母、数字以及不在首尾的"\-"和"_"，最长32个字符。 | |允许的响应头部 |允许浏览器、JavaScript脚本访问的响应头部|\ | ||\ | |* 可以配置通配符“\*”，也允许配置多个值，以逗号分隔，最多设置32个值。|\ | |* 每个值只允许大小写字母、数字以及不在首尾的"\-"和"_"，最长32个字符。 | |允许携带凭证 |跨域访问时是否允许携带凭证信息。|\ | ||\ | |* 允许|\ | |* 不允许 | |浏览器缓存时间 |设置浏览器的缓存时间。取值范围为\-1~172800，单位为秒。 | 3. **其他参数** |参数 |说明 | |---|---| |描述 |输入转发规则的描述信息。描述须满足以下要求：|\ | ||\ | |* 不能超过 255 个字符。|\ | |* 必须以英文字母或汉字开头。|\ | |* 只能包含英文字母、汉字、数字、空格以及以下特殊字符`,._=-，。`。 | 6. 单击**确定**按钮，完成操作。