API 文档

有奖调研

Referer 防盗链配置

最近更新时间:2021-10-22 17:54:18

通过 Referer 防盗链配置自定义 Referer 黑/白名单及规则内容,允许或拒绝播放请求,保护直播内容;同时云直播支持用户选择是否允许空 Referer 访问。

配置原理

基于 HTTP 协议支持的 Referer 机制,Referer 防盗链通过 HTTP request 中携带的 Referer 字段识别请求的来源,验证访问的合法性,进而允许或拒绝对直播内容的请求。

注意事项

  • Referer 信息包含在 HTTP 中,RTMP、WebRTC 和 QUIC 等非 HTTP 协议不受 Referer 配置限制。若需限制 RTMP 拉流,防止客户通过 RTMP 拉流绕过 Referer 防盗链,请 提交工单 联系线下修改。
  • 开启、关闭或修改 Referer 防盗链配置后,约15分钟-20分钟即可生效,无需重新推流。
  • Referer 防盗链是通过 HTTP 请求 header 中的 Referer 信息进行验证,确认请求合法来控制是否允许直播,但可能存在伪造 Referer 绕过校验盗用服务的情况,故不建议业务强依赖 于Referer 进行内容保护。

前提条件

开启 Referer 防盗链

  1. 选择 域名管理,单击需配置 Referer 防盗链的 播放域名 或右侧的 管理,进入域名管理页。
  2. 访问控制>Referer防盗链配置 中,单击编辑进入 Referer 防盗链配置页。
  3. 单击按钮,选择开启 Referer 防盗链,并进行如下配置:
    配置项说明
    防盗链类型 单击选择配置 Referer 黑名单白名单
    • 黑名单和白名单互斥,同一时间仅可生效一种。
    • 若配置了 Referer 白名单,则允许白名单内用户的访问,可请求到直播内容;拒绝白名单外用户的访问,无法请求直播内容。
    • 若配置了 Referer 黑名单,则拒绝黑名单内用户的访问,无法请求直播内容;允许黑名单外用户的访问,可请求到直播内容。
    允许空 Referer
    • 若选择允许,则 HTTP 请求中 Referer 字段为空或无字段的访问将被允许,允许直接通过浏览器访问直播 URL。
    • 若选择不允许,则空 Referer 访问将被拒绝。
    防盗链规则
    • 最多支持配置100条规则,请使用换行符分隔。
    • 支持输入 IP域名两种格式,实际匹配时支持路径前缀匹配(域名和 IP)、支持通配符匹配(泛域名)。如:
      • 配置 101.1.0.1www.test.com 后,101.1.0.1/157www.test.com/tencent 均生效。
      • 配置 *.test.com 后,www.test.coma.test.com 均生效。
    • 若规则内容为空则表示黑白名单均未配置。
  4. 单击保存,即可保存配置。

修改 Referer 防盗链

  1. 选择 域名管理,单击需修改 Referer 防盗链配置的 播放域名 或右侧的 管理,进入域名管理页。
  2. 访问控制>Referer防盗链配置 中,单击 编辑 进入 Referer 防盗链配置页。
  3. 根据您的实际需求修改 配置项 信息,单击 保存 即可完成修改。

关闭 Referer 防盗链

开启 Referer 防盗链 后,若您需关闭此功能,具体操作如下:

  1. 选择 域名管理,单击需关闭 Referer 防盗链配置的 播放域名 或右侧的 管理,进入域名管理页。
  2. 访问控制>Referer防盗链配置 中,单击 编辑 进入 Referer 防盗链配置页。
  3. 单击按钮,选择关闭 Referer 防盗链。
  4. 单击保存即可。

目录
http://www.vxiaotou.com