docs(design): add origin error page design

全局可配置源站错误页：默认 500-599、Cloudflare 风格模板、状态码透传与在线 HTML；配置进 Option 与配置版本快照。
2026-10-04 15:06:37 +08:00 · 2026-08-06 13:42:41 +08:00
parent 484b49d79d
commit fd62570431
5 changed files with 267 additions and 2 deletions
@@ -0,0 +1,22 @@
+# 源站错误页设计（Spec）
+
+> 权威正文与产品文档索引见：[docs/design/origin-error-page.md](../../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](../../design/origin-error-page.md)**