文档

配置自定义页面

更新时间:

配置自定义错误页面后,当用户请求的内容不存在或出现错误时,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

服务器作为网关或代理无法及时从上游服务器收到请求时,返回此代码。

操作步骤

  1. 登录CDN控制台

  2. 在左侧导航栏,单击域名管理

  3. 域名管理页面,找到目标域名,单击操作列的管理

  4. 在指定域名的左侧导航栏,单击缓存配置

  5. 单击自定义页面页签。

  6. 单击添加,配置自定义页面的错误码和链接。

    自定义页面

  7. 单击确定,完成配置。

    成功配置自定义页面后,您可以在自定义页面列表中,对当前的配置进行修改删除操作。

配置示例

您希望将404页面显示为自定义页面,假设您已经将自定义404页面error404.html存放在源站的根目录下,并且通过加速域名example.aliyundoc.com可以访问到这个404页面,这个时候您可以通过以下配置来实现404状态码的自定义错误页面。

  • 错误码:404

  • 链接:您自定义的URL页面,例如:http://example.aliyundoc.com/error404.html

  • 结果:访问返回404报错时,会跳转到http://example.aliyundoc.com/error404.html页面。

相关API

BatchSetCdnDomainConfig