IP 黑白名单配置

最近更新时间:2024-08-22 14:20:51

我的收藏

配置场景

若您希望对业务资源的访问来源进行控制,腾讯云 CDN 为您提供了 IP 黑白名单配置功能。
通过对用户请求端 IP 配置访问控制策略,可以有效限制访问来源,阻拦恶意 IP 盗刷、攻击等问题。

配置指南

查看配置

登录 CDN 控制台,在菜单栏里选择域名管理,单击域名右侧管理,即可进入域名配置页面,第二栏访问控制中可看到 IP 黑白名单配置,默认情况下为关闭状态:



开启配置

单击开关即可开启配置,首次开启配置时,如果不存在规则,将默认弹出新增规则页面。开启后,IP黑/白名单将按照规则优先级生效,最下方的规则优先级最高。
注意
若您的加速域名服务区域为全球加速,设置的IP黑名单与白名单会全球生效,不支持境内、境外差异化配置。

新增/修改规则

您可以在 IP 黑名单中,单击新增规则按钮,新增一条 IP 黑白名单规则。


IP 黑名单 用户端 IP 匹配黑名单中的 IP 或 IP 段时 ,访问 CDN 节点时将直接返回514状态码。 IP 白名单 用户端 IP 未匹配白名单中的 IP 或 IP 段时 ,访问 CDN 节点时将直接返回514状态码。


配置约束
单个规则中,IP 黑名单与 IP 白名单二选一,不可同时配置。
最多可以配置20条规则。
所有规则一起 IP 白名单IP/IP段可支持500个,黑名单IP/IP段可支持200个。
不支持配置 IPV4 及 IPV6 保留地址及网段作为 IP 黑白名单。
支持 IPV4、IPV6 地址及网段格式/X(IPV4:1≤X≤32;IPV6:1≤X≤128),不支持 IP: 端口格式。
不支持带参数的文件目录。
如需修改规则,可以在规则右侧的操作列表中,单击修改按钮修改规则内容。



调整规则优先级

如需调整规则优先级,您可以在规则列表上方,单击调整优先级进入优先级调整模式,进入后页面如下,通过操作一栏中,可对规则优先级进行调整,上箭头代表规则向上移动,下箭头代表规则向下移动。调整后,单击保存即可保存当前的规则优先级顺序。
注意
列表底部的优先级大于列表顶部。




删除规则

如需删除规则,您可以在规则的操作栏中,单击删除按钮,删除该规则将弹窗进行确认,确认后即永久删除该规则。



关闭配置

单击配置状态右侧开关,即可关闭配置,关闭配置情况下,您仍可修改IP黑白名单规则,但是不会立即发布至现网,仅当开启配置时,规则才会生效。



配置示例

若加速域名:www.test.com 的 IP 黑白名单配置如下:

则实际访问情况如下:
1. 当用户端 IP 为1.1.1.1时,访问资源 https://www.test.com/test/vod.mp4,则匹配最下方黑名单规则,不允许该用户访问,返回514;
2. 当用户端 IP 为1.1.1.2时,访问资源 https://www.test.com/test/vod.mp4,该 IP 不在黑名单规则内,不匹配黑名单规则,但是该用户访问内容匹配白名单规则,仅允许 IP 为1.1.1.1用户访问,该用户 IP 不符合,因此不允许该 IP 用户访问,返回514;
3. 当用户端 IP 为1.1.1.1时,访问资源 https://www.test.com/vod.mp4,不匹配黑名单规则,匹配白名单规则,允许该 IP 用户访问,将正常返回内容。
4. 当用户端 IP 为2.2.2.1时,访问资源 https://www.test.com/vod.mp4,不匹配黑名单规则,2.2.2.1属于2.2.2.0/24 段IP,匹配白名单规则,允许该 IP 用户访问,将正常返回内容。