内容分发网络
内容分发网络
文档指南
请输入
- 文档首页
内容分发网络用户指南安全运营流量安全防护白名单
复制全文
下载 pdf防护白名单
文档反馈
问问助手防护白名单用于放行具有指定特征的请求。请求命中白名单后，CDN 将跳过您指定的流量安全功能检测。
警告
CDN 会跳过命中白名单的请求在所选功能中的检测。建议仅为已确认可信的请求特征创建白名单，并尽可能缩小匹配范围。
说明
- 每个主账号及其子账号合计最多可以配置 20 条防护白名单。
- 每条白名单最多包含 5 条匹配规则。多条匹配规则之间为 且 关系，请求必须同时满足所有规则才会命中白名单。
配置说明
| 配置 | 说明 |
|---|---|
| 关联域名 | 必填。选择白名单关联的加速域名，最多可选择 20 个域名。 |
| 备注 | 选填。长度为 3-45 个字符，支持中文、英文、数字和下划线；每个中文字符按 3 个字符计算。 |
| 匹配规则 | 定义需要放行的请求特征。每条白名单最多包含 5 条匹配规则，规则之间为 且 关系。 |
| 功能选择 | 必填。选择命中白名单后需要绕过检测的功能。支持多选：流量检测、高级访问控制、高级频次控制 和 自适应频控。 |
匹配规则
条件关系 固定为 且。逻辑符支持 等于 和 不等于；当 匹配字段 为 自定义请求头部 时，还支持 为空 和 不为空。
| 匹配字段 | 匹配内容要求 | 忽略大小写 |
|---|---|---|
| 文件全路径 | 以 / 开头，不包含域名和查询参数。仅支持可见 ASCII 码，不允许包含空格。支持 * 通配符，单条长度不超过 300 个字符，最多输入 20 条。 | 支持设置，默认开启。 |
| 文件目录 | 根目录使用 / 表示；其他目录以 / 开头和结尾。仅支持可见 ASCII 码，不允许包含空格。单条长度不超过 300 个字符，最多输入 20 条。 | 支持设置，默认开启。 |
| 文件后缀 | 仅支持英文和数字，例如 jpg。单条长度不超过 50 个字符，最多输入 20 条。 | 支持设置，默认开启。 |
| 请求方法 | 从 GET、POST、DELETE、PUT、HEAD、PATCH、CONNECT、OPTIONS 中选择。 | 不可用。 |
| User-Agent 头部 | 支持在值的开头或结尾使用 * 通配符，但不能仅输入 *。单条长度不超过 100 个字符，最多输入 100 条。 | 支持设置，默认开启。 |
| 自定义请求头部 | 指定 1 个头部名称。头部名称支持字母、数字、下划线、连字符和点号，长度不超过 100 个字符。使用 等于 或 不等于 时，还需指定一个或多个头部值；使用 为空 或 不为空 时，无需指定头部值。头部值支持在开头或结尾使用 * 通配符，但不能仅输入 *；单条长度不超过 100 个字符，最多输入 20 条。 | 支持设置，默认开启。 |
| 客户端 IP | 支持 IPv4、IPv6 地址或 CIDR block，最多输入 100 条。 | 不可用。 |
| 客户端 IP（优先匹配 XFF 头部） | 支持 IPv4、IPv6 地址或 CIDR block，最多输入 100 条。 | 不可用。 |
| JA3 指纹 | 单条长度不超过 100 个字符，最多输入 20 条。 | 不可用。 |
功能选择
请求命中白名单后，CDN 跳过 功能选择 中选定功能的检测。
操作步骤
- 登录 火山引擎内容分发网络控制台。
- 在左侧导航栏，点击 流量安全。
- 在 流量安全 页面，点击 防护白名单 标签页。
- 点击 新增。
- 在 关联域名 中选择一个或多个加速域名；如有需要，填写 备注。
- 在 匹配规则 中选择 匹配字段、逻辑符 和 匹配内容。如需增加条件，点击 添加匹配规则。
- 在 功能选择 中选择需要绕过检测的功能。
- 点击 确定。
管理白名单
在 防护白名单 标签页，您可以查看域名、备注、状态、匹配规则、应用场景和修改时间。
- 在搜索框中输入域名关键字，查找相关白名单。
- 点击 查看，查看白名单的匹配规则。
- 在 操作 列，您可以编辑白名单、开启或关闭白名单，或删除白名单。删除白名单时需要二次确认。
说明
编辑白名单时，关联域名 不可修改。关闭白名单后，您可以在 操作 列重新开启白名单。
最近更新时间：2026.09.16 11:10:37
这个页面对您有帮助吗？
有用
有用
无用
无用