您可以为以下错误和质询定义自定义 错误页面:
- WAF 拦截
- IP/国家/地区拦截
- IP/国家/地区质询
- 500 类错误
- 1000 类错误
- 托管质询 / “我正受到攻击”(I'm Under Attack)模式
- 速率限制拦截
有关不同类型错误页面的更多信息,请参阅 错误页面类型。
若要为匹配特定条件的请求返回自定义错误响应,请改用 自定义错误规则。
在 Cloudflare 账户中定义自定义错误页面之前,您需要先设计和编写该页面。页面可以托管在您自己的 Web 服务器上,或使用 Snippets 等 Cloudflare 产品。
设计自定义错误页面时,可以包含特定于页面的 自定义错误令牌。每个自定义错误令牌都会在错误页面上提供诊断信息。
要为每种错误显示自定义页面,请为每种错误创建单独的页面。例如,要为 IP/Country Block 和 WAF block 都创建自定义错误页面,您必须设计和发布两个独立的页面。
您可以使用以下模板开始构建错误页面:
<html>
<head></head>
<body>
::[REPLACE WITH CUSTOM ERROR TOKEN NAME]::
</body>
</html>5XX 错误页面示例
以下 HTML 代码是未添加样式的 5XX 错误页面示例:
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
<title>5XX Level Errors page</title>
</head>
<body>
<h1>5XX Level Errors</h1>
<h2>::CLOUDFLARE_ERROR_500S_BOX::</h2>
</body>
</html>您可以在 zone 级别或整个账户级别定义错误页面。Zone 级别的错误页面优先于账户级别的错误页面。
要编辑 zone 级别的自定义错误页面:
-
在 Cloudflare 仪表板中,前往 Error Pages(错误页面) 页面。
Go to Error Pages ↗ -
找到所需的自定义错误页面类型。
-
(可选)要预览当前错误页面(默认或自定义),请选择 Show(显示) 列中的链接。
-
要编辑错误页面,请选择您之前找到的页面类型旁的三点菜单 > Edit(编辑)。
-
要使用 Cloudflare 的默认页面,请选择 Cloudflare default page(Cloudflare 默认页面)。要提供自定义错误页面,请选择 Custom page(自定义页面) 并输入您创建的自定义错误页面的 URL。
-
选择 Confirm(确认)。
要更新账户级别的自定义错误页面:
-
在 Cloudflare 仪表板中,前往 Settings(设置) 页面。
Go to Configurations ↗ -
前往 Error Pages(错误页面) 并找到所需的自定义错误页面类型。
-
(可选)要预览当前错误页面(默认或自定义),请选择 Show(显示) 列中的链接。
-
要编辑错误页面,请选择您之前找到的页面类型旁的三点菜单 > Edit(编辑)。
-
要使用 Cloudflare 的默认页面,请选择 Cloudflare default page(Cloudflare 默认页面)。要提供自定义错误页面,请选择 Custom page(自定义页面) 并输入您创建的自定义错误页面的 URL。
-
选择 Confirm(确认)。
在 Error Pages(错误页面) 中成功设置自定义错误页面内容后,您可以从源服务器上移除该页面。
如果日后需要更新自定义错误页面,即使页面 URL 未更改,也必须重新获取该页面。在这种情况下,在要更新的页面类型旁,选择三点菜单 > Fetch custom page again(再次获取自定义页面)。