Scert/doc/本机部署核查使用说明.md

本机部署核查使用说明

当前发布状态

2026年10月4日00:40：包含迁移二十五的 e00a757 Linux 正式包已安装第一台。“重新核查不确定处置”已通过源码、三数据库持久化及一次真实提交方向收尾验证，原不确定历史保留。另已实测人工恢复基线、人工提交执行中断开 SSH 后重新登录菜单四查询成功。上述场景使用同一张有效证书，不替代不同版本证书回滚；其他服务器是否升级及其余场景须分别核实，各项实机验收状态以生产测试记录为准。

入口与权限

在 Scert 所在 Linux 主机的管理员交互终端执行：

systemctl start Scert-admin

主服务必须已初始化并正常运行。本机管理员工具仍通过既有受保护的 Unix socket 通信，保留目录、权限和对端身份校验；不开放 HTTP 恢复接口，不增加 TCP 监听。密码重置仍必须通过绑定邮箱验证码，不因核查功能而跳过验证。

只读核查步骤

1. 在本机管理菜单输入 2，进入只读部署事务核查。
2. 每页最多显示五条待处理或需要恢复的事务，包含事务标识、服务器标识、阶段、状态和历史证据是否存在。
3. 输入 n 翻页，输入本页序号核查对应事务，输入 q 退出。
4. 核查结果显示目标文件、临时文件、备份文件的存在性与摘要比较，以及锁的存在性和归属判断。不显示证书内容、密码、私钥或锁令牌。
5. 一次核查完成后退出。若需要继续处理其他事务，重新启动本机管理员工具。

会话有效期为两分钟，每个会话最多处理三十二次核查请求；列表查询最多五秒，现场核查最多三十秒，并遵守更短的调用方期限。每个消息帧限制为十六 KiB，超限结果拒绝返回，不截取部分内容冒充完整核查。

结果边界

• 核查只读，不执行远端命令、不写文件、不建立或删除锁、不提交或回滚事务。
• 列表分页和现场读取都不是数据库或远端文件的一致性快照，其他操作可能同时改变现场。
• “历史证据已保存”仅说明记录存在，不代表部署已经通过生产验收；缺失的历史证据不会补造。
• 摘要匹配不等于 Nginx 重载成功，也不等于公共 HTTPS、SNI 或业务流量已经验证通过。
• 输入异常、过期、读取失败、响应超限或管理员配置发生变化时，终止会话，不将部分观察作为成功结果。
• 核查与密码重置不能在同一会话互相切换；需要切换时退出后重新启动。

重新核查不确定处置

以下流程仅适用于包含迁移二十五的新版本：

1. 启动本机管理员工具，选择菜单 5，输入已持久化为 uncertain 的原处置编号。
2. 核对原编号、新核查编号、事务、服务器与原动作方向。保留新核查编号，用于断连后查询。
3. 完整输入终端显示的中文确认文字。取消或过期不会提交，不能切换原提交或回滚方向。
4. 产品只重新核验，不重放远端文件修改或重载。全部文件、残留、锁、严格 HTTPS 及关闭检查通过后，以新审计结束原事务并释放占用，原不确定记录保留。
5. 断连或没有可靠结果时，重启工具选择菜单 4，按新核查编号查询；不要再次提交原动作或手动删锁。

运行中处置、证据不足、身份变化及现场不满足收尾条件均拒绝，不因等待超时接管。当前仅已验证测试记录列明的人工处置与断连查询场景，不同版本证书回滚和完整首次生产验收仍须实测；不能把新增菜单视作这些验收已通过。