You need to enable JavaScript to run this app.
导航
内容分发网络
  • 文档首页
    • /内容分发网络/用户指南/域名管理/域名配置管理/访问控制/UA 黑白名单
UA 黑白名单
最近更新时间：2025.10.27 10:41:16首次发布时间：2022.06.30 11:01:56
复制全文
我的收藏
有用
有用
无用
无用

本文档介绍如何在火山引擎内容分发网络（CDN）中通过 User-Agent 请求头来对访问您加速域名的请求进行限制。

什么是 User-Agent

User-Agent 请求头包含了发起请求的客户端的操作系统版本、CPU 类型、浏览器版本等信息。网站服务器可以根据 User-Agent 头部的值，返回用户特定的页面。

在 CDN 中，您可以通过 User-Agent 字段的值来允许或者阻止特定用户访问您的加速域名。

说明

您可以在搜索引擎中搜索 “User Agent大全” 来查找常见的 User-Agent 值。

空 User-Agent

"空 User-Agent" 的定义是 User-Agent 头部没有值或者请求中不包含 User-Agent 头部。

说明

User-Agent: null 不被视为是 "空 User-Agent" 情况。

功能优先级

CDN 提供的一系列访问控制功能有不同的优先级。在 CDN 处理用户请求时，这些功能按优先级对请求生效。参见 访问控制功能的优先级。

操作步骤

  1. 登录 火山引擎内容分发网络控制台。
  2. 在左侧导航栏，点击 域名管理。
  3. 在 域名管理 页面，找到需要配置的域名，点击 管理。
  4. 定位 UA 黑白名单 模块。
    • 如果您使用的是旧版域名管理页面，点击 编辑配置，然后在 访问控制 标签页中定位 UA 黑白名单 模块。
    • 如果您使用的是新版域名管理页面，点击 编辑域名。在页面左侧的树状配置项列表中，定位 功能配置 > 访问控制 > UA 黑白名单。如果该模块置灰，点击模块右边的 + 。
      关于新旧版域名管理页面的区别，参见 新版域名配置。
  5. 在 UA 黑白名单 模块中，设置 状态 为启用。
  6. 参照 配置说明 中的内容进行配置。
  7. 配置完成后，点击 提交编辑。

Image

配置说明

配置

说明

类型

该配置的可选值如下：

  • 白名单：指定设置的名单类型为白名单。只有用户请求的 User-Agent 请求头在白名单中，该请求才能访问您的加速域名。
  • 黑名单：指定设置的名单类型为黑名单名单。如果用户请求的 User-Agent 请求头在黑名单中，CDN 会拒绝该请求。

如果一个请求的 User-Agent 请求头匹配了黑名单或者没有匹配白名单，CDN 会拒绝该请求并返回 403 响应状态码。

配置方式

表示清单中条目的来源。该配置有以下选项：

  • 域名配置：表示名单中的条目在 常规名单 中配置。
  • 全局配置：表示名单中的条目来自一个 全局配置。全局配置可以应用于多个加速域名。每个全局配置中最多可以包含 100 个条目。要使用全局配置，请 提交工单。

常规名单

输入一个或者多个 User-Agent。该配置的长度不能超过 30,000 个字符。您最多可以输入 1,000 个 User-Agent。您输入的 User-Agent 有以下要求：

  • 您可以使用通配符（*）表示任意数量的字符。但是 * 仅可以出现在一个 User-Agent 的开头和末尾。
  • User-Agent 不能包含 **。
  • User-Agent 只能包含可打印 ASCII 字符，除了 Delete（ASCII code 127）。
  • 多个 User-Agent 使用分隔符（|）分隔，或者每行一个 User-Agent。比如: *curl*|*Mozilla*。
  • User-Agent 不能只包含空格。

空 User-Agent 访问 CDN 资源

表示在 空 User-Agent 场景下，CDN 处理请求的方式。

  • 当 类型 是 黑名单 时，该选项为 允许空 User-Agent 访问 CDN 资源。
  • 当 类型 是 白名单 时，该选项为 不允许空 User-Agent 访问 CDN 资源。

忽略大小写

表示 User-Agent 名单在用于过滤请求时是否区分大小写。