You need to enable JavaScript to run this app.
视频直播

视频直播

Copy page
Download PDF
域名配置
配置 HTTP 响应头
Copy page
Download PDF
配置 HTTP 响应头

视频直播支持为拉流域名配置 HTTP 响应头,配置完成后,所有向此域名发起的请求收到的响应头中均会被添加配置的响应头参数。本文为您介绍 HTTP 响应头的功能介绍和操作步骤。

使用范围

拉流域名

功能介绍

HTTP 响应头是指服务器在发送 HTTP 响应时,在响应体之前发送的一系列头部字段。这些头部字段提供了有关响应的元数据信息,例如响应的状态码、内容类型、缓存控制、Content-Encoding、Content-Disposition 等,同时通过配置合适的 HTTP 响应头可以提高安全性、优化性能、改善用户体验,并满足各种合规要求和与浏览器、搜索引擎的交互需求。
默认情况下,缓存节点在响应用户拉流请求时,会透传源站的响应头。在视频直播中,您可以通过 HTTP 响应头配置,添加或修改响应头参数。

tip

响应头字段匹配不区分大小写,如果原响应头中已存在某字段,新设置字段值将会覆盖原字段值。

前提条件

已完成添加域名

操作步骤

  1. 登录视频直播控制台

  2. 选择左侧导航的域名管理,在域名管理页面单击待配置域名右侧的域名配置,进入域名配置页面。

  3. 选择访问控制页签,在HTTP 响应头模块,打开配置开关或单击编辑配置,弹出 HTTP 响应头设置对话框。
    Image

  4. HTTP 响应头设置对话框自定义或选择已有响应头参数进行配置。
    Image
    支持自定义参数或选择预置参数,常见预置参数说明如下所示。

    预置响应头参数

    说明

    Content-Type

    响应对象的内容类型。

    Cache-Control

    请求和响应应遵循的缓存机制。

    Content-Disposition

    请求所得的内容作为一个文件时提供的默认文件名。

    Expires

    响应对象的过期时间。

    Access-Control-Allow-Origin

    允许跨域访问的来源。
    例如,您的前端页面地址为 https://www.example.com/player/live.html,则该响应头取值应设置为 https://www.example.com

    Access-Control-Allow-Headers

    允许跨域请求携带的请求头。请根据前端实际携带的请求头配置。

    Access-Control-Allow-Methods

    允许跨域请求使用的方法,例如 GET, OPTIONS

    Access-Control-Max-Age

    跨域请求前校验结果的缓存时间。单位为秒。

    Access-Control-Expose-Headers

    允许前端读取的响应头。请根据前端实际需要读取的响应头配置。

    如果您的前端页面在播放直播流时遇到跨域问题,请根据前端请求的实际情况为拉流域名配置跨域相关的 HTTP 响应头。通常需要配置 Access-Control-Allow-OriginAccess-Control-Allow-Methods,再按需配置其他响应头。
    支持使用常量或预置变量对参数赋值,支持使用的变量值说明如下所示。

    参数值变量

    说明

    ${domain}

    客户端拉流请求中使用的域名。

    ${uri}

    客户端拉流请求中不包括查询参数的路径。如果请求被重写,则表示重写后的路径。

    ${args}

    客户端拉流请求中的查询参数。如果请求被重写,则表示重写后的参数。

    ${remote_addr}

    发送拉流请求的客户端 IP 地址。

    ${server_addr}

    响应客户端拉流请求的边缘服务器的 IP 地址。

  5. 单击确定

Last updated: 2026.06.01 15:55:24