You need to enable JavaScript to run this app.
文档中心
内容分发网络

内容分发网络

复制全文
下载 pdf
配置优化
全局配置
复制全文
下载 pdf
全局配置

本文档介绍火山引擎 CDN 的全局配置功能。

说明

当前,如果您需要使用该功能,请 提交工单。

功能描述

全局配置用于集中管理规则列表。以下 CDN 特性支持指定全局配置:

  • 规则引擎中的大部分匹配条件
  • IP 黑白名单
  • Referer 黑白名单
  • UA 黑白名单
  • 自定义拦截规则中的 请求 Query 匹配条件

全局配置支持容量较大的规则列表。例如,IP 黑名单最多可包含 30,000 条规则。

更新全局配置后,变更会立即应用到指定该全局配置的策略所关联的域名。

创建全局配置

创建步骤

  1. 登录 火山引擎 CDN 管理控制台。

  2. 在左侧导航栏,点击 高级配置 > 全局配置。

    alt

  3. 在 全局配置 页面,点击 新增。

  4. 在 新增全局配置 页面,输入配置名称,选择应用场景和项目组。

    • 配置名称可包含汉字、字母、数字和下划线(_),长度为 3 至 45 个字符。一个汉字占 3 个字符。
  5. 根据应用场景完成规则配置:

  6. 单击 提交 创建全局配置。创建后,您可以在详情页面单击 修改 更新规则,或在支持该功能的配置页面中指定该全局配置。

IP 黑白名单

