当观众请求观看直播时，如果当前没有可供观众播放的直播流，视频直播会根据回源配置访问回源地址，从源站（即回源服务器）拉取对应的直播流，并提供给观众观看，这个过程称为回源。您可以根据从源站拉取直播流的时机，按需选择以下回源触发方式：

• 播放触发：仅在有观众请求观看直播时触发回源。适用于按需回源的场景，可以减少源站带宽占用。
• 固定触发：无需等待观众请求观看直播，系统会按配置从源站拉取直播流。适用于需要提前拉流、减少观众开始播放时等待时间的场景。固定触发的回源类型包括固定回源和永久回源：固定回源仅在指定回源时间内回源，永久回源会持续按配置回源，直到您手动删除回源配置。

注意事项 #

• 完成回源配置后，约 3-5 分钟生效。
• 支持配置自有源站或第三方源站的回源地址。触发回源后，视频直播会访问您配置的回源地址，从源站拉取直播流。
• 同一 AppName 不能同时配置播放触发和固定触发的回源配置。
• 如需获取更多回源鉴权配置，请创建工单联系技术支持获取帮助。

前提条件 #

已添加拉流域名。详见添加域名。

操作步骤 #

1. 登录视频直播控制台。
2. 左侧导航栏选择功能配置，右侧页面单击回源配置页签。
3. 在域名空间下拉列表中，选择拉流域名所属的域名空间。您可在域名管理页面查看域名所属的域名空间。
   
4. 按需添加播放触发回源配置或固定触发回源配置。详见添加播放触发回源配置和添加固定触发回源配置。

添加播放触发回源配置 #

1. 选择播放触发页签。
2. 单击添加配置，打开添加播放触发回源配置对话框。
3. 根据页面提示完成以下配置并单击确定。
   
   

   参数	说明
   AppName	视频直播播放地址中的 AppName。例如播放地址为 rtmp://pull.example.com/live/test?authinfo，则 AppName 为 live。 支持填写星号（*）或由 1 到 30 位数字（0 - 9）、大小写字母（A - Z、a - z）、下划线（_）、短横线（-）和句点（.）组成。 填写星号（*）时，表示回源配置对该域名空间内的所有 AppName 生效，即当前域名空间的全局配置。 如果同时为某 AppName 添加了全局配置和单独配置，则默认使用单独配置进行拉流回源。例如，已添加 AppName 为 * 的回源配置 A，又为 AppName live 添加了回源配置 B，则 AppName 为 live 的直播流会优先使用回源配置 B 进行拉流回源。
   回源协议	选择 FLV 或 RTMP。根据视频直播从源站拉取直播流时使用的协议选择。
   回源地址	视频直播从源站拉取直播流时访问的地址。 支持填写源站的域名或 IP 地址作为回源地址，最多支持添加 10 个回源地址。 说明 系统会按照回源地址在列表中的排列顺序依次尝试回源，列表中越靠前的地址优先级越高。如果当前回源地址回源失败，系统会再尝试下一个回源地址。例如先后添加回源地址 A、B 和 C，则优先使用回源地址 A 回源，回源地址 A 失败后再尝试回源地址 B，回源地址 B 失败后再尝试回源地址 C。 如果源站使用非默认端口，必须以域名:端口或 IP:端口的形式配置回源地址，否则系统可能按默认端口访问源站，导致回源失败。
   回源参数	当源站要求回源请求携带额外参数时填写。 支持添加一组或多组 key-value 参数。配置后，视频直播会在回源请求中携带这些参数。例如，源站要求回源请求中携带 token=abc，则可添加 key 为 token，value 为 abc 的回源参数。

4. 配置完成后，可在列表中查看配置结果。
   
5. （可选）单击操作列的编辑或删除，可更新或删除当前回源配置。

添加固定触发回源配置 #

