本文档介绍如何在火山引擎内容分发网络（CDN）中对加速域名配置回源请求中包含的查询参数。
默认情况下，CDN 在回源请求中包含的查询参数和用户请求的 URL 中包含的查询参数是相同的。比如用户请求 URL 是 http://www.example.com/image.png?version=1。该 URL 包含查询参数 version，参数值是 1。在回源请求的 URL 中，CDN 也会包含 version=1。
如果您需要修改回源请求中包含的查询参数或参数值，您可以配置回源参数。在配置中，您需要创建规则，在规则中定义请求的匹配条件以及回源参数的设置方式。
规则优先级
在规则列表中，每条规则都有一个优先级。数字为 1 的规则优先级最高。在收到用户请求时，CDN 按优先级，尝试将请求与每一条规则中的过滤条件匹配。如果请求满足规则中的过滤条件，CDN 就停止处理其余规则。您可以通过拖拽调整规则的优先级。
预设规则
回源参数配置中有一条预设规则。这条规则对所有文件生效，并且优先级始终最低。如果一个用户请求未匹配您创建的所有规则，这个用户请求就会匹配该预设规则。您无法删除这条预设规则，无法调整其优先级，也无法修改这条规则中的规则类型和规则内容。规则中 参数设置 配置默认是 保留全部参数。您可以修改该配置。
前提条件
要使用本文档中介绍的全部配置项，您加速域名的源站配置模块必须已升级到新版本。参见 新版源站配置模块介绍。
如果您加速域名的源站配置模块尚未升级到新版本，回源参数的配置会有以下限制：
- 您无法添加规则。
- 控制台只有上方描述的预设规则。
- 在这条预设规则中，您仅能设置 参数设置 为 参数设置 或者 删除全部参数。
操作步骤
- 登录 火山引擎内容分发网络控制台。
- 在左侧导航栏，点击 域名管理。
- 在 域名管理 页面，找到需要配置的域名，点击 管理。
页面上方的筛选条件和搜索框可以帮助您快速找到要配置的域名。 - 在页面右上方，点击 回源配置 页签。
- 点击 编辑配置。
- 在 回源参数设置 下方，点击 添加规则。您最多可以添加 50 条规则。
- 参照 配置说明 进行设置。
- 设置完成后，在页面右上方点击 提交编辑。
配置说明
| 配置 | 说明 |
|---|---|
优先级 | 表示规则的优先级。数字 1 的规则优先级最高。
|
规则类型 | 表示规则中的过滤类型。该配置有以下选项：
|
规则 | 表示规则的内容。内容长度不能超过 1,024 个字符，不能包含以下字符：
在匹配用户请求时，规则内容不区分大小写。
|
参数设置 | 表示回源请求 URL 中查询参数的设置方式。该配置有以下选项：
|
参数名称 | 表示一个或者多个查询参数，多个查询参数之间使用分号（;）分隔，总长度不能超过 1,024 个字符。查询参数只能包含字母、数字、下划线（_）、逗号（,）、短横线（-）、句点（.）和感叹号（!）。 |
参数内容 | 表示一个或者多个键值对，代表查询参数和参数值。 |
全路径正则配置示例
| 用户请求 | 指定的全路径正则 | 说明 |
|---|---|---|
/a/bbb/image.png | ^/a{1,2}.*g$ 用于匹配以 | 正则表达式匹配了请求 URL 中的路径。 |
| /aaa/bbb/image.png | /a{1,2}.*g 用于匹配请求路径中的特定字符串。 | 正则表达式匹配了请求 URL 中的路径。 |
/food/aaa/pngs/image.png | 正则表达式匹配了请求 URL 中的路径。 | |
/aaa/bbb/image.png | aaa.* 用于匹配请求路径中的特定字符串。 | 正则表达式匹配了请求路径中的 |
/aaa/bbb/image.png | aaa/.* 用于匹配请求路径中的特定字符串。 | 正则表达式匹配了请求路径中的 |