You need to enable JavaScript to run this app.
导航

自定义错误页面

最近更新时间2024.03.06 15:19:22

首次发布时间2022.08.23 15:22:30

本文档介绍火山引擎内容分发网络提供的自定义错误页面功能。

说明

该功能目前仅对白名单用户开放。如果您需要此功能,请提交工单

您可以对特定的错误码指定一个对用户友好的页面。页面上可以包含该错误码的错误排查等信息,从而提升用户体验。您可以指定的错误码范围是 400-599。

操作步骤

  1. 登录 火山引擎内容分发网络控制台
  2. 在左侧导航栏,点击 域名管理
  3. 域名管理 页面,找到需要配置的域名。
  4. 操作 列,点击 管理
  5. 在域名页面上,点击 缓存配置 标签页。
  6. 在页面右上方,点击 编辑配置
  7. 自定义错误页面 下方,点击 添加自定义错误页面规则
    您最多可以添加 50 条规则。
  8. 根据配置说明进行配置。
  9. 配置完成后,在页面右上方,点击 提交编辑

alt

配置说明

配置说明
优先级表示规则的优先级。如果有多条规则,则按优先级来执行规则。您可以通过拖拽调整规则的优先级。
状态码输入一个范围在 400-599 的状态码。您也可以输入 4xx,表示 400-499 之间的所有状态码。

重定向方式

选择重定向的响应状态码。您可以根据业务需要选择合适的状态码。该参数的取值如下:

  • 301:表示内容是永久性转移。
  • 302:表示内容是暂时性转移。

需要留意的是,如果原用户请求使用的方法不是 GET,客户端浏览器可能会使用 GET 方法发送重定向请求。

目标地址

输入跳转的目标地址,长度不能超过 1,024 个字符。目标地址必须符合 URL 规范,包含协议,域名以及路径。

说明

当前,目标地址的域名不能与加速域名相同,否则配置不会生效。我们正在优化该功能。