导航
自定义错误页面
最近更新时间：2024.06.26 11:21:56首次发布时间：2022.08.23 15:22:30
本文档介绍火山引擎内容分发网络（CDN）提供的自定义错误页面功能。
说明
该功能目前仅对白名单用户开放。如果您需要此功能，请 提交工单。
对于表示错误，也就是范围在 400-599 的 CDN 响应状态码，您可以指定 CDN 返回一个用户友好页面，而不是状态码的标准页面。该用户友好页面上可以包含该状态码以及故障排除信息，以改善用户体验。CDN 通过对请求响应 301/302 状态码，使用户请求重定向到用户友好页面。
说明
在特定情况下，该配置不会生效。参见 例外。
操作步骤
- 登录 火山引擎内容分发网络控制台。
- 在左侧导航栏，点击 域名管理。
- 在 域名管理 页面，找到需要配置的域名。
- 在 操作 列，点击 管理。
- 在域名页面上，点击 缓存配置 标签页。
- 在页面右上方，点击 编辑配置。
- 在 自定义错误页面 下方，点击 添加自定义错误页面规则。
您最多可以添加 50 条规则。 - 根据 配置说明 进行配置。
- 配置完成后，在页面右上方，点击 提交编辑。
配置说明
| 配置 | 说明 |
|---|---|
| 优先级 | 表示规则的优先级。如果有多条规则，则按优先级来执行规则。您可以通过拖拽调整规则的优先级。 |
| 状态码 | 输入一个范围在 400-599 的状态码。您也可以输入 4xx，表示 400-499 之间的所有状态码。 |
重定向方式 | 选择重定向的响应状态码。您可以根据业务需要选择合适的状态码。该参数的取值如下：
需要留意的是，如果原用户请求使用的方法不是 GET，客户端浏览器可能会使用 GET 方法发送重定向请求。 |
目标地址 | 输入跳转的目标地址，长度不能超过 1,024 个字符。目标地址必须符合 URL 规范，包含协议，域名以及路径。 说明 当前，目标地址的域名不能与加速域名相同，否则配置不会生效。我们正在优化该功能。 |
例外
对于您配置的重定向到自定义错误页面的状态码，如果该状态码是由以下任意原因造成，则您的配置不会生效，CDN 返回该状态码的标准页面。
- 由于用户请求满足您设置的访问控制规则而被 CDN 拒绝。
- 请求的 URL 已被 CDN 封禁。
- 对于用户请求，CDN 的回源请求没有收到源站的任何响应。