负载均衡
负载均衡
应用型负载均衡ALB
请输入
- 文档首页
负载均衡用户指南监听器转发规则（标准ALB）创建转发规则（重定向至）-标准版ALB
复制全文
下载 pdf创建转发规则（重定向至）-标准版ALB
文档反馈
问问助手当请求满足指定的转发条件时，ALB 对请求进行重定向。例如，将 HTTP 请求重定向为 HTTPS 请求，将原域名的请求重定向到新的域名。
前提条件
- 已创建 ALB 实例，详见创建实例。
- 已创建监听器，详见创建监听器。
操作说明
- 若需将监听器的全部请求重定向，您可以将转发规则的域名配置为空，URL 路径设置为~/，转发动作选择 “重定向至”。
- 配置重定向参数时，需修改以下参数中的至少一个以避免重定向循环：协议、域名、端口和 URL。当请求协议与重定向协议不同时，请确保配置正确的端口、更新相关的服务器配置，以避免重定向失败。
- 如果请求中的 Content-Length 头部的值超过了监听器上设置的最大请求体大小（client_max_body_size），ALB 会直接返回 413 状态码给客户端，不会再执行重定向动作。关于如何调整监听器上设置的最大请求体大小，请参考个性化配置。
操作步骤
- 登录ALB控制台。
- 在左侧导航树中，选择实例管理。
- 单击目标ALB实例右侧的配置监听器按钮。
- 在监听器页签中，单击目标监听器右侧的编辑转发规则按钮。
- 在转发规则页签中，单击 添加转发规则。
- 在添加转发规则页面，参照以下说明配置相关参数。
- 配置转发条件
- 参数说明域名指定一个或多个域名。当您指定多个域名时，这些域名之间是“或”的关系。
- 域名不区分大小写。指定的域名需遵守以下规范：
- 仅允许英文字母、数字和以下特殊字符：. - _ *。
- 须至少包含一个半角句号（.），但不能以半角句号（.）作为开头和结尾。
- 支持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 功能正在邀测中，如需试用，请联系客户经理。
- 配置转发动作
- 限速（可选）
- 当请求数量超过配置的 QPS 时，ALB 会拒绝超出限制的请求。
-
- 参数
说明QPS配置QPS。- 当客户端请求数量超过配置的 QPS 时，ALB 会拒绝超出限制的请求，并返回 503 状态码给客户端。
- 限速功能默认关闭。当您开启该功能后，您需要输入 QPS 的值。取值范围：100~150000。
- 重定向至
说明
除了限速以外，重定向至不建议与其他转发动作搭配使用。例如：与跨域配置搭配时会产生冲突，与写入 Header 配置搭配时不生效。
- ALB 对请求进行重定向。例如，将 HTTP 请求重定向为 HTTPS 请求，将原域名的请求重定向到新的域名。
- 参数说明协议选择用于重定向的协议。协议可以是 HTTPS 或 HTTP。当请求满足指定的转发条件时，请求会被重定向。域名指定请求被重定向到的域名。
- 如果您不指定域名，重定向到的域名与请求的域名相同。
- 域名需遵守以下规范：
- 仅允许英文字母、数字、半角句号（.）和连字符（-）。
- 须至少包含一个半角句号（.），但不能以半角句号（.）作为开头和结尾。
- 域名的每一级开头和结尾不能是连字符（-）。
- 最多允许 128 个字符。
- 必须是符合域名规范的精确域名，例如 www.test.com。
端口指定请求被重定向到的端口。端口范围为 1～65535。如果您不指定端口，重定向到的端口与请求端口相同。URI指定请求被重定向到的路径。- 如果您不指定路径，重定向到的路径与请求路径相同。
- 路径需遵守以下规范：
- 必须以正斜线（/）开头。
- 最多允许 128 个字符。
- 仅允许英文字母、数字和以下特殊字符：- _ / . % ? # &＝。不允许使用连续的正斜线（/）。
- 支持精确路径和正则表达式：
- 精确路径
- 输入规范：
- 必须以正斜线（/）开头。
- 仅允许英文字母、数字和以下特殊字符： - _ / . % ? # * & ＝。不允许使用连续的正斜线（/）。
- 默认为精准匹配，也支持星号（*）和半角问号（?）作为通配符使用。
- 最多允许 128 个字符。
- 取值示例：
- 精准匹配：路径配置为/api/v1/users，请求/api/v1/users可匹配成功。
- 前缀匹配：路径配置为~^/api/.*，请求/api/v1/users和/api/v2均可匹配成功。
- 正则表达式
- 输入规范：
- 值必须以波浪号（~）开头，且波浪号（~）只能出现一次。
- 仅允许英文字母、数字和以下特殊字符：. - _ / ＝ ? ~ ^ * $ : ( ) [ ] + |。
- ~ 开头表示区分大小写。~* 开头表示不区分大小写。
- 取值示例：~^/api/v[0-9]+/users/.*$
- 若您在转发条件指定的路径中使用圆括号( )创建了捕获组，则可以在转发动作指定的路径中使用${1}、${2}、${3}等占位符。这些占位符与捕获组按顺序对应，${1} 表示第一个捕获组，${2} 表示第二个捕获组，以此类推。在处理请求时，ALB 会将这些占位符替换为相应捕获组匹配到的路径片段。例如，假设转发条件中指定的路径为/volc/(.*)/(.*)/aaa，转发动作中指定的路径为/${1}/${2}。如果请求路径为/volc/ccc/bbb/aaa，ALB 会将 ${1} 替换为 ccc，将 ${2} 替换为 bbb。最终的重定向路径为/ccc/bbb。
查询指定重定向目标 URL 的查询字符串，即 URL 中 ? 后面 xxx=xxx 部分。示例：www.test.com/test/?city=beijing 中的 city=beijing。- 若不指定查询字符串，重定向时自动沿用原请求的查询字符串。
- 自定义查询字符串需遵守以下规范：
- 最大长度 128 个字符；
- 不允许包含空格及 #[]{}\|<>" 字符；
- 英文字母仅允许使用小写。
状态码选择重定向响应的状态码，默认为 301。- 301：永久重定向，浏览器会缓存该跳转。适用于域名更换、HTTP 强制跳 HTTPS 等场景。
- 302：临时重定向，不缓存。适用于临时维护、灰度切流。
- 307：临时重定向，严格保持原请求方法和请求体。
- 308：永久重定向，严格保持原请求方法和请求体。
说明201/302 可能被浏览器将 POST 请求转为 GET；如需保留 POST 方法和请求体，请选择 307 或 308。
- 其他参数
- 参数说明描述输入转发规则的描述信息。描述需遵守以下规范：
- 不能超过 255 个字符。
- 必须以英文字母或汉字开头。
- 只能包含英文字母、汉字、数字、空格以及以下特殊字符,._=-，。。
- 单击确定按钮，完成操作。
最近更新时间：2026.10.09 11:32:57
这个页面对您有帮助吗？
有用
有用
无用
无用