You need to enable JavaScript to run this app.
文档中心
视频点播

视频点播

复制全文
下载 pdf
回源配置
配置回源参数
复制全文
下载 pdf
配置回源参数

本文为您介绍如何在视频点播中对加速域名配置回源参数。

适用范围

回源参数配置适用于自定义源站加速域名。

功能介绍

配置 CDN 回源请求中包含的参数。默认情况下,CDN 在回源时,回源请求文件的 URL 中包含的参数和用户请求文件的 URL 中包含的参数是一致的。比如用户请求文件的 URL 是 http://www.example.com/volcano.png?version=1。该 URL 包含参数 version。在回源时,CDN 也会包含这个参数。
如果在您的业务场景中,这两边的参数不一致,可以配置回源参数。

说明

目前视频点播仅支持在回源时,保留所有或者删除所有 URL 参数的设置,并且对源站所有文件生效。

预设规则

回源参数配置中有一条预设规则,该条规则对所有文件生效,并且优先级始终最低。如果一个用户请求未匹配您创建的所有规则,这个用户请求就会匹配该预设规则。您无法删除这条预设规则,无法调整其优先级,也无法修改这条规则中的规则类型和规则内容。您仅可以修改该规则中的参数设置配置。

操作步骤

  1. 登录视频点播控制台,进入指定空间。
  2. 选择左侧导航栏分发加速 > 域名管理,进入域名管理页面。
  3. 加速域名页签下,根据您的域名类型,在域名列表中找到您需要配置的域名。
  4. 单击操作列的配置按钮,进入加速域名配置页面,切换回源配置页签。
  5. 单击页面下方的修改配置按钮。
  6. 回源参数配置区域,单击新增按钮,参照配置说明新增规则。
    Image
    Image
  7. 完成配置后,单击保存配置按钮。

配置说明

配置

说明

优先级

表示规则的优先级。当收到用户请求时,CDN 基于规则在列表中出现的顺序,依次处理规则。在处理规则时,CDN 尝试将规则与用户请求匹配。如果任意一条规则匹配了用户请求,CDN 就执行该规则中指定的操作,并停止处理其余规则。除预设规则外,您可以拖动规则调整其在列表中的出现顺序。

规则类型

表示规则中的过滤类型。该配置有以下选项:

  • 文件后缀:表示请求 URL 中的扩展名。
  • 文件目录:表示请求路径中的某个目录。
  • 文件全路径:表示请求 URL。

规则内容

表示规则的内容。内容长度不能超过 1,024 个字符,不能包含以下字符:

  • 双斜杠(//)、空格、美元符号($)、问号(?)

在匹配用户请求时,规则内容不区分大小写。
该配置的额外说明如下:

  • 如果 规则类型文件后缀,规则内容必须是一个或者多个以分号(;)分隔的文件后缀。文件后缀无需以句点(.)开头。例如:png;txt
  • 如果 规则类型文件目录,规则内容必须是一个或者多个以分号(;)分隔的目录路径。目录路径必须以斜杠(/)开头和结尾。例如:/chs/foods/;/us/birds/
  • 如果 规则类型文件全路径,规则内容必须是一个或者多个以分号(;)分隔的文件路径。文件路径必须以斜杠(/)开头,可以包含星号(*)用来表示一个或者多个字符。例如:/chs/foods/local*sets;/us/birds/chickadee

参数设置

表示回源请求 URL 中查询参数的设置方式。该配置有以下选项:

  • 保留全部参数:表示回源请求 URL 中包含用户请求 URL 中的全部查询参数。
  • 删除全部参数:表示回源请求 URL 中不包含用户请求 URL 中的任何查询参数。
  • 添加指定参数:表示回源请求 URL 中包含用户请求 URL 中的全部查询参数,并额外包含 参数内容 中指定的那些查询参数。
  • 保留指定参数:表示如果用户请求 URL 中存在 参数名称 中指定的查询参数,那么回源请求 URL 中包含这些指定的查询参数。
  • 删除指定参数:表示回源请求 URL 中包含用户请求 URL 中的全部查询参数,除了 参数名称 中指定的那些查询参数。
  • 重置指定参数:表示回源请求 URL 中包含用户请求 URL 中的全部查询参数。同时,对于您在 参数内容 中指定的查询参数和参数值,CDN 会执行以下操作:
    • 如果这些查询参数在用户请求 URL 中,CDN 会在回源请求 URL 中将这些查询数的值设置为您指定的值。
    • 如果用户请求 URL 中不包含这些查询参数,CDN 会在回源请求 URL 中添加这些查询参数。

参数名称

表示一个或者多个查询参数,多个查询参数之间使用分号(;)分隔,总长度不能超过 1,024 个字符。查询参数只能包含字母、数字、下划线(_)、逗号(,)、短横线(-)、句点(.)和感叹号(!)。
在匹配请求 URL 中的查询参数时,该配置中的参数是大小写敏感的。
仅当 参数设置删除指定参数保留指定参数 时,该配置会出现。

参数内容

表示一个或者多个键值对,代表查询参数和参数值。
键值对的格式是 key=value,多个键值对之间使用分号(;)分隔,总长度不能超过 1,024 个字符。键值对只能包含除了空格以外的字符。例如:size=12-inch;food=pizza;type=pepperoni
在匹配请求 URL 中的查询参数时,该配置中的参数是大小写敏感的。
仅当 参数设置添加指定参数重置指定参数 时,该配置会出现。

最近更新时间:2026.05.13 17:33:59
这个页面对您有帮助吗?
有用
有用
无用
无用