功能介绍

客户端向web服务器发起请求，CDN边缘节点验证客户端的IP，根据客户的配置规则，控制只允许或者不允许某些ip访问对应的加速域名的指定文件，解决恶意盗刷、攻击等行为。针对不允许访问的IP/IP段，可以设置直接“禁止”或者“跳转”到指定URL。

操作步骤

1. 登录网宿CDN控制台，选择域名所在的产品线。
2. 选择域名，单击配置修改。
3. 在自助配置界面选择：访问控制-IP黑白名单防盗链，单击添加。
4. 配置访问控制的生效范围，即配置针对哪些请求进行访问控制。此处提供5种生效范围供选择：
   
   常规生效范围有5种：

另外，可选配置进阶生效范围， 此配置项配置的内容，与“生效范围”中配置的内容，取交集则为此功能的生效范围。“例外”表示非，例如，例外的文件类型为jpg， 则表示除了jpg以外的其他文件类型。

5. 配置访问控制策略。
   1） 设置IP的黑名单：
   

   禁止的IP段内如果部分IP需允许访问，可填写到“例外IP/IP段

   2） 设置IP的白名单：
   

   参数说明：

   参数	描述	示例
   IP/IP段黑名单	设置禁止IP/IP段，IP和IP段可以共存；多个以英文分号分隔。填写的值即为黑名单IP，其他均为白名单。支持IPv6地址，建议使用非缩写格式，例如：2001:DB8:0:23:8:800:200C:417A或2001:0DB8:0000:0023:0008:0800:200C:417A。	全部IP，或者自定义IP/IP段（比如1.1.1.1;1.1.0.0/24）
   例外IP/IP段	禁止的IP段内如果部分IP需允许访问，可填写到“例外IP/IP段”。多个分号分隔。支持IPv6地址，建议使用非缩写格式，例如：2001:DB8:0:23:8:800:200C:417A或2001:0DB8:0000:0023:0008:0800:200C:417A。	1.1.3.4

6. 配置其他参数。
   

   参数	描述
   优先级	配置了多条访问控制规则，系统按优先级大小先后执行，数字大的优先级高。
   控制动作	访问校验不通过的请求，是选择禁止还是跳转。其中, 禁止：访问校验不通过的请求，系统返回403。跳转：访问校验不通过的请求，系统返回跳转的页面。跳转的页面在跳转到URL中进行配置。
   忽略大小写	表示该防盗链是否忽略大小写进行生效，是：忽略大小写，生效范围配置的规则和黑白名单配置的内容都忽略大小写。 否：不忽略大小写，生效范围配置的规则和黑白名单配置的内容需要区分大小写。

7. 配置完毕，单击确认，然后单击下一步。

8. 为了避免影响线上业务，建议先预部署测试效果，单击预部署。

9. 预部署成功后，可以获取到对应的测试节点，可以host节点进行测试。

10. Host测试后，确保配置无误，则单击直接部署，预计需要3-5分钟的部署时间。

配置示例

网宿的IP黑白名单防盗链功能很灵活，可以通过多种配置方式满足不同的访问控制需求。

场景1：黑名单配置
如下图配置：图1配置表示，IP为1.1.1.1和2.2.2.2的客户端，不允许访问该加速域名的全部文件

场景2：白名单配置
下图配置表示，http://加速域名/browse/index.html的文件，只允许3.3.3.3;4.4.4.4的客户端访问。

场景3：URL永久禁封
下图配置表示，禁封此URL：http://加速域名/browse/index.html的文件，不允许任何IP访问。 只要此条配置项一直保留，则此URL就会一直被封禁，如需解封，需要删除此条配置。

注意事项

1. 白名单只能配置一条规则，如果有多个IP需要设置为白名单，请写到一条规则中。
2. 请勿同时自助配置黑白名单，否则容易造成业务异常。如需配置，请联系网宿技术支持进行评估。如下图配置，会导致所有访问被拒绝。原因如下：
   • IP为1.1.1.1的请求，匹配第一条黑名单规则，访问会被拒绝。
   • IP为非1.1.1.1的请求，匹配第一条未被拒绝，但匹配第二条白名单规则时被拒绝.因为第二条白名单规定只有IP为1.1.1.1的请求才允许访问。