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 政策
隐私协议
数据处理和安全协议
词汇表

IP 黑白名单配置

PDF
聚焦模式
字号
最后更新时间: 2026-01-07 09:53:43
通过 IP 黑白名单配置自定义 IP 黑/白名单及规则和内容,通过请求 IP 对请求进行过滤,实现访问限制,保护直播内容。

配置原理

配置 IP 白名单:只有配置的 IP 地址能够访问当前直播内容。
配置 IP 黑名单:只有配置的 IP 地址无法访问当前直播内容。

注意事项

IP 黑白名单配置完成后约10分钟生效。
当同时启用 IP 黑白名单和 播放地域管理(地域黑白名单)时,系统的判断逻辑如下:
1.首先进行 IP 黑白名单校验:
如果 IP 在白名单内,则直接放行。
如果 IP 在黑名单内,则直接拒绝访问。
如果 IP 不在黑白名单内,则进入下一步。
2.接着进行地域黑白名单校验(仅当 IP 不在 IP 黑白名单内时):
如果地域在白名单内,则放行,否则拒绝访问。
如果地域在黑名单内,则拒绝访问,否则放行。

前提条件

已开通云直播服务,并登录 云直播控制台
已添加 播放域名

配置 IP 黑白名单

1. 选择 域名管理,单击需要配置 IP 黑名单的播放域名或右侧的管理,进入域名管理页。



2. 访问控制 > IP 黑白名单配置中,单击

开启 IP 黑白名单。


3. 开启 IP 黑白名单后,进入 IP 黑白名单配置页,并进行如下配置:
黑名单
白名单


配置项
说明
鉴权类型
单击选择配置 IP 白名单黑名单
白名单和黑名单互斥,同一时间仅可生效一种。
若配置了 IP 白名单,则允许白名单内的 IP 地址访问,可请求到直播内容;拒绝白名单外的 IP 地址访问,无法请求直播内容。
若配置了 IP 黑名单,则拒绝黑名单内的 IP 地址访问,无法请求直播内容;允许黑名单外的 IP 地址访问,可请求到直播内容。
IP 名单
IP 黑名单最多支持配置 200 条规则, IP 白名单最多支持配置 500 条规则。请使用换行符分隔。
黑白名单支持 IPv4 、 IPv6 及网段格式。
4. 单击保存即可保存配置,配置需要一定时间才可生效。




修改 IP 黑白名单

1. 选择 域名管理,单击需修改 IP 黑白名单配置的 播放域名 或右侧的 管理 ,进入域名管理页。



2. 访问控制 > IP 黑白名单配置中,单击编辑进入 IP 黑白名单配置页。

3. 根据您的实际需求修改配置项信息,单击保存即可完成修改。

关闭 IP 黑白名单

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



2. 访问控制 > IP 黑白名单配置中,单击
img

,选择关闭 IP 黑白名单。




帮助和支持

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

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

文档反馈