HTML视频无域名白名单防投屏机制,disableRemotePlayback仅提示浏览器隐藏投屏按钮,非白名单控制;真正防盗需服务端Token校验、CDN Referer白名单及CSP media-src策略协同。

HTML 视频本身不支持“域名白名单”来防投屏——disableRemotePlayback 是唯一原生属性,但它不校验域名,也不拦截请求,只向浏览器发提示信号。
disableRemotePlayback 不是白名单机制,也不能按域名控制
这个布尔属性没有参数、不接受值、不读取域名,它只是告诉浏览器:“请不要为此视频显示 AirPlay / Chromecast 按钮”。它不会检查 src 域名是否在白名单里,也不会拒绝来自非授权域名的投屏请求。设成 disableRemotePlayback="true" 或加引号反而会让属性失效。
- 正确写法:
<video disableremoteplayback></video>(无值、无引号) - 错误写法:
disableRemotePlayback="true"、disableRemotePlayback="disabled"、disableRemotePlayback="https://trusted.example.com" - 它对 Firefox 完全无效,Safari 仅从 iOS 15.4 起部分响应,Chrome/Edge 表现最稳定
真正需要“域名白名单”的场景,实际是防盗链(Referer 校验)
如果你发现视频链接被其他网站嵌入并投屏,问题根源不是投屏功能本身,而是资源被跨域盗用。这时该配的是 OSS/CDN 的 Referer 白名单,不是 HTML 属性。
- OSS(如阿里云)或 CloudFront 可配置 Referer 白名单:只允许
https://your-app.com和https://admin.your-app.com发起请求 - 注意:必须同时添加 HTTP 和 HTTPS 版本;通配符
*.your-app.com可用,但*全放开等于没设 - 空 Referer 默认被拒,若需支持直接访问(如用户粘贴 URL 进地址栏),要显式开启“允许空 Referer”
想限制“谁能在自己页面里投屏”,得靠服务端上下文校验
前端无法判断当前页面是否合法加载了视频,但服务端可以。真正的控制点在视频流接口(如 /api/video/stream?videoId=abc),而非 <video src="..."></video> 标签。
立即学习“前端免费学习笔记(深入)”;
- 每次播放请求携带动态 Token,含
userId、videoId、expiresAt和userAgentHash - 服务端验证 Token 签名、时效性,并比对当前请求的
Referer是否匹配白名单域名(如正则^https://(app|player)\.your-app\.com) - 若校验失败,返回 403,浏览器 video 元素会触发
error事件,可提示“无法播放”
CSP 的 media-src 不是投屏白名单,但影响资源加载
media-src 是 Content-Security-Policy 指令,它管的是“哪些域名的视频/音频文件能被加载”,和投屏无关,但会影响播放是否成功。
- 如果 HLS 的
.m3u8在https://cdn.other.com,而 CSP 写的是media-src 'self',浏览器会直接拒绝加载清单,报 “Refused to load media from …” - 正确配置示例:
media-src 'self' https://videos.your-app.com https://cdn.your-app.com; - 注意:它不阻止用户把已加载的视频投出去,只阻止从非法域名拉流
最关键的混淆点在于:投屏动作发生在浏览器或系统层,HTML 标签没有任何执行权。所有“白名单”逻辑必须落在服务端校验、CDN 防盗链、CSP 策略三层,且三者缺一不可——前端写的 disableRemotePlayback 只是 UI 层最弱的一道提示,别把它当防线。



















