feat: split openresty settings into performance page

This commit is contained in:
ryan
2026-03-12 23:51:57 +08:00
parent 97b67720bc
commit 238546b358
16 changed files with 1562 additions and 1031 deletions
+4 -2
View File
@@ -63,6 +63,7 @@ ATSFlare 当前定位为内部自用的反向代理控制面,不面向外部
* 主配置文件由 Server 统一生成并由 Agent 受控落地,不开放节点侧手改后再回传合并
* 性能优化参数统一在 Server 配置,不支持按节点分叉不同性能模板
* 第五版不开放任意自定义 Nginx/OpenResty 片段上传,不提供任意指令执行入口, 但是需要保留拓展能力, 为后续开放准备
* 允许在管理端提供 OpenResty 主配置模板编辑能力,但模板必须保留 ATSFlare 预留占位符,确保性能参数、证书目录与受管路由 include 继续由 Server 统一渲染
新增能力超出上述边界时,必须先更新本文档,再进入实现。
@@ -122,7 +123,7 @@ ATSFlare Agent (register / heartbeat / sync / apply / update)
职责分工:
* Server 负责配置、版本、节点、设置、管理端 UI 以及 OpenResty 主配置渲染
* Server 负责配置、版本、节点、设置、管理端 UI 以及 OpenResty 主配置模板渲染
* Agent 负责本地落盘、校验、reload、回滚、自更新,不负责维护独立于 Server 的主配置真相
* 发布通过“生成完整版本并激活”完成
* 历史版本不可变
@@ -152,6 +153,7 @@ ATSFlare Agent (register / heartbeat / sync / apply / update)
* 域名与证书匹配同时支持精确匹配与通配符匹配
* 节点专属 `agent_token` 必须可立即失效
* OpenResty 性能优化参数与缓存参数统一由 Server 设置管理,不允许节点侧形成额外配置源
* OpenResty 主配置模板允许编辑,但必须保留系统要求的占位符,不能绕过结构化参数校验与受管 include 注入
* Agent 只应用受控主配置文件,不提供任意配置片段拼接入口
---
@@ -215,7 +217,7 @@ ATSFlare Agent (register / heartbeat / sync / apply / update)
负责:
* 管理端页面、布局、交互与主题
* 规则、版本、节点、证书、域名、用户、设置等页面
* 规则、版本、节点、证书、域名、用户、设置、性能等页面
* 统一请求层与前端状态管理
---
+3 -1
View File
@@ -30,7 +30,7 @@
* 默认不引入 Redis、MQ、对象存储等新基础设施
* 不为未确认的平台化能力预埋复杂抽象
* OpenResty 性能参数与缓存参数优先复用现有 `Option` 体系管理,不为单一版本额外引入配置中心
* OpenResty 性能参数、缓存参数与主配置模板优先复用现有 `Option` 体系管理,不为单一版本额外引入配置中心
### 2.2 Agent
@@ -179,6 +179,7 @@ Agent:
* 用通用 shell/命令执行方式替代受限节点操作接口
* 在日志中打印完整 Token
* 为性能优化需求开放任意 OpenResty 文本片段上传或任意指令下发
* 允许绕过系统占位符约束直接保存不可渲染的 OpenResty 主配置模板
---
@@ -199,6 +200,7 @@ Agent:
* 主配置文件的真相源在 Server,Agent 只负责受控写入、校验与回滚
* 性能优化参数必须通过结构化字段渲染,禁止直接拼接未经校验的自由文本
* 新增参数命名统一采用 `OpenResty...` 前缀,布尔值、整数、大小单位和时间单位必须在更新入口做校验
* 主配置模板编辑必须保留系统要求的占位符,由 Server 在发布与预览时再渲染为最终 `nginx.conf`
版本号格式保持:
+3 -1
View File
@@ -47,13 +47,14 @@
* 平台化缓存产品、Purge 系统、分层缓存、节点差异化缓存策略
* 任意文本片段注入、任意 OpenResty 指令执行、节点侧自定义模板合并
* 绕过占位符约束的主配置模板直写
* 引入 Redis、Prometheus、消息队列等新基础设施作为第五版前置条件
## 4. 第五版实施顺序
建议按以下顺序推进:
1. 补齐 Server 侧 OpenResty 性能参数模型、默认值、校验规则与设置页入口
1. 补齐 Server 侧 OpenResty 性能参数模型、默认值、校验规则与性能页入口,并补充主配置模板编辑能力
2. 扩展配置渲染结果,使版本快照覆盖主配置文件与路由配置文件
3. 调整 Agent 本地应用链路,支持主配置写入、校验、reload、失败回滚
4. 补齐预览、diff、应用结果与日志,确保第五版能力可观测
@@ -64,6 +65,7 @@
完成第五版时至少满足:
* 管理端可以查看并修改第一批 OpenResty 性能优化项
* 管理端提供独立“性能”页面,支持结构化设置与主配置模板编辑/预览
* 性能优化项保存后进入统一发布链路,而不是节点即时生效
* Agent 可以接管主配置文件,并在 `openresty -t` 失败时完整回滚
* 配置预览或 diff 能体现主配置与关键性能参数变化
+1
View File
@@ -55,6 +55,7 @@
* TLS 证书
* 用户管理
* 设置
* 性能
* 登录、注册、重置密码、GitHub OAuth、关于页
---