本文档介绍了火山引擎内容分发网络(CDN)中的 "下载限速" 特性。
特性概述
在 CDN 中,您可以配置 "下载限速",用来对满足指定条件的用户请求限制其数据传输速度。在本文中,一个用户请求的数据传输速度指的是 CDN 在响应该请求时的数据传输速度。
在 "下载限速" 的配置中,您需要创建规则。规则中包含规则的生效时段,匹配条件和限速配置。对于生效时间段内 CDN 收到的新用户请求,如果某个请求满足规则中的匹配条件,CDN 会监控该请求的数据传输速度。一旦数据传输速度超过您在规则中设定的阈值,CDN 会降低该请求的数据传输速度。
在域名流量突增的场景下,例如游戏的新版本发布、商业促销活动上线等,"下载限速" 可以降低 CDN 的带宽。如果 CDN 的计费方式是基于带宽,该特性可以避免您的账单超出预期。
生效范围
"下载限速" 中的规则并不是对所有用户请求生效,而是对指定时间段内 CDN 新收到的用户请求生效。参见 限速时段 配置。
操作步骤
- 登录 火山引擎内容分发网络控制台。
- 在左侧导航栏,点击 域名管理。
- 在 域名管理 页面,找到需要配置的域名,点击 管理。

- 定位 下载限速 模块。
- 如果您使用的是旧版域名管理页面,点击 编辑配置,然后在 访问控制 标签页中定位 下载限速 模块。
- 如果您使用的是新版域名管理页面,点击 编辑域名。在页面左侧的树状配置项列表中,定位 功能配置 > 访问控制 > 下载限速。如果该模块置灰,点击模块右边的 + 。

关于新旧版域名管理页面的区别,参见 新版域名配置。
- 在 下载限速 模块中,设置 状态 为启用。
- 点击 新增规则。您最多可以创建 50 条规则。
- 参考 配置说明 进行设置。
- 配置完成后,点击 提交编辑。

配置说明
配置 | 说明 |
|---|
限速时段 | 表示当前规则的生效时间段。该规则仅对您指定的时间段内 CDN 新收到的请求生效。 |
规则类型 | 表示匹配条件中的匹配类型。该配置有以下选项: - 文件后缀:表示请求 URL 中路径末尾的扩展名。
- 文件目录:表示 URL 路径中的一个目录。
- 文件全路径:表示完整的 URL 路径。
- 全路径正则表达式:表示一个用于匹配完整 URL 路径的正则表达式。要指定该选项,请 提交工单。
- 全部文件:表示所有的文件。
|
规则内容 | 表示匹配条件中的匹配值。多个匹配值之间使用分号(;)分隔,总长度不能超过 1,024 个字符。匹配值不能包含以下字符: 另外, - 如果 规则类型 是 文件后缀,则每个匹配值是一个文件后缀,不能以句点(.)开头。例如:
png;txt。 - 如果 规则类型 是 文件目录,则每个匹配值是一个目录路径,必须以斜杠(/)开头和结尾。例如:
/chs/foods/;/us/birds/。 - 如果 规则类型 是 文件全路径,则每个匹配值是一个 URL 路径,必须以斜杠(/)开头。匹配值可以包含星号(*)用来表示一个或者多个任意字符。例如:
/chs/foods/local*sets;/us/birds/chickadee。 - 如果 规则类型 是 全部文件,该配置不会出现。
- 如果 规则类型 是 全路径正则表达式,则每个匹配值是一个正则表达式,用于匹配 URL 路径。对于一个请求,如果 URL 路径中的任何部分匹配了该正则表达式,该请求就匹配了这条规则。例如:
^/a{1,2}.*g$。
|
限速方式 | 表示如何设置数据传输速度的阈值。该配置有以下选项: - 固定限速值:表示在 默认限速值 配置中设置阈值。
- 动态限速:表示从指定的查询参数中获取阈值。该参数在 限速参数名称 配置中指定。
|
限速参数名称 | 当 限速方式 为 动态限速 时,该配置会出现,表示包含限速值的查询参数名称以及速度的单位。
查询参数名称的输入要求如下: - 可以包含字母、数字、下划线(_)、连字符(-)。
- 长度不超过 30 个字符。
|
放行阈值 | 表示单个请求的初始传输数据量。当 CDN 对单个请求传输的数据量未达到该配置的值时,CDN 不会监控请求的数据传输速度。如果您指定 0,则 CDN 从传输的第一个字节起就开始监控单个请求的数据传输速度。您可以指定的最大值是 1,000,000 GB。该配置使用的进制是 1,024。 |
默认限速值 | 表示数据传输速度的阈值。对于单个请求,如果该请求的数据传输速度超过这个阈值,CDN 会降低该请求的数据传输速度。您可以指定的最低速度是 1 B/S,最高速度是 1,000,000 GB/S。该配置使用的进制是 1,024。
当 限速方式 为 动态限速 时,请留意以下说明: - 默认限速值 的默认值为 0,表示不限速。
- 如果您设置了 默认限速值,表示如果 CDN 无法从指定的查询参数中获取限速值,则使用 默认限速值 作为限速值。
|
规则生效逻辑
规则列表中的规则具有优先级,优先级最高的规则优先生效。对于一个用户请求,如果某条规则与该请求匹配,只有该规则生效,剩余规则不生效。您可以拖动规则来调整规则的优先级。
