Files
OpenFlare/docs/superpowers/specs/2026-08-06-origin-error-page-design.md
T
ryan fd62570431 docs(design): add origin error page design
全局可配置源站错误页:默认 500-599、Cloudflare 风格模板、
状态码透传与在线 HTML;配置进 Option 与配置版本快照。
2026-08-06 13:42:41 +08:00

1.1 KiB
Raw Blame History

源站错误页设计(Spec)

权威正文与产品文档索引见:docs/design/origin-error-page.md
本文为 brainstorming 流程落库副本,内容与上者保持一致。


摘要

源站/网关在用户配置的状态码(默认标签 500-599,支持 522 与 500-599 区间)上,返回全局可配置 HTML 错误页,替代当前透传行为。默认 Cloudflare 风格页;可在线自定义 HTML。HTTP status 保持原错误码,正文通过 {{status}} / {{host}} 展示。配置挂在 OpenFlare Option,随配置版本发布;侧栏「网站管理 → 错误页」。可关闭以恢复透传。

方案

方案 A(已采纳):全局 Option → 配置快照 ConfigSnapshot → OpenResty 渲染 proxy_intercept_errors + error_page + internal location 模板替换。

非目标:按路由覆盖、上传文件、Pages 路由、改 WAF 自有页。

详细章节

完整章节(目标、状态码语法、配置模型、边缘渲染、前端、测试、实现清单、决策记录)见:

docs/design/origin-error-page.md