错误页面重定向
更新时间：2024-07-17 17:19:55
用户请求源站的内容时，当请求的内容不存在或者有其他错误，通常情况下源站会返回默认的错误信息提示页面，提示用户请求的内容存在异常情况，而这些提示页面如果没有特别设计，内容简单并且千篇一律。当用户通过CDNetworks的CDN平台请求访问源站内容，出现类似上面描述的请求失败情况时，您可以在CDNetworks平台上指定提示页面返回给用户。
通过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平台强制停止。