tencent cloud

云直播

动态与公告
公告
新手指南
产品简介
产品概述
子产品简介
基本概念
产品功能
应用场景
产品优势
使用限制
购买指南
计费概述
基础服务费
增值服务费
预付费资源包
购买流程
计费变更
退款说明
账单查询
续费说明
欠费停服说明
计费常见问题
标准直播
概述
应用场景
快速入门
SDK 接入说明
快直播(超低延时直播)
概述
快直播和标准直播区别
应用场景
快速入门
SDK 接入说明
云导播台
概述
应用场景
功能区介绍
云导播台管理
通用云导播
配置节目单和自动导播
控制台指南
控制台介绍
概览
域名管理
流管理
资源包管理
AI 智能
功能配置
拉流转推
计费用量
业务监控
常用工具
无忧直播
CAM 访问控制
功能实践
直播推流与播放
直播增值功能
典型场景实践
云端原生录制
直播安全
海外直播
回调事件消息通知
常见第三方工具指南
SDK 实践
0. SDK 接入引导
1. 推流
2. 播放
3. 高级功能
API 文档
History
Introduction
API Category
Making API Requests
Live Pad APIs
Live Stream Mix APIs
Time Shifting APIs
Monitoring Data Query APIs
Billing Data Query APIs
Live Transcoding APIs
Delayed Playback Management APIs
Domain Name Management APIs
Watermark Management APIs
Certificate Management APIs
Stream Pulling APIs
Recording Management APIs
Live Callback APIs
Screencapturing and Porn Detection APIs
Authentication Management APIs
Live Stream Management APIs
Data Types
Error Codes
运维指南
优化视频卡顿
推流失败问题排查
播放失败问题排查
CLS 协助直播问题排查
直播延迟问题排查
拉流视频质量不清晰问题排查
COS bucket 授权给直播实现截图存储
故障处理
直播混流报错:InvalidParameter.OtherError
常见问题
服务地区相关
直播基础相关
推流播放相关
直播计费相关
直播海外相关
直播录制相关
云端混流相关
域名配置相关
云导播台相关
适配苹果 ATS 相关
服务等级协议
云直播服务等级协议
CSS 政策
隐私协议
数据处理和安全协议
词汇表

Referer 防盗链配置

PDF
聚焦模式
字号
最后更新时间: 2025-12-03 17:56:22
通过 Referer 防盗链配置自定义 Referer 黑/白名单及规则内容,允许或拒绝播放请求,保护直播内容;同时云直播支持用户选择是否允许空 Referer 访问。

配置原理

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

注意事项

Referer 信息包含在 HTTP 中,开启配置后 RTMP 和 非 Web 端的 WebRTC 不会校验 Referer 配置,仍可正常播放,如需配置 Referer 建议使用 FLV 或 HLS 播放。
开启、关闭或修改 Referer 防盗链配置后,约15分钟-20分钟即可生效,无需重新推流。
Referer 防盗链是通过 HTTP 请求 header 中的 Referer 信息进行验证,确认请求合法来控制是否允许直播,但可能存在伪造 Referer 绕过校验盗用服务的情况,故不建议业务强依赖于Referer 进行内容保护。

前提条件

已开通云直播服务,并登录 云直播控制台

开启 Referer 防盗链

1. 选择 域名管理,单击需配置 Referer 防盗链的播放域名或右侧的管理,进入域名管理页。

2. 访问控制 > Referer 防盗链配置中,单击

,选择开启 Referer 防盗链。


3. 并进行如下配置:

配置项
说明
防盗链类型
单击选择配置 Referer 黑名单白名单
黑名单和白名单互斥,同一时间仅可生效一种。
若配置了 Referer 白名单,则允许白名单内用户的访问,可请求到直播内容;拒绝白名单外用户的访问,无法请求直播内容。
若配置了 Referer 黑名单,则拒绝黑名单内用户的访问,无法请求直播内容;允许黑名单外用户的访问,可请求到直播内容。
允许空 Referer
若选择允许,则 HTTP 请求中 Referer 字段为空或无字段的访问将被允许,允许直接通过浏览器访问直播 URL。
若选择不允许,则空 Referer 访问将被拒绝。
防盗链规则
规则总字符上限4000个字符(建议控制在200条规则以内),不允许空行和分号(;)。
普通规则匹配所包含的字符串并且支持通配符(*)进行模糊匹配,如:https://*.domain.com
正则表达式规则,整行用英文小括号()包括,若想匹配 www.domain.com 域名,可以用(^https?://www.domain.com($/);若想匹配*.domain.com 域名,可以用(https?://[^/?]*domain.com($|/)
4. 单击保存,即可保存配置。

修改 Referer 防盗链

1. 选择 域名管理,单击需修改 Referer 防盗链配置的播放域名或右侧的管理,进入域名管理页。

2. 访问控制 > Referer 防盗链配置 中,单击编辑进入 Referer 防盗链配置页。
3. 根据您的实际需求修改配置项信息,单击保存即可完成修改。



关闭 Referer 防盗链

开启 Referer 防盗链 后,若您需关闭此功能,具体操作如下:
1. 选择 域名管理,单击需关闭 Referer 防盗链配置的播放域名或右侧的管理,进入域名管理页。

2. 访问控制 > Referer 防盗链配置 中,单击

,选择关闭 Referer 防盗链。




帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