You need to enable JavaScript to run this app.
导航
多云CDN
  • 文档首页
    • /多云CDN/用户指南/CDN加速/配置管理/访问控制/UA 黑白名单
UA 黑白名单
最近更新时间：2024.12.11 10:47:58首次发布时间：2024.12.11 10:47:58
我的收藏

本文档介绍如何在CDN加速服务中通过 User-Agent 请求头来对访问您加速域名的请求进行限制。

什么是 User-Agent

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

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

说明

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

功能优先级

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

前提条件

您已经添加域名到CDN加速服务。相关操作，请参见添加域名。

操作步骤

  1. 登录多云CDN控制台。

  2. 在左侧导航栏，单击 CDN加速。
  3. 在CDN加速域名列表找到您的域名，单击域名名称。
  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 访问 CDN 资源

表示CDN加速服务是否接受 User-Agent 为空的请求。

  • 如果 类型 是 黑名单，该选项是 允许空 User-Agent 访问 CDN 资源。如果您勾选该选项，CDN加速服务接受 User-Agent 为空的请求。
  • 如果 类型 是 白名单，该选项是 不允许空 User-Agent 访问 CDN 资源。如果您勾选该选项，CDN加速服务拒绝 User-Agent 为空的请求。
忽略大小写表示 User-Agent 名单在用于过滤请求时是否区分大小写。