mirror of
https://github.com/Rain-kl/OpenFlare.git
synced 2026-09-29 14:06:36 +08:00
ryan
23 lines
1.1 KiB
Markdown
23 lines
1.1 KiB
Markdown
# 源站错误页设计（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)**
|