云直播支持通过配置 User-Agent 黑白名单规则来实现访问控制。这种方法根据用户 HTTP 请求头中的 User-Agent 信息进行规则判断,以按需放行或拒绝用户访问。
配置原理
配置 UA 白名单:只有配置的 UA 内容能够访问当前直播内容。
配置 UA 黑名单:只有配置的 UA 内容无法访问当前直播内容。
注意事项
开启/关闭 UA 黑白名单,预计15 - 20分钟生效。
若同时配置了 UA 鉴权和其他鉴权方式,优先级顺序为:协议 > IP > 地域 > UA。系统会首先按照协议进行鉴权,然后是 IP、地域,最后才是 UA。
前提条件
已开通云直播服务,并登录 云直播控制台。
已添加 播放域名。
配置 UA 黑白名单
1. 选择 域名管理,单击需要配置 UA 黑名单的播放域名或右侧的管理,进入域名管理页。

2. 在访问控制 > UA 黑白名单配置中,单击
开启 UA 黑白名单。


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




配置项 | 说明 |
鉴权类型 | 单击选择配置 UA 白名单或黑名单: 白名单和黑名单互斥,同一时间仅可生效一种。 |
空UA | 空 User-Agent 功能默认关闭,支持手动开启。 空 User-Agent 开启后: 黑名单场景下,UA 值为空或者不存在 UA 字段时均允许请求。 白名单场景下,UA 值为空时拒绝请求,不存在 UA 字段时允许请求。 |
鉴权内容 | 支持通配符*和多个值,每行一个值,多个值请分行填写,不支持输入英文分号 ; 如:curl* *IE* *Chrome* *Firefox* 鉴权内容区分大小写,最大支持长度为100个字符。 |
4. 单击确定即可保存配置。
说明:
UA 黑白名单功能配置完成后约10分钟生效,请耐心等待。
修改 UA 黑白名单
1. 选择 域名管理,单击需修改 UA 黑白名单配置的播放域名或右侧的管理 ,进入域名管理页。

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

3. 根据您的实际需求修改配置项信息,单击保存即可完成修改。
关闭 UA 黑白名单
开启 UA 黑白名单后,若您需关闭此功能,具体操作如下:
1. 选择 域名管理,单击需关闭 UA 黑白名单配置的播放域名或右侧的管理,进入域名管理页。

2. 在访问控制 > UA 黑白名单配置中,单击
,选择关闭 UA 黑白名单。


3. 在关闭 UA 黑白名单时,系统会弹出确认窗口。单击确定即可关闭功能。请注意,关闭后预计需要15-20分钟才能生效。
