You need to enable JavaScript to run this app.
导航
回源设置
最近更新时间:2024.10.25 15:35:00首次发布时间:2024.10.25 15:35:00

本文介绍如何在视频点播控制台配置回源规则。

工作原理

您可以在视频点播控制台配置重定向回源规则。当用户请求的媒资在视频点播源站不存在时,视频点播将根据您配置的回源规则重定向至第三方源站获取媒资。重定向回源的具体流程如下图所示。
Image

使用限制

  • 对于同一个点播加速域名仅支持配置一个回源规则。
  • 回源域名仅支持设置为外网域名。

前提条件

创建回源规则

  1. 登录视频点播控制台,进入指定空间。
  2. 单击左侧导航栏系统设置 > 回源设置
  3. 单击创建回源规则
  4. 根据页面提示配置回源规则参数,详见回源规则参数说明
  5. 单击保存

回源规则参数说明

基本信息

参数

说明

回源方式

仅支持设为重定向回源

回源条件

设置回源的触发条件。触发回源需同时满足设置的所有条件。回源条件说明如下:

  • HTTP 状态码:默认勾选且仅支持 HTTP 状态码404
  • 文件名前缀:勾选后需设置文件名前缀,例如 test
  • 文件名后缀:勾选后需设置文件名后缀,例如 example.png

勾选文件名前后缀后,您必须设置相应的信息,该条件才会生效。
假设:

  • 您勾选了文件名前缀文件名后缀并分别设置为 testexample.png
  • 用户访问视频点播空间中的 test***example.png ,但该媒资不存在且服务返回的 HTTP 状态码为 404。

此时,视频点播会提供回源规则中设置的回源地址供用户访问。

来源域名

在下拉框中勾选当前空间下源站为点播存储的点播加速域名。勾选后,对该域名的访问会触发重定向回源。

注意

  • 不支持勾选源站是挂载 TOS 的点播加速域名。
  • 不支持勾选未开启重定向跟随功能的点播加速域名。
  • 一条规则支持最多勾选 20 个来源域名。

回源地址

设置触发回源后需要跳转的回源地址。支持以下设置方式:

  • 添加前后缀:触发回源时,跳转至指定前后缀的文件。文件地址说明如下:
    • 协议:(必填)可选 httphttps。默认为 http
    • 回源域名:(必填)必须为域名格式,不支持 IP 地址。
    • 指定文件名前缀:(选填)设置后,请求源站时,将在对象名的前面添加前缀。最后返回给客户端的对象名称与此前缀无关,仍然是客户端请求的对象名称。
    • 指定文件名后缀:(选填)设置后,请求源站时,将在对象名的后面添加后缀。最后返回给客户端的对象名称与此后缀无关,仍然是客户端请求的对象名称。

    说明

    例如用户请求 aaa.mp4 对象,设置文件名前缀为 bbb,则在源站请求的对象是 bbbaaa.mp4,最后返回给客户端的对象仍然为 aaa.mp4。

  • 跳转固定地址:触发回源时,全部跳转至至固定文件。固定地址说明如下:
    • 协议:(必填)可选 httphttps。默认为 http
    • 回源域名:(必填)必须为域名格式,不支持 IP 地址。
  • 替换文件名前缀:触发回源时,跳转至替换文件名前缀的文件。说明如下:
    • 协议:(必填)可选 httphttps。默认为 http
    • 回源域名:(必填)必须为域名格式,不支持 IP 地址。
    • 替换文件名前缀:(选填)替换前缀需要与回源条件中的文件名前缀搭配使用,此处文件名前缀用于指定需要被替换的对象名前缀,替换前缀用于指定对象名前缀替换后的值。不填写替换后的前缀字段时,相当于截断;不填写替换前的文件名前缀时,相当于添加文件名前缀。最后返回给客户端的对象名称与此前缀无关,仍然是客户端请求的对象名称。

    说明

    例如用户请求 aaa.mp4 对象,设置回源条件文件名前缀为 aa,替换文件名前缀为 bb,则在源站请求的对象为 bba.txt 对象,最后返回给客户端的对象是 aaa.txt。

设置完成后,您可以参考回源地址区域下方的回源地址示例确认回源地址是否设置正确。

注意

  • 只支持添加 1 个回源地址。
  • 如果您选择跳转固定地址,则不支持拉取文件等操作。

高级设置

参数

说明

回源鉴权

默认关闭。开启时,重定向地址将携带签名参数。目前支持 A 类型。开启回源鉴权后,可设置以下字段:

  • 主 KEY:设置一个主密钥。密钥由 6-40 个字符组成,只能包含除了 Delete(ASCII code 127)的可打印 ASCII 字符。
  • 签名参数:设置请求的签名参数名称。默认的签名参数名称是 sign。参数名称的规则说明如下:
    • 不能超过 100 个字符。
    • 大小写敏感。
    • 可以包含字母、数字、下划线 _、中划线 -、句号 .、逗号 ,、感叹号 !
    • 至少包含一个字母或者数字。
    • 不能设为 timestamp
  • 有效时间:设置签名的有效时间,单位是秒。该参数的取值范围是 0-315,360,000。默认有效时间是 1800
  • 时间格式:仅支持十进制(Unix时间戳)

说明

A 类型鉴权方式的工作原理请见 A 类型说明

回源携带请求参数

默认开启。开启时,视频点播会将请求携带的 queryString 透传至源站。

是否回源拉取文件

默认开启。开启时,视频点播会先重定向到源站地址,然后后台异步将文件拉取保存至视频点播源站。开启回源拉取文件后,可设置以下字段:

  • 拉取文件是否携带请求参数:默认关闭。开启时,视频点播在拉取文件时会将请求携带的 queryString 透传至源站。
  • HTTP Header 传递规则:设置视频点播在拉取文件时允许透传的响应头。支持以下选项:
    • 透传所有 HTTP Header:(默认)透传所有 Header,但以下 Header 不会透传:Host、Content-length、Date、Authorization。
    • 透传指定 HTTP Header:指定允许透传的 Header,最多可添加 10 个。
    • 禁止透传所有 HTTP Header:禁止透传所有 Header。
    • 禁止透传指定 HTTP Header:指定禁止透传的 Header,最多可添加 10 个。
  • 新增 HTTP Header:设置 HTTP Header 的 Key 和 Value。设置后,视频点播在拉取文件时会在 Header 中添加该 Key 和 Value,并透传到源站。默认不指定。最多指定 10 个 HTTP Header。不支持指定 Content-Length、Date、Range、Authorization 类型的 Header。
  • 拉取文件生成 Vid:默认开启。开启后,系统为拉取至视频点播源站的音视频生成 Vid。如不生成 Vid,您仅能使用 DirectUrl 模式。
  • 拉取文件后缀规则:默认关闭。开启后,您需要配置不拉取以下后缀只拉取以下后缀。多个后缀间用英文分号分割。
  • 拉取文件吞吐量限制:默认关闭。开启后,您可限制拉取过程的吞吐量,取值范围为 [50,2000],单位为 QPS。
  • 拉取文件速度限制:默认关闭。开启后,您可限制拉取速度,单位为 MB/s。

    注意

    同时设置吞吐量限制和速度限制时,文件拉取将同时受到这两项的影响。

  • 异步拉取跟随源站重定向:默认关闭。拉取文件时,是否跟随源站的 3XX 重定向请求回源,最多可重定向 1 次。
  • 失败拉取不发送回调:默认情况下,从源站拉取文件成功和失败时,系统都会发送 URL 拉取上传完成事件。开启后,从源站拉取文件失败时,系统不会发送这个事件,避免造成干扰。