本文档介绍了火山引擎内容分发网络(CDN)中的 "全局配置" 功能。
说明
当前,如果您需要使用该功能,请 提交工单。
全局配置扩展了加速域名的配置能力,提供了以下功能:
提升了配置的容量。例如,"IP 黑名单" 支持高达 30,000 个条目。
一个全局配置可与多个加速域名关联,提升了域名配置的效率。
对于一个全局配置的修改可立刻应用于其关联的所有加速域名。
说明
当前,全局配置支持 "IP 黑名单"、"IP 白名单"、"Referer 黑名单"、"Referer 白名单"、"通用列表" 这几个配置。未来会覆盖更多的访问控制配置以及其他加速域名配置。
登录 火山引擎内容分发网络控制台。
在左侧导航栏,点击 配置优化,然后点击 全局配置。
在 全局配置 页面,点击 新增。
在 新增全局配置 页面,输入配置名称并指定该全局配置所在的项目。
参考相应的配置说明进行设置。
设置完成后,点击 提交。提交后,全局配置就创建完成了。此时,页面会显示该全局配置的详情。您可以点击 返回。如果您需要修改其包含的条目,点击 修改,然后遵循 "修改全局配置" 中的步骤进行操作。接下来,您需要将该全局配置与一个或者多个加速域名关联。
配置 | 说明 |
---|---|
应用场景 | 对于 IP 黑白名单,您可以选择以下某个选项:
|
规则 | 表示 应用场景 对应的名单。名单中的条目可以是 IP 地址和 CIDR 网段。IP 地址和网段可以是 IPv4 和 IPv6 格式。您可以输入最多 30,000 个条目,多个条目使用分号(;)分隔或者分行输入。您也可以上传一个包含这些条目的 .txt 文件。名单中重复的条目会被删除,不会被计数。其他的说明如下。 |
配置 | 说明 |
---|---|
应用场景 | 对于 Referer 防盗链,您可以选择以下某个选项:
|
规则 | 表示 应用场景 对应的名单。名单中的条目可以是域名、IP 地址和 CIDR 网段,用来匹配请求 Referer 头部中的 hostname。暂时不支持设置 URL 为条目。 |
忽略大小写 | 表示 CDN 在使用 规则 中的条目匹配请求时,匹配是否对大小写敏感。 |
空 Referer 处理逻辑 | "空 Referer" 的定义是 Referer 头部的值为空("")或者请求中不包含 Referer 头部。
|
配置 | 说明 |
---|---|
应用场景 | 表示一个通用名单的列表,每个列表项是一个字符串。该列表既不是白名单,也不是黑名单,主要用于判断某个对象是否存在于该列表中。例如,在 自定义拦截 配置中,您可以设置生效条件为请求 URL 中的查询参数不在您配置的通用列表中。 |
规则 | 表示一个字符串列表,最多包含 4,000 个字符串,总长度不能超过 200,000 个字符。多个字符串需要分行输入,您也可以上传一个包含这些字符串的 .txt 文件。列表中重复的字符串会被删除,不会被计数。 |
忽略大小写 | 表示 CDN 在使用 规则 中的字符串匹配对象时,内容是否是大小写敏感的。 |
在创建全局规则后,您需要将其与加速域名关联,才能使其发挥作用。
在左侧导航栏,点击 域名管理。
在 域名管理 页面,找到需要关联的加速域名,点击 管理。
页面上方的筛选条件和搜索框可以帮助您快速找到要配置的域名。
在域名页面上,点击配置所在的标签页。例如,"IP 黑白名单" 配置所在的 访问控制 标签页。
在页面右上方,点击 编辑配置。
在相应的配置下方,设置 状态 为 开启。
设置 配置方式 为 引用全局配置。
在 全局配置 列表中,选择您创建的全局配置。
在页面右上方,点击 提交编辑。
对于其他需要关联的加速域名,重复以上步骤。
以下截图以 "IP 黑白名单" 配置为例。
您可以修改一个全局配置。CDN 控制台提供了以下几种修改方式:
全量覆盖规则内容:表示配置内容会覆盖已有的。
增加规则内容:表示配置内容会被添加到已有的配置中。
删减规则内容:表示配置内容会从已有的配置中删除。
修改后,该全局配置会立刻对其关联的所有加速域名生效。
在左侧导航栏,点击 配置优化,然后点击 全局配置。
在 全局配置 页面,找到需要修改的全局配置,点击 修改。
在 配置详情 页面的 配置内容 下方,设置一种 修改方式。
指定需要修改的配置内容。
以下截图以 "IP 黑名单" 配置为例。
要解除一个全局配置与一个加速域名的关联,有以下两种方法:
关闭相应的加速域名配置。
在相应加速域名配置中,将 配置方式 修改为 域名配置。
如果您不再需要对该加速域名启用相应的配置,可以使用此方法。
在左侧导航栏,点击 域名管理。
在 域名管理 页面,找到需要解除关联的加速域名,点击 管理。
在域名页面上,点击配置所在的标签页。例如,"IP 黑白名单" 配置所在的 访问控制 标签页。
在页面右上方,点击 编辑配置。
在相应的配置中,设置 状态 为 关闭。
在页面右上方,点击 提交编辑。
如果您只是不需要与其他加速域名共享该配置,可以使用此方法。需要留意的是,域名的独立配置的容量较小。例如一个加速域名的 "IP 黑白名单" 配置中最多只能设置 1,000 个条目。如果您依然需要该配置的大容量,您可以创建一个全局配置,然后仅将这个全局配置与该加速域名关联。
在左侧导航栏,点击 域名管理。
在 域名管理 页面,找到需要解除关联的加速域名,点击 管理。
在域名页面上,点击配置所在的标签页。
在页面右上方,点击 编辑配置。
在相应的配置中,设置 配置方式 为 域名配置。
设置其余的配置。
在页面右上方,点击 提交编辑。
对于一个全局配置,您可以导出其包含的规则条目以及其关联的域名列表。
CDN_<config-name>_Rule_<export-time>
CDN_<config-name>_Domain_<export-time>
文件名中的时间格式是:YYYYMMDDHHMMSS
。文件名示例:CDN_test_Rule_20230518114139
。