1. 选择固定触发页签。
2. 您可以批量添加回源配置，或添加单个回源配置。
   • 批量添加回源配置
     1. 单击导入配置。
     2. 在弹出的导入配置对话框中，下载导入模板。
        
     3. 根据导入模板，完成以下配置并保存修改。
        
        • App：视频直播播放地址中的 AppName。例如播放地址为 rtmp://pull.example.com/live/test?authinfo，则 AppName 为 live。
        • Stream：视频直播播放地址中的 StreamName。例如播放地址为 rtmp://pull.example.com/live/test?authinfo，则 StreamName 为 test。

          说明

          App 和 Stream 的组合不能与已有固定触发回源配置重复。

        • StartTime 和 EndTime：回源的开始时间和结束时间。Unix 时间戳，单位为秒。

          说明

          • StartTime 和 EndTime 的时间间隔不可超过 7 天。
          • 如需添加永久回源类型的回源配置，请联系技术支持开通该功能。功能开通后，保持 StartTime 和 EndTime 为空，即可添加永久回源类型的回源配置。
        • SrcAddr：回源地址，即视频直播从源站拉取直播流时访问的地址。支持 RTMP、RTMPS、FLV 或 HLS 协议。通常包含协议、源站的域名或 IP 地址，以及源站直播流的 AppName 和 StreamName。如果源站要求回源请求携带额外参数，还需包含查询参数。例如 rtmp://192.*.*.10/live01/test01?token=abc。您最多可为同一路直播流添加 10 个回源地址。添加多个回源地址的方法，详见批量导入固定触发回源配置时，如何为一路直播流添加多个回源地址？。

          说明

          如果源站使用非默认端口，需在源站的域名或 IP 地址后填写端口，例如 rtmp://192.*.*.10:1936/live01/test01?token=abc，否则系统可能按默认端口访问源站，导致回源失败。

     4. 导入修改后的文件。导入后，仅会新增回源配置，不会删除或覆盖已有配置。

        注意

        导入文件中的配置如果与已有固定触发回源配置重复，请先删除导入文件中的重复配置，再进行导入。

   • 添加单个回源配置
     1. 单击添加配置，打开添加固定触发回源配置对话框。
     2. 根据页面提示完成以下配置并单击确定。
        
        

        参数	说明
        AppName	视频直播播放地址中的 AppName。例如播放地址为 rtmp://pull.example.com/live/test?authinfo，则 AppName 为 live。 支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。
        StreamName	视频直播播放地址中的 StreamName。例如播放地址为 rtmp://pull.example.com/live/test?authinfo，则 StreamName 为 test。 支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）和短横线（-）组成，长度为 1 到 100 个字符。 说明 AppName 和 StreamName 的组合不能与已有固定触发回源配置重复。
        回源地址	视频直播从源站拉取直播流时访问的地址。支持 RTMP、RTMPS、FLV 或 HLS 协议。 此处需填写完整的回源地址，通常包含协议、源站的域名或 IP 地址，以及源站直播流的 AppName 和 StreamName。如果源站要求回源请求携带额外参数，还需包含查询参数。例如 rtmp://192.*.*.10/live01/test01?token=abc。 最多支持添加 10 个回源地址。系统会按照回源地址在列表中的排列顺序依次尝试回源，列表中越靠前的地址优先级越高。如果当前回源地址回源失败，系统会再尝试下一个回源地址。例如先后添加回源地址 A、B 和 C，则优先使用回源地址 A 回源，回源地址 A 失败后再尝试回源地址 B，回源地址 B 失败后再尝试回源地址 C。您可点击拖动地址左侧调整地址顺序，或单击地址右侧的置顶将某个地址调整到首位。 说明 如果源站使用非默认端口，需在源站的域名或 IP 地址后填写端口，例如 rtmp://192.*.*.10:1936/live01/test01?token=abc，否则系统可能按默认端口访问源站，导致回源失败。
        回源类型	选择固定回源或永久回源。 固定回源：仅在指定回源时间内回源。适用于只在明确时间段内回源的场景。 永久回源：无需配置回源时间，系统会持续按配置回源，直到您手动删除回源配置。适用于需要长期保持回源的场景。 说明 如需选择永久回源，请联系技术支持开通该功能。
        回源时间	选择回源的开始时间和结束时间，时间跨度最大支持 7 天。仅在该时间段内，系统会按配置回源。 说明 仅在回源类型选择固定回源时显示该字段。

3. 配置完成后，可在列表中查看配置结果。
   
4. （可选）您可以查询、导出、更新或删除回源配置。
   • 通过 StreamName 或回源地址，查询符合条件的回源配置。支持模糊搜索，英文不区分大小写。
   • 单击导出配置，以 CSV 格式导出当前域名空间下的所有回源配置。
   • 单击操作列的编辑或删除，更新或删除当前回源配置。

常见问题 #

批量导入固定触发回源配置时，如何为一路直播流添加多个回源地址？ #

批量导入固定触发回源配置时，如需为同一路直播流添加多个回源地址，可在不同行填写相同的 App 和 Stream，并在 SrcAddr 列分别填写不同的回源地址。

完成导入后，相同 App 和 Stream 下的多个 SrcAddr 会作为同一路直播流的多个回源地址，您最多可以为同一路直播流添加 10 个回源地址。

视频直播会按照回源地址在导入文件的顺序依次尝试回源，越靠前的地址优先级越高。如果当前回源地址回源失败，系统会再尝试下一个回源地址。例如，您为 App live 和 Stream test 依次添加了回源地址 A、B 和 C，则优先使用回源地址 A 回源，回源地址 A 失败后再尝试回源地址 B，回源地址 B 失败后再尝试回源地址 C。

• 回源地址 A：https://example.com/live/demo_stream.flv
• 回源地址 B：https://example.com/live/demo1_stream.flv
• 回源地址 C：https://example.com/live/demo2_stream.flv