更新时间:2024-05-30 22:19:48
用户请求源站的内容时,当请求的内容不存在或者有其他错误,通常情况下源站会返回默认的错误信息提示页面,提示用户请求的内容存在异常情况,而这些提示页面如果没有特别设计,内容简单并且千篇一律。当用户通过CDNetworks的CDN平台请求访问源站内容,出现类似上面描述的请求失败情况时,您可以在CDNetworks平台上指定提示页面返回给用户。
通过CDNetworks平台,您可以对域名添加多条不同的页面返回规则,可以配置面向不同的用户请求内容,比如文件类型,不同的响应状态码,返回不同的错误信息提示页面。针对同一个用户请求内容或者同一个状态码,可以在不同规则中指定不同的返回页面,通过指定规则生效的优先级,按规则匹配顺序,优先返回希望用户看到的提示页面。
配置生效范围
参数 | 描述 |
---|---|
所有请求 | 表示所有面向关联该配置的域名发起的内容请求都适用该规则。 |
仅首页 | 表示仅针对http://domain/ 或https://domain/ 根目录格式的请求适用于该规则。 |
指定文件类型 | 表示所有面向指定文件类型的内容请求,都适用于该规则;可选择常用类型或自定义文件类型,多个文件类型之间以; 分隔,例如:ace;aac 。 |
指定目录 | 表示所有面向指定目录的内容请求,都适用于该规则;目录必须以/ 开头和结尾,由字母、数字及部分特殊符号(包含下划线、减号、百分号、点)任意组合,例如:/file/1%1/ ,表示http://domain/file/1%1/ 该目录及目录下所有文件的请求都适用于该规则。需要注意的是,多个目录需要用换行符分隔。 |
配置状态码
CDNetworks为您提供可快速选择的常用状态码列表:403;404;500;502;503;504
。除了可以在列表中选择外,您也可以在输入框中填入您希望进行页面重定向的响应状态码,多个状态码需用;
分隔,例如:301;302
。
注意:
当选择或者填写多个状态码时,匹配规则为“或”逻辑,即请求返回的状态码在您选择或填入的范围内,匹配到其中一个状态码,该请求即适用于此规则。
配置重定向页面的URL
您可以在此填入希望返回给用户的错误信息提示页面地址,该URL地址必须是完整的URL,且需确保该URL可访问,一条独立的规则只允许配置一个URL,例如: http://domain/error.html
。
您可以通过选择是或者否来决定是否忽略URL中的大小写差异。
配置规则生效优先级
在这个配置项中,您可以指定这个规则的生效优先级。平台根据用户请求匹配您设置的规则,如果适用多条规则,优先级较大的规则优先执行。
完成上述配置后,请点击确认,然后选择下一步提交您的配置。为了避免配置影响您的生产环境,我们推荐您先预部署,把配置生效到测试环境中来验证您的配置是否正确。当配置确定无误后,单击直接部署将配置正式生效到线上环境,通常约3-5分钟后,配置将正式生效到线上环境。关于预部署测试的更多细节,请参考教程通过预部署来验证配置是否生效。
示例一:响应状态码为404的所有请求
关联该规则的域名的所有请求,当服务端返回404状态码时,响应给客户端的错误提示页面为https://domain/files/error.html
。
示例二:响应状态码为404的PNG文件请求
关联该规则的域名的所有针对PNG文件的请求,当服务端返回404状态码时,响应给客户端的错误提示页面为https://domain/files/error_PNG.html
。
当一个加速域名如https://domain/
,同时配置了上述两条示例规则,当用户请求https://domain/hello.png
文件不存在时服务端返回404状态码,因为示例二规则的优先级高于示例一规则的优先级,此时响应给客户端的错误提示页面为https://domain/files/error_PNG.html
。
希望跳转的错误信息提示页面地址,必须是完整且可访问的URL地址,若希望跳转的URL不可访问,会重复触发错误页面重定向的规则,将有可能进行循环重定向。因此出现的循环重定向请求,可能会被CDNetworks平台强制停止。