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

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

什么是 User-Agent

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

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

说明

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

功能优先级

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

操作步骤

  1. 登录 火山引擎内容分发网络控制台。
  2. 在左侧导航栏，点击 域名管理。
  3. 在 域名管理 页面，找到需要配置的域名，点击 管理。
  4. 在域名页面上，点击 访问控制 页签。
  5. 在页面右上方，点击 编辑配置。
  6. 在 UA 黑白名单 下方，设置 状态 为启用。
  7. 参照 配置说明 中的内容进行配置。
  8. 配置完成后，在页面右上方点击 提交编辑。

alt

配置说明

配置说明

类型

该配置的可选值如下：

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

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

常规名单

输入一个或者多个 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 头部值为空或者不包含 User-Agent 请求头的请求访问您的加速域名。
忽略大小写表示 User-Agent 名单在用于过滤请求时是否区分大小写。