Files

2.8 KiB

服务守护与健康面板

用户已确认优先实施“服务守护与健康面板”,本设计固化已批准方向,继续在当前开发分支实现。

服务常驻

独立 Node 守护进程启动业务服务,使用独立 IPC 通道发出正常停止请求,以随机令牌和实例 ID 验证两个本机 HTTP 心跳。业务进程退出或持续无响应后结束其进程树并重启;启动宽限 120 秒,运行时每 10 秒检查,连续 4 次失败才重启。重试退避 2/5/10/30/60 秒,15 分钟内 8 次失败后冷却 5 分钟。人工停止不触发恢复。

同一本机状态目录只允许一个守护进程,通过独占命名管道和受当前用户 ACL 保护的控制令牌实现;控制命令只接受 status/stop/restart,不暴露网页重启接口。不接管未知的占用端口进程。SQLite 保存守护状态和有限事件历史,日志轮转限制磁盘占用。业务启动脚本改为连接守护程序,重复打开不会重复启动。

Windows 登录自启动使用当前用户启动目录的专用快捷方式,隐藏启动独立守护程序,无须保存 Windows 密码。它在当前用户登录后启动,保留 DPAPI、SMB 会话和托管凭据的现有使用条件;不冒充未登录即可运行的系统服务。提供安装、移除、启动、停止、重启、状态 CLI。

健康面板

新增“系统健康”页面和登录后的只读接口,显示当前服务开始时间、连续运行时长、守护是否实际接管、最近心跳、恢复次数/原因、Windows 登录自启状态,以及 BPM 连接、扫描、SMB 检查和邮箱检查的最近已知结果。

健康收集只读已有状态,不为展示发起 BPM 登录、SMB 写入或邮件操作。独立健康 SQLite 保存观测到的最近成功/失败时间;扫描保留近期运行结果,BPM 使用持久 lastConnectedAt 补足成功时间。界面明确“上次检查结果”,未配置、停用、未检查与失败分开显示,不把历史成功称为实时连通。来源读取失败时单独显示该模块未知,不能阻断其他状态或心跳。BPM 明细按管理员/负责人权限过滤,不输出凭据、路径、邮件正文或完整表单。

浏览器在此页每 10 秒更新,离线时保留上次数据并明确显示重连状态;恢复后自动刷新,不需要反复手动刷新。

验证

隔离子进程测试覆盖真实退出/无响应恢复、退避限流、人工停止、重复实例和控制鉴权。健康测试覆盖历史持久化、来源异常、权限、未配置及不产生外部调用;真实浏览器验证刷新、断线提示、XSS 和窄屏。实际安装登录自启并检查快捷方式,接管本服务后通过独立控制命令重启一次验证会话及服务恢复。真实业务邮件不重发,未知结果沿用已有核验规则。