自定义错误页面--内容分发网络-火山引擎

文档中心

导航

自定义错误页面

最近更新时间：2025.10.27 10:41:16首次发布时间：2022.08.23 15:22:30

本文档介绍火山引擎内容分发网络（CDN）提供的 “自定义错误页面” 特性。

对于表示错误的 CDN 状态码，也就是范围在 400-599 的状态码，您可以指示 CDN 返回一个用户友好页面，而不是状态码的标准页面。该用户友好页面上可以包含该状态码以及故障排除信息，以改善用户体验。CDN 通过对请求响应 3xx 状态码，使用户请求重定向到用户友好页面。

说明

在特定情况下，该配置不会生效。参见例外。

操作步骤

登录火山引擎内容分发网络控制台。
在左侧导航栏，点击 域名管理。
在 域名管理 页面，找到需要配置的域名，点击管理。
定位 自定义错误页面 模块。
- 如果您使用的是旧版域名管理页面，点击 编辑配置，然后在 缓存配置 标签页中定位 自定义错误页面 模块。
- 如果您使用的是新版域名管理页面，点击 编辑域名。在页面左侧的树状配置项列表中，定位 功能配置 > 缓存配置 > 自定义错误页面。如果该模块置灰，点击模块右边的 + 。
  关于新旧版域名管理页面的区别，参见新版域名配置。
在 自定义错误页面 模块中，设置状态为启用，然后点击 新增规则。您最多可以添加 50 条规则。
在 新增规则 页面，根据配置说明进行配置。
配置完成后，点击 提交编辑。

配置	说明
异常状态码	输入一个范围在 400-599 的状态码。您也可以输入 4xx，表示 400-499 之间的任意状态码。
重定向方式	选择重定向的响应状态码。该配置的可选项有 301、302、303、307、308。需要留意的是：对于 301 和 302，如果原请求所使用的方法不是 GET，那么客户端向新的 URL 发送请求时，新请求所使用的方法可能会改为 GET。对于 303，新请求使用的方法始终是 GET。对于 307 和 308，新请求所使用的方法与原请求相同，不会发生改变。
目标地址	输入跳转的目标 URL，长度不能超过 1,024 个字符。目标 URL 必须符合 URL 规范，包含协议，域名以及路径。说明目标 URL 的域名不能与加速域名相同，否则配置不会生效。

配置

说明

异常状态码

输入一个范围在 400-599 的状态码。您也可以输入 4xx，表示 400-499 之间的任意状态码。

重定向方式

选择重定向的响应状态码。该配置的可选项有 301、302、303、307、308。

需要留意的是：

目标地址

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

说明

目标 URL 的域名不能与加速域名相同，否则配置不会生效。

规则列表中的规则具有优先级，优先级最高的规则优先生效。对于一个用户请求，如果某条规则与该请求匹配，只有则该规则生效，其余规则不生效。您可以拖动规则来调整规则的优先级。

对于您配置的异常状态码，如果该状态码是由以下任意原因造成，则 CDN 不会将用户请求重定向到您配置的目标 URL，而是返回该状态码的标准页面。

另外，如果 CDN 在向源站请求文件时没有收到源站的响应，CDN 也不会将用户请求重定向到您配置的目标 URL。