跳转到内容
搜索文档

编辑错误页面

最后更新 查看 MarkdownAgent 设置

您可以为以下错误和质询定义自定义 错误页面

  • WAF 拦截
  • IP/国家/地区拦截
  • IP/国家/地区质询
  • 500 类错误
  • 1000 类错误
  • 托管质询 / “我正受到攻击”(I'm Under Attack)模式
  • 速率限制拦截

有关不同类型错误页面的更多信息,请参阅 错误页面类型

若要为匹配特定条件的请求返回自定义错误响应,请改用 自定义错误规则

1. 设计自定义错误页面

在 Cloudflare 账户中定义自定义错误页面之前,您需要先设计和编写该页面。页面可以托管在您自己的 Web 服务器上,或使用 Snippets 等 Cloudflare 产品。

设计自定义错误页面时,可以包含特定于页面的 自定义错误令牌。每个自定义错误令牌都会在错误页面上提供诊断信息。

要为每种错误显示自定义页面,请为每种错误创建单独的页面。例如,要为 IP/Country BlockWAF 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>

2. 在仪表板中更新错误页面

您可以在 zone 级别或整个账户级别定义错误页面。Zone 级别的错误页面优先于账户级别的错误页面。

要编辑 zone 级别的自定义错误页面:

  1. 在 Cloudflare 仪表板中,前往 Error Pages(错误页面) 页面。

    Go to Error Pages ↗
  2. 找到所需的自定义错误页面类型。

  3. (可选)要预览当前错误页面(默认或自定义),请选择 Show(显示) 列中的链接。

  4. 要编辑错误页面,请选择您之前找到的页面类型旁的三点菜单 > Edit(编辑)

  5. 要使用 Cloudflare 的默认页面,请选择 Cloudflare default page(Cloudflare 默认页面)。要提供自定义错误页面,请选择 Custom page(自定义页面) 并输入您创建的自定义错误页面的 URL。

  6. 选择 Confirm(确认)

要更新账户级别的自定义错误页面:

  1. 在 Cloudflare 仪表板中,前往 Settings(设置) 页面。

    Go to Configurations ↗
  2. 前往 Error Pages(错误页面) 并找到所需的自定义错误页面类型。

  3. (可选)要预览当前错误页面(默认或自定义),请选择 Show(显示) 列中的链接。

  4. 要编辑错误页面,请选择您之前找到的页面类型旁的三点菜单 > Edit(编辑)

  5. 要使用 Cloudflare 的默认页面,请选择 Cloudflare default page(Cloudflare 默认页面)。要提供自定义错误页面,请选择 Custom page(自定义页面) 并输入您创建的自定义错误页面的 URL。

  6. 选择 Confirm(确认)

重新获取自定义错误页面

Error Pages(错误页面) 中成功设置自定义错误页面内容后,您可以从源服务器上移除该页面。

如果日后需要更新自定义错误页面,即使页面 URL 未更改,也必须重新获取该页面。在这种情况下,在要更新的页面类型旁,选择三点菜单 > Fetch custom page again(再次获取自定义页面)

这篇文档对您有帮助吗?