From 6f01d31f975691d34d5b362bb9d7f556fcee2dba Mon Sep 17 00:00:00 2001 From: Codex Date: Mon, 26 Oct 2026 14:45:00 +0800 Subject: [PATCH] docs: record public gateway recovery and verification --- docs/specs/SDD-005-nginx-live-public-entry.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/specs/SDD-005-nginx-live-public-entry.md b/docs/specs/SDD-005-nginx-live-public-entry.md index 1fd592d..0279477 100644 --- a/docs/specs/SDD-005-nginx-live-public-entry.md +++ b/docs/specs/SDD-005-nginx-live-public-entry.md @@ -4,7 +4,7 @@ |---|---| | 版本 / 变更级别 | 0.1 / S3 | | 设计状态 | 已形成 | -| 实现状态 | 已实现；本地 Go 测试及前端构建通过，生产热切换未演练 | +| 实现状态 | 已实现并部署；本地 Go 测试、前端构建及生产 HTTPS 回归通过，生产热切换未演练 | | 负责人 / 日期 | opsx-vpn / 2026-10-26 | | 关联需求 | 在 Nginx 模式修改 HTTP/HTTPS 公网入口，无须重启管理进程；管理端口保持 18080 | | 批准状态 | 用户提出修改 | @@ -47,16 +47,18 @@ | AC | 对应需求 | 前置与操作 | 预期结果 | 验证方式 | 结果 | |---|---|---|---|---|---| -| AC-01 | FR-01, NFR-01 | Nginx HTTPS 已启用，保存相同域名/端口 | 不重启，健康检查可用，状态即时同步 | 单测、实机回归 | 状态更新单测通过；在线保存待验证 | +| AC-01 | FR-01, NFR-01 | Nginx HTTPS 已启用，保存相同域名/端口 | 不重启，健康检查可用，状态即时同步 | 单测、实机回归 | 状态更新单测通过；线上保存操作未执行 | | AC-02 | FR-02 | 无证书、无效端口或模拟 reload 失败 | 不丢失旧入口、状态不变化 | 单测与配置检查 | 回滚单测通过；在线异常待验证 | | AC-03 | FR-03 | 尚未启用站点保存，再启用 | 不要求重启；Go 模式仍准确提醒 | 单测、前端构建 | 本地通过；首次启用实机待验证 | | AC-04 | FR-04 | 有 OIDC 专线运行时修改回调根地址 | 拒绝并保留原站点 | API 模块测试 | 本地拒绝与停用后放行测试通过；在线拒绝路径待验证 | -| AC-05 | FR-05 | 已保存 HTTP 草稿，运行站点仍为 HTTPS | 重启后不重写站点，运行态 issuer 仍为 HTTPS | 解析单测、运行态单测、实机回归 | 本地测试通过；历史草稿实机待验证 | +| AC-05 | FR-05 | 已保存 HTTP 草稿，运行站点仍为 HTTPS | 重启后不重写站点，运行态 issuer 仍为 HTTPS | 解析单测、运行态单测、实机回归 | 本地测试通过；生产历史草稿未再次演练 | ## 6. 发布与恢复 本地 Go 测试、前端构建通过后提交。若部署，先备份程序/数据库和托管站点，保持 HTTPS 现状，先构建前端和后端，再切换管理进程。核验公网 HTTPS、OIDC 发现、`nginx -t`、OpenVPN 进程与 18080 健康。故障时恢复旧程序和站点并 reload；不删除证书或 `data/`。不计划在线演练切换为 HTTP。 +2026-10-26 发布回归：旧版在 14:19 已保存 HTTP:28080 草稿，首次升级重启时启动同步按该草稿将 Nginx 切至 28080，导致 HTTPS:443 暂时不可达。保留 HTTP 配置与站点的 `/tmp` 副本后，将数据配置及站点恢复 HTTPS:443、重新加载 Nginx 并重启管理服务；随后补充运行站点与草稿比对保护，部署提交 `97da0a5`。最终 `nginx -t`、公网健康、登录页及 HTTPS OIDC issuer 正常，80/443 与 18080 监听正常，OpenVPN 和认证组件存活。未执行生产 HTTP 切换或在线保存操作。 + ## 7. 待决问题 | 问题 | 是否阻塞 | 推荐方案 |