错误页面重定向

更新时间:2024-05-30 22:19:48

用户请求源站的内容时,当请求的内容不存在或者有其他错误,通常情况下源站会返回默认的错误信息提示页面,提示用户请求的内容存在异常情况,而这些提示页面如果没有特别设计,内容简单并且千篇一律。当用户通过CDNetworks的CDN平台请求访问源站内容,出现类似上面描述的请求失败情况时,您可以在CDNetworks平台上指定提示页面返回给用户。

通过CDNetworks平台,您可以对域名添加多条不同的页面返回规则,可以配置面向不同的用户请求内容,比如文件类型,不同的响应状态码,返回不同的错误信息提示页面。针对同一个用户请求内容或者同一个状态码,可以在不同规则中指定不同的返回页面,通过指定规则生效的优先级,按规则匹配顺序,优先返回希望用户看到的提示页面。

如何设置重定向错误页面

  1. 登录CDNetworks 控制台, 选择对应的产品。
  2. 进入自助配置页面,选择您想要的域名,点击上方配置修改或者域名右侧的编辑按钮Self-Service Configuration for China Premium Service Onboarding
  3. 进入配置修改页面,找到页面改写/重定向-错误页面重定向入口,点击添加按钮。
  4. 进入规则编辑页面,可以根据您的需要,添加以下配置项。


配置生效范围

参数 描述
所有请求 表示所有面向关联该配置的域名发起的内容请求都适用该规则。
仅首页 表示仅针对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平台强制停止。

本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!