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

47 lines
3.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 本机部署核查使用说明
## 当前发布状态
2026年10月4日00:40:包含迁移二十五的 `e00a757` Linux 正式包已安装第一台。“重新核查不确定处置”已通过源码、三数据库持久化及一次真实提交方向收尾验证,原不确定历史保留。另已实测人工恢复基线、人工提交执行中断开 SSH 后重新登录菜单四查询成功。上述场景使用同一张有效证书,不替代不同版本证书回滚;其他服务器是否升级及其余场景须分别核实,各项实机验收状态以生产测试记录为准。
## 入口与权限
在 Scert 所在 Linux 主机的管理员交互终端执行:
```bash
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`,按新核查编号查询;不要再次提交原动作或手动删锁。
运行中处置、证据不足、身份变化及现场不满足收尾条件均拒绝,不因等待超时接管。当前仅已验证测试记录列明的人工处置与断连查询场景,不同版本证书回滚和完整首次生产验收仍须实测;不能把新增菜单视作这些验收已通过。