修复Linux启动就绪通知并隔离命令行测试目录

通过本机Unix套接字报告HTTPS监听状态,同步服务配置与安装模板,保持初始化业务就绪隔离。补充生命周期回归并修复旧CLI测试误用正式目录的问题。更新Linux原生测试证据,明确新候选尚未部署、生产验收未放行。
This commit is contained in:
xuans committed 2026-10-02 12:20:47 +08:00
1 parent b6b964203d
commit 0b74886c45
24 files changed
+647 -21

No files matched your search

+3 -1
View File
@@ -7,7 +7,9 @@ Wants=Scert-storage.socket
After=Scert-storage.socket
[Service]
Type=simple
Type=notify
NotifyAccess=main
TimeoutStartSec=90
User=Scert
Group=Scert
WorkingDirectory=/scert
+13
View File
@@ -1,5 +1,18 @@
# Scert 服务管理说明
## 当前 Linux 启动状态与安全边界
本节为当前实现说明。新版本核心服务使用 Type=notify、NotifyAccess=main、TimeoutStartSec=90,仅向 systemd 提供的本机 Unix 数据报套接字发送监听通知,不新增 TCP 端口或防火墙放行规则。
- 正式服务在 HTTPS 接收循环启动、且未观察到本机恢复通道或 HTTP 退出后发送通知;发送失败则终止启动,不启动续期任务。
- 首次初始化在临时 HTTPS 开始接收时发送等待配置状态,避免 systemctl start 等待用户完成整个初始化。此时业务 readyz 仍为 503,不能放行业务验收。
- 没有 NOTIFY_SOCKET 时保持普通命令行启动行为;服务管理器配置通知地址但连接失败时不静默降级。
- active 仅表示完成当前阶段监听启动,不证明数据库、DNS 凭据、证书或 Nginx 上游健康;仍需独立检查 readyz 及严格 HTTPS。
- 单实例停止到重新监听期间仍可能出现代理错误;本修改不是无中断升级机制,不得据此宣称重启零 502。
- 升级必须配套替换新二进制与 unit,并执行 daemon-reload。不得将新 notify unit 单独配给不支持通知的旧程序。
- 主服务保持回环监听,经 Nginx 80/443 对外访问。超级管理员恢复继续使用受保护的本机 IPC,不增加公开恢复 HTTP 路由;后文旧管理激活说明不作为当前恢复方案。
## 核心服务职责
`Scert` 是证书管理核心服务,负责 Web 管理接口、证书任务、数据库访问和后续的申请、续期、部署与校验流程。服务运行用户为 `Scert`,默认工作目录为 `/scert`。