定制错误页面
IBM Cloud® Internet Services （ ）有多种错误代码，让我们能够区分具体问题。CIS 缺省情况下，这些错误页面会提及 Cloudflare；但是，您可以定制这些错误页面并为其设置品牌。 定制错误页面可帮助您为用户提供一致的体验，即使发生页面装入错误也是如此。
可定制的错误页面分为两个组:
质询
- 基本安全性
- Web 应用程序防火墙
- IP 防火墙（国家或地区块、国家或地区质询、IP（范围）块）
CIS 错误
- 502、504 和 CF 52X 错误
- 10XX 错误
- 与
Serve Stale Content相关的错误
500、501、503 和 505 响应不会触发定制错误页面，这是为了避免中断特定 API 端点和其他 Web 应用程序。 在源站无法响应请求时（520-526错误），保留自定义错误页面。
定制错误模板
以下示例是基本定制错误模板。 当您创建自定义错误模板时，最大页面大小为 1.5 MB，且页面不能为空。 此外，所有外部资源都使用 Base64 编码，发布时大约会增大50%。
<html>
<head></head>
<body>
::[REPLACE WITH TOKEN NAME]::
</body>
</html>
可用的定制错误令牌
某些类型的自定义错误页面必须在自定义错误页面的 HTML 中的任意位置包含其中一个标记。 每个错误页面只能有一个特定于页面的标记，因此，如果您想自定义每个错误，则必须为每个错误创建一个包含相应标记的自定义错误页面。
| 页面类型 | 令牌 |
|---|---|
| 所有页面 | ::CLIENT_IP:: |
| 所有页面 | ::RAY_ID:: |
| 基本安全性（验证码质询） | ::CAPTCHA_BOX:: |
| WAF（验证码质询） | ::CAPTCHA_BOX:: |
| 国家或地区质询（验证码质询） | ::CAPTCHA_BOX:: |
| 防卫方式（空隙页面） | ::IM_UNDER_ATTACK_BOX:: |
| 5XX 错误 | ::CLOUDFLARE_ERROR_500S_BOX:: |
| 1XXX 错误 | ::CLOUDFLARE_ERROR_1000S_BOX:: |
| 提供旧内容 | ::ALWAYS_ONLINE_NO_COPY_BOX:: |
样式错误代码
每个标记都具有唯一类，可用于设置单个错误代码的样式。 可以使用 CSS 来对 div/span/section 中的标记设置样式，因为这些标记都具有类标识。
每个页面（质询和 5xx 错误）都具有不同的标识，因此请使用预览选项来获取正确的标识。
发布错误页面
自定义错误页面后，就可以将其发布到我们的边缘服务器上了。 发布通过 定制页面 CLI 完成。
发布后，我们会对定制错误页面请求一次，然后在云的边缘上对其进行高速缓存。
更新错误页面
您可以通过重新发布错误页面来更新错误页面。
如果 CIS 无法加载您的网站，或者您在 CIS 防火墙中屏蔽了美国，则无法发布和预览错误页面。
对错误页面进行故障诊断
- 如果在尝试预览或发布定制错误页面时遇到错误，请通过 HTML 验证器运行该页面，并确保页面无错误。
- 确保最小页面大小大于 0。 您必须向页面添加内容。
- 确保提供的是带有状态码 200 的定制错误页面。
- 如果您的网站无法加载，或者您在IP防火墙中屏蔽了美国，则无法发布和预览错误页面。