每个自定义错误令牌都会在错误页面上提供诊断信息或特定功能。某些错误页面需要使用该页面专用的自定义错误令牌。
若要为每种错误显示自定义页面,请为每种错误分别创建页面。例如,要同时为 IP/Country Block(IP/国家/地区拦截) 和 Interactive Challenge(交互式质询) 创建错误页面,必须分别设计和发布两个页面。
以下自定义错误令牌是其对应错误页面的必需项:
| Token | 必需用于 |
|---|---|
::CAPTCHA_BOX:: |
Interactive Challenge Country Challenge (Managed Challenge) Managed Challenge / I'm Under Attack Mode (Interstitial Page) |
::IM_UNDER_ATTACK_BOX:: |
Non-Interactive Challenge |
::CLOUDFLARE_ERROR_500S_BOX:: |
5XX Errors |
::CLOUDFLARE_ERROR_1000S_BOX:: |
1XXX Errors |
每个自定义错误令牌都有默认外观。不过,你可以使用 CSS,通过各标签的 class ID 来为每个自定义错误标签设置样式。所有外部资源(如图片、CSS 和脚本)会在处理过程中内联。因此,所有外部资源都必须可用(也就是必须返回 200 OK),否则会抛出错误。
自定义错误资源、内联响应或错误页面还可以包含以下错误令牌,这些令牌会在向访客发送响应之前替换为实际值:
| Token | 描述 |
|---|---|
::CLIENT_IP:: |
访客的 IP 地址。 |
::RAY_ID:: |
分配给经过 Cloudflare 的每个请求的唯一标识符。 |
::GEO:: |
与访客 IP 地址关联的国家或地区。 |