配置自定义错误页面后,当用户请求的内容不存在或出现错误时,CDN节点会返回自定义的错误页面,而不是默认的错误页面。自定义错误页面可以提高用户体验,让用户看到更友好的错误提示。
背景信息
阿里云CDN提供了在出现指定错误码的时候,能够让用户跳转到自定义页面的功能。
当客户端通过浏览器请求Web服务时,如果请求的URL不存在,Web服务器默认会返回404报错页面。Web服务器默认的报错页面通常不美观,为了提升访问者的体验,您可以配置自定义页面,根据所需自定义HTTP或HTTPS响应状态码跳转的完整URL地址。
自定义页面如果使用的是CDN加速的资源,那么将会按照正常的CDN内容分发来计费。
支持的状态码
仅支持针对400、403、404、405、414、416、500、501、502、503、504这些状态码设置自定义页面。
|
状态码 |
描述 |
|
400 |
您访问的页面请求错误时,返回此代码。 |
|
403 |
服务器拒绝请求时,返回此代码。 |
|
404 |
请求服务器上不存在的网页时,返回此代码。 |
|
405 |
禁用请求中指定的方法时,返回此代码。 |
|
414 |
请求的URL过长服务器无法处理时,返回此代码。 |
|
416 |
页面无法提供请求的范围时,返回此代码。 |
|
500 |
服务器遇到错误无法完成请求时,返回此代码。 |
|
501 |
服务器不具备完成请求的功能时,返回此代码。 |
|
502 |
服务器作为网关或代理从上游服务器收到无效响应时,返回此代码。 |
|
503 |
服务器目前无法使用时,返回此代码。 |
|
504 |
服务器作为网关或代理无法及时从上游服务器收到请求时,返回此代码。 |
操作步骤
登录CDN控制台。
在左侧导航栏,单击域名管理。
在域名管理页面,找到目标域名,单击操作列的管理。
在指定域名的左侧导航栏,单击缓存配置。
-
单击自定义页面页签。
-
单击添加,配置自定义页面的错误码和链接。
例如,错误码选择
404,描述自动显示为对应说明,链接输入自定义错误页面地址如http://example.aliyundoc.com/error404.html,单击确定完成配置。 -
单击确定,完成配置。
成功配置自定义页面后,您可以在自定义页面列表中,对当前的配置进行修改或删除操作。
配置示例
您希望将404页面显示为自定义页面,假设您已经将自定义404页面error404.html存放在源站的根目录下,并且通过加速域名example.aliyundoc.com可以访问到这个404页面,这个时候您可以通过以下配置来实现404状态码的自定义错误页面。
-
错误码:404
-
链接:您自定义的URL页面,例如:
http://example.aliyundoc.com/error404.html。 -
结果:访问返回404报错时,会跳转到
http://example.aliyundoc.com/error404.html页面。
常见问题
配置自定义 403 页面时如何避免域名跳转或循环重定向?
为 403 状态码配置自定义错误页面时,如果直接在错误页面设置中配置跳转链接,可能出现域名跳转或循环重定向的问题。可通过以下方式避免:
-
通过 CDN 控制台的重写访问 URL功能进行配置,而非直接在自定义错误页面中设置跳转链接。
-
将待重写的 Path 设置为
/,并将目标路径指向正确的 403 静态页面地址(例如/error/403.html)。
请确保 403 错误页面本身不会再次触发 403 状态码的重定向,否则会导致循环重定向,无法正常访问页面。