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