导航
自定义错误页面
最近更新时间：2024.11.21 14:03:22首次发布时间：2022.08.23 15:22:30
本文档介绍火山引擎内容分发网络（CDN）提供的 “自定义错误页面” 特性。
对于表示错误的 CDN 状态码，也就是范围在 400-599 的状态码，您可以指示 CDN 返回一个用户友好页面，而不是状态码的标准页面。该用户友好页面上可以包含该状态码以及故障排除信息，以改善用户体验。CDN 通过对请求响应 3xx 状态码，使用户请求重定向到用户友好页面。
说明
在特定情况下，该配置不会生效。参见 例外。
操作步骤
- 登录 火山引擎内容分发网络控制台。
- 在左侧导航栏，点击 域名管理。
- 在 域名管理 页面，找到需要配置的域名。
- 在 操作 列，点击 管理。
- 在域名页面上，点击 缓存配置 标签页。
- 在页面右上方，点击 编辑配置。
- 在 自定义错误页面 下方，设置 状态 为启用，然后点击 新增规则。您最多可以添加 50 条规则。
- 在 新增规则 页面，根据 配置说明 进行配置。
- 配置完成后，在页面右上方，点击 提交编辑。
配置说明
| 配置 | 说明 |
|---|---|
| 异常状态码 | 输入一个范围在 400-599 的状态码。您也可以输入 4xx，表示 400-499 之间的任意状态码。 |
重定向方式 | 选择重定向的响应状态码。该配置的可选项有 301、302、303、307、308。
|
目标地址 | 输入跳转的目标 URL，长度不能超过 1,024 个字符。目标 URL 必须符合 URL 规范，包含协议，域名以及路径。 说明 目标 URL 的域名不能与加速域名相同，否则配置不会生效。 |
规则优先级
规则列表中的规则具有优先级，优先级最高的规则优先生效。对于一个用户请求，如果某条规则与该请求匹配，只有则该规则生效，其余规则不生效。您可以拖动规则来调整规则的优先级。
例外
对于您配置的异常状态码，如果该状态码是由以下任意原因造成，则 CDN 不会将用户请求重定向到您配置的目标 URL，而是返回该状态码的标准页面。
- 用户请求匹配您设置的访问控制规则而被 CDN 拒绝。
- 请求 URL 已被 CDN 封禁。
另外，如果 CDN 在向源站请求文件时没有收到源站的响应，CDN 也不会将用户请求重定向到您配置的目标 URL。