有奖捉虫:云通信与企业服务文档专题,速来> HOT
如果您有自建源站和直播源内容,并且需要通过腾讯云进行直播播放,可以通过为云直播播放域名设置源站信息来回源拉取直播内容。配置成功后,您可通过云直播回源拉流并进行直播内容分发。本文档将指导您如何设置源站信息。

注意事项

配置好相关信息后,回源模式设置保存成功后预计在1小时内生效。请耐心等待。回源模式开启后。仅支持播放源站直播流,无法通过推流方式进行直播。
开启源站配置功能后,该播放域名不支持通过 StreamName 匹配其他推流域名进行拉流,而且该域名无法使用水印、转码、录制、截图、鉴黄等功能。

前提条件

已登录 云直播控制台
已搭建直播源站。
已添加播放域名

回源配置

若您需要修改域名源站基本信息、回源请求协议、回源 Host 头部等信息,可在回源配置部分进行相关操作。
1. 进入 域名管理,单击需配置的播放域名或右侧的管理进入域名详情页。


2. 域名管理/域名旁,单击

,可打开或关闭回源模式



3. 当回源模式开启时,可在回源配置中进行编辑。

基本配置说明

源站信息

源站信息
说明
回源协议
支持 RTMP、HTTP-FLV、HLS 格式协议。
HTTPS 回源
当回源协议为 FLV 和 HLS 时,可开启 HTTPS 回源。
开启 HTTPS 回源后,源站地址配置固定为443端口。默认支持重定向链接后 HTTPS 回源,重定向后 HTTPS 回源不限制端口。
主源站地址
支持主备源站,轮询回源。源站地址支持 IP 或域名形式。
备源站地址
备源站地址,可选填。
回源Host头部
不配置时默认使用源站地址作为 Host 头部。





源站 Host 头部
当回源协议为 FLV 或 HLS 时,可配置回源 HTTP Host 头部,即回源域名。腾讯云节点在回源时,访问的源站 IP 地址下具体的站点域名。不配置时默认使用源站地址作为 Host 头部。
配置说明
源站地址和回源 Host 头部的区别如下:
源站地址:决定回源时请求到的具体 IP 地址。
回源 Host 头部:决定回源请求访问到该 IP 地址上的具体站点。
配置实例
1. 若源站配置如下,假设播放域名 xx001.elementtest.org 配置如下:



2. 则用户访问路径如下: 用户访问资源 http://xx001.elementtest.org/index.m3u8,此时腾讯云节点尚未缓存该资源,则腾讯云节点回源是针对 test001.com 域名进行解析,得到源站服务器地址,假设为1.1.1.1,则访问1.1.1.1服务器,在其上的 Web 服务器 test002.com 路径下,找到 index.m3u8 文件,返回给用户。

转封装配置

回源协议为 RTMP 或 HTTP-FLV 时,支持开启 HLS 转封装。HLS 播放地址与 RTMP 和 HTTP-FLV 播放地址的对应关系:
RTMP 格式:rtmp://播放域名/AppName/StreamName
FLV 格式:http://播放域名/AppName/StreamName.flv
M3U8 格式:http://播放域名/AppName/StreamName.m3u8

配置说明

M3U8 文件包含分片数:默认为3个,可配置3个-10个。
HLS 分片时长:默认为3秒,可配置3秒-10秒,实际生成的分片时长不会小于 GOP 时长。




HTTP 相关配置

当回源协议为 HLS 时,可在配置 HTTP 相关配置
HTTP 相关配置
说明
回源重定向
腾讯云节点不缓存301/302状态码。当源站返回301/302状态码后,腾讯云节点默认会主动跟随跳转,直至获取所需资源(最多可跟随10次),返回实际的资源给用户端,用户端无需跳转。
关闭回源重定向后,节点在回源时收到301/302状态码时将响应返回给用户端,由用户端重定向到对应的资源进行访问。
回源 URL 参数透传
回源默认不透传请求 URL 参数。开启后透传请求 URL 参数。不做 URL 编码解码。
回源 HTTP 头部透传
回源默认不透传请求 HTTP 头部。开启后支持透传回源请求的 HTTP 头部,不支持重复头部,不区分大小写。
响应 HTTP 头部透传
源站响应 HTTP 头部默认不透传到客户端。开启后支持透传源站响应的 HTTP 头部,支持重复头部,区分大小写。
支持 OPTIONS 请求
默认支持 Get 请求,开启后支持 Option 请求。




缓存配置

当回源协议为 HLS 时,可配置缓存配置。正常情况下,腾讯云节点成功从源站拉取到所请求的资源(200状态码)时,将按照索引缓存时间和分片缓存时间配置进行缓存处理。
缓存配置
说明
索引缓存时间
源站返回200状态码时m3u8索引文件的缓存时间,默认1000ms,最大不超过60000ms。
分片缓存时间
源站返回200状态码时ts/m4s/mp4分片文件的缓存时间,默认10000ms,最大不超过60000ms。
状态码缓存时间
根据配置缓存对应的状态码,缓存时间内收到相同请求时,无需访问源站,直接返回该状态码。默认缓存时间为1s。
若源站无法迅速响应非200状态码,且不希望所有请求全部透传回源站,可通过配置状态码缓存过期时间,由腾讯云节点直接响应非200状态码,减轻源站压力。
不区分文件类型,当前支持以下状态码:
4XX:400、403、404、405。
5XX:500、503、504。
缓存键规则配置
配置缓存键规则,保留对资源内容有影响的参数作为缓存键,将同一资源的一类请求转化为统一的缓存键并命中同一份缓存,以提升命中率。
文件类型
选择文件类型,可选索引或分片,默认为索引。
保留指定参数
仅可输入英文、字符和数字,多个参数间以“;”分隔。
支持最多 30 组参数,每个参数名不得超过 20 个字符。
若指定了某个参数,即使该参数没有 value 值,也会独立于相同参数有 value 值的参数单独缓存下来。
注意:
需开启 HTTP 相关配置中的回源URL参数透传后再配置缓存键规则。




回源 URL 重写配置

当回源协议为 HLS 时,可配置回源URL重写配置。 若您需要将实际回源的 URL 修改为与源站匹配的 URL,腾讯云为您提供了回源 URL 重写配置功能。目前仅支持重写回源 URL 路径。

配置说明

待重写回源 URL:使用前缀匹配的方式,例如:待重写回源 URL 为 /test01,则将匹配 /test01 下路径下的所有请求。暂不支持正则匹配。
目的回源 URL:使用前缀匹配的方式,例如:目的回源 URL 为 /test01/test02,则将 /test 下路径下的所有请求改写为 /test01/test02。暂不支持正则匹配。




配置约束

单个播放域名最多可添加10条重写规则。
重写规则不支持以下14个特殊字符:" ", "<", ">", """, "#", "{", "}", "|", "&quot;, "^", "~", "[", "]", "&#96"。
多条规则支持调整优先级:顶部优先级大于底部。

其他配置

其他配置
说明
回源超时时间
指 TCP 指 TCP 建连的超时时间,默认配置为10000ms。访问源站的 TCP 连接超时时间,可配置2000ms-60000ms。
回源超时时间较短的情况下,可能因偶发性的网络原因出现回源失败的情况,导致频繁切换源站。回源超时时间设置过长时,可能无法及时切换源站,导致客户端播放异常。建议您可以根据源站数据处理情况及网络情况,调整回源 TCP 连接超时时间,保障正常回源。
最大重试次数
指回源失败最大的重试次数。若配置多个源站地址,回源失败后会切换源站地址重试。
回源失败的最大重试次数。可配置为1-10次。