错误页

概念复制链接

设置网站错误页复制链接

1. 打开 网站，选择网站，进入「错误页」页签。

2. 在对应状态码的文本框中填写 HTML 模板；留空的状态码使用内置页面。需要跳转时在该状态码右上角选择「跳转到 URL」并填写 URL；模板页面可在「响应状态码」中改写发出的状态码。

3. 需要替换源站自己返回的错误时，打开「替换源站错误响应」。

4. 点击「保存」。控制台发布新版本（原因「修改网站 {site} 的错误页」），节点热更新，不重新加载。

5. 验证：

   复制

   curl -s -D - -H 'Host: www.example.com' http://<节点 IP>/<被规则拒绝的路径>

   返回 403、Content-Type: text/html; charset=utf-8、Cache-Control: no-store 和模板内容。

跳转页面复制链接

页面选择「跳转到 URL」后，该状态的响应改为 302 跳转。

维护模式复制链接

「错误页」页签的「维护模式」卡片：打开「启用」，按需填写「Retry-After（秒）」「放行地址」「放行路径前缀」与「维护页」，点击「保存」。关闭时其余设置保留。

模板复制链接

示例：

<!doctype html>
<html lang="zh-CN">
<meta charset="utf-8">
<title>{{status}}</title>
<h1>请求未完成</h1>
<p>请求 ID：{{request_id}}</p>
<p>{{time}} · {{path}}</p>

内置页面复制链接

没有模板时，节点返回自包含的内置页面：不引用外部资源，没有脚本，跟随系统的浅色或深色。页面显示状态码和一条从访客经边缘节点到源站的链路，标出出问题的一环（访客、边缘节点或源站）及其状态；下方是标题、访客可以怎么做、可能有用时的「重新加载」，以及请求 ID、节点应答的时间（UTC）、域名和访客的 IP（点击显示）。动效只用 CSS，系统开启「减少动态效果」时为静止画面。语言按 Accept-Language 中权重最高的中文或英文选择，两者都没有时为英文。

节点自己拒绝的请求和节点内部错误：能确定网站时按查找顺序使用网站的页面，否则返回内置页面。拒绝的请求在链路上标出访客，内部错误标出边缘节点：

平台错误页复制链接

在 系统设置 → 平台错误页 填写，规则与网站模板相同，留空使用内置页面。保存后所有集群各发布一个配置版本（原因「修改平台错误页」），修改写审计 system.error_pages_update，见系统设置。

节点从配置中的离线 Host 列表（已停用网站的域名）识别已停用的网站；泛域名按网站域名的规则匹配。重新启用网站后，该 Host 恢复服务；删除网站或从网站移除该域名后，它不再是离线 Host，返回 404。两个页面只用于 HTTP 请求：节点不为这些 Host 完成 TLS 握手，HTTPS 请求在握手时失败。

请求 ID复制链接

节点要求复制链接

故障排查复制链接