![IP 黑白名单配置](https://sf16-resources.bytepluscdn.com/obj/byte=1112x1395

配置说明

应用场景

选择以下选项之一:

  • IP 白名单:仅当请求的来源 IP 地址在规则列表中时,CDN 才允许该请求。
  • IP 黑名单:当请求的来源 IP 地址在规则列表中时,CDN 会拒绝该请求。
规则输入 IP 地址或 CIDR 网段,支持 IPv4 和 IPv6 格式。最多可输入 30,000 条规则。多条规则使用分号(;)分隔或分行输入,也可以上传包含规则的 .txt 文件。重复规则会被自动去重,不计入规则总数。

IP 判断来源

指定 CDN 判断客户端 IP 地址时使用的来源。

支持以下选项:

  • 默认逻辑:CDN 使用真实建连 IP 判断客户端 IP 地址。真实建连 IP 是与 CDN 节点直接建立网络连接的对端 IP 地址。
  • 自定义:从真实建连 IP、X-Forwarded-For 请求头和 X-Real-IP 请求头中选择一个或多个来源,以判断客户端 IP 地址。无法从已选请求头获取 IP 地址时,CDN 使用真实建连 IP。
    • 对于黑名单,只要任一指定来源中获取的 IP 地址在黑名单中,CDN 就拒绝请求。
    • 对于白名单,只有所有指定来源中获取的 IP 地址均在白名单中,CDN 才允许请求。

Referer 黑白名单

![Referer 黑白名单配置](https://sf16-resources.bytepluscdn.com/obj=1742x1118

配置说明

应用场景

选择以下选项之一:

  • Referer 白名单:仅当请求的 Referer 头部在规则列表中时,CDN 才允许该请求。
  • Referer 黑名单:当请求的 Referer 头部在规则列表中时,CDN 会拒绝该请求。
规则输入域名、IP 地址或 CIDR 网段,以匹配请求 Referer 头部中的 hostname。不支持输入 URL。IP 地址和 CIDR 网段支持 IPv4 和 IPv6 格式;域名支持泛域名。最多可输入 4,000 条规则。多条规则使用分号(;)分隔或分行输入,也可以上传包含规则的 .txt 文件。重复规则会被自动去重,不计入规则总数。
忽略大小写表示规则中的内容是否区分大小写。

泛域名匹配包含主域名

表示规则中的泛域名是否也匹配其主域名。例如,规则为 *.example.com 时:

  • 勾选:规则匹配 example.com 及其子域名。
  • 不勾选:规则仅匹配子域名,不匹配 example.com。

忽略 scheme 校验

表示匹配 Referer 时是否要求 Referer 包含 http:// 或 https://。

  • 勾选:CDN 不校验 Referer 是否包含 scheme,直接将 Referer 与配置的名单进行匹配。
  • 不勾选:CDN 先校验 Referer 是否包含 scheme。仅当 Referer 包含 scheme 时,CDN 才会将 Referer 与配置的名单进行匹配;否则,CDN 判定该请求与配置的名单不匹配。

空 Referer 访问 CDN 资源

空 Referer 是指 Referer 头部为空("")或请求中不包含 Referer 头部。

控制台根据所选应用场景显示以下其中一个选项:

  • 选择 Referer 白名单 时,显示 不允许空 Referer 访问 CDN 资源。勾选后,CDN 拒绝空 Referer 请求;取消勾选后,CDN 允许空 Referer 请求。
  • 选择 Referer 黑名单 时,显示 允许空 Referer 访问 CDN 资源。勾选后,CDN 允许空 Referer 请求;取消勾选后,CDN 拒绝空 Referer 请求。

UA 黑白名单

图片描述=1118x1116

配置说明

应用场景

选择以下选项之一:

  • UA 白名单:仅当请求的 User-Agent 头部在规则列表中时,CDN 才允许该请求。
  • UA 黑名单:当请求的 User-Agent 头部在规则列表中时,CDN 会拒绝该请求。
规则输入 User-Agent。最多可输入 100 条规则。支持手动输入或上传包含规则的文件。
忽略大小写表示规则中的内容是否区分大小写。

空 User-Agent 访问 CDN 资源

空 User-Agent 是指 User-Agent 头部为空("")或请求中不包含 User-Agent 头部。

控制台根据所选应用场景显示以下其中一个选项:

  • 选择 UA 白名单 时,显示 不允许空 User-Agent 访问 CDN 资源。勾选后,CDN 拒绝空 User-Agent 请求。
  • 选择 UA 黑名单 时,显示 允许空 User-Agent 访问 CDN 资源。勾选后,CDN 允许空 User-Agent 请求。

通用列表

![通用列表配置](https://sf16-resources.bytepluscdn.com/obj/byteplu=1110x1321

通用列表既不是白名单,也不是黑名单,主要用于判断某个对象是否存在于列表中。例如,在自定义拦截规则中,可通过 请求 Query 匹配条件判断指定查询参数的值是否属于通用列表。

配置说明

类型

指定规则的匹配方式。创建后不能修改。

支持以下类型:

  • 精确匹配:使用规则中的字符串精确匹配对象。
  • 正则匹配:使用规则中的正则表达式匹配对象。
  • IP 匹配:使用规则中的 IP 地址或 CIDR 网段匹配 IP 地址。

规则

多条规则需分行输入,也可以上传包含规则的 .txt 文件。重复规则会被自动去重,不计入规则总数。

根据所选类型输入相应内容并遵循相应限制:

  • 精确匹配:输入字符串。支持使用通配符 * 表示任意字符,但通配符只能位于字符串首尾。最多可输入 4,000 条规则,规则总长度不超过 200,000 个字符。
  • 正则匹配:输入正则表达式。最多可输入 30,000 条规则,规则总长度不超过 200,000 个字符。
  • IP 匹配:输入 IP 地址或 CIDR 网段。最多可输入 30,000 条规则。

修改全局配置

可以通过以下方式修改全局配置中的规则:

  • 全量替换:表示输入的规则会覆盖已有的所有规则。

  • 仅新增:表示输入的规则会被添加到已有规则中。

  • 指定删除:表示输入的规则会从已有规则中删除。

对于通用列表,创建后不能修改 类型。

修改后,变更会立即应用到指定该全局配置的策略所关联的域名。

操作步骤

  1. 在左侧导航栏,单击 高级配置 > 全局配置。
  2. 找到目标全局配置,单击 修改。
  3. 在 配置详情 页面选择 修改方式,输入相应规则,然后单击 提交。

以下示例展示 IP 黑名单配置的修改页面。
alt

导出全局配置的内容

可导出全局配置中的规则和关联域名列表。导出文件为 .txt 格式。

导出内容文件名格式
规则CDN_<catalog-name>_Rule_<export-time>
关联域名列表CDN_<catalog-name>_Domain_<export-time>

<export-time> 使用 YYYYMMDDHHMMSS 格式。例如:CDN_test_Rule_20230518114139。

操作步骤

  1. 在 全局配置 页面找到目标全局配置,单击 修改。
  2. 在 配置详情 页面的 规则清单 上方,单击 导出,导出规则。
  3. 在 关联域名 上方,单击 导出,导出关联域名列表。

导出规则

导出关联域名

最近更新时间:2026.09.18 17:49:51
这个页面对您有帮助吗?
有用
有用
无用
无用