修正Linux发行运维说明并记录实库全量回归结果

This commit is contained in:
xuans committed 2026-10-03 22:05:55 +08:00
1 parent e0d16a6ab1
commit a5dfd42b4e
10 files changed
+114 -33

No files matched your search

+8
View File
@@ -1,5 +1,13 @@
# Linux 生产流程测试记录
## 2026年10月3日22:03 外部数据库整组终态
- [✓] 21:57 通过原 SSH 监控会话实查 `scert-external-disposition-20261003-2143.service`:MainPID=0、ActiveState=inactive、Result=success。
- [✓] 原日志 `/var/tmp/scert-local-recovery-20261003-1828/external-disposition.log` 中 `EXTERNAL_POSTGRES_EXIT`、`EXTERNAL_MYSQL_EXIT`、`EXTERNAL_SQLITE_REGRESSION_EXIT`、`EXTERNAL_VET_EXIT`、`EXTERNAL_FULL_EXIT` 均为 0。
- [✓] SQLite 执行器竞态约 5.519 秒,后端普通全量中的 HTTP 包约 44.928 秒;本组未清理生产数据库、未重启业务服务。
- [~] 正在修正实际发行运维说明,随后从干净提交构建 Linux 候选包;首次回环反代、系统邮件、真实 SSH/TLS 和完整生产验收尚未完成。
## 2026年10月3日21:48 外部数据库专项
- [✓] 21:41 实查 `scert-local-actions-fixed-20261003-2125.service` 已 inactive、MainPID=0、Result=success,`LOCAL_ACTIONS_FIXED_HTTP_FULL_RACE_EXIT=0`;HTTP 全包竞态约 393.752 秒,五项检查完整通过。
+7
View File
@@ -1,5 +1,12 @@
# Scert 开发任务清单
## 2026年10月3日22:03 当前开发进度
- [✓] 最新外部实库、SQLite 执行器竞态、静态检查及后端全量均完成,五项退出码零;不再重复启动该任务。
- [~] 修正实际发行文件中的旧管理员 Web 重置与不安全网络说明。
- [ ] 干净提交构建 Linux 候选包;正式终端、双机推送、系统邮件和三数据库首次 Web 仍需生产证据。
## 2026年10月3日21:48 当前开发进度
- [✓] 本机协议/终端接入的五项 Linux 回归全部正常结束;`0f2e6bf` 已提交推送。
+7
View File
@@ -1,5 +1,12 @@
# Scert 整改任务执行清单
## 2026年10月3日22:03 最新执行结论
- [✓] `scert-external-disposition-20261003-2143.service` 已结束:MainPID=0、inactive、Result=success,五项退出码零。
- [~] 本轮只修正 Linux 发行运维说明并准备正式包;公网只用 Nginx 80/443,管理恢复只走受保护本机通道。
- [ ] Linux 候选包及双机实际部署验收尚未完成;测试回归不替代生产验收。
## 2026年10月3日21:48 最新执行结论
- [✓] 本机接入整组 Linux 回归正常结束,五项退出码零;检查点 `0f2e6bf` 已推送。
+10
View File
@@ -1,5 +1,15 @@
# Scert 整改、合并与优化清单
## 2026年10月3日22:03 发行前收尾任务
沿用已确认的 Linux 上线范围;不处理 Windows,不反复检查磁盘,仅在实际不足时清理。本节优先于历史进度。
- [✓] 21:57 实查外部数据库整组任务已正常结束:PostgreSQL、MySQL、SQLite 竞态、静态检查和后端全量五项退出码均为零。
- [~] 修正发行包中的旧 Web 重置、验证码文件和放宽 TLS 的说明,使其与受保护本机终端及仅 Nginx 80/443 的边界一致。
- [ ] 从干净提交构建 Linux 候选包,核对源码提交、清单与归档哈希。
- [ ] 第一台正式安装及管理员交互,第二台真实推送、失败回滚与恢复;首次 Web、系统邮件和完整生产门禁仍未通过。
## 2026年10月3日21:48 实库与本机入口进度
- [✓] R3 本机接入修复版任务已正常结束,五项退出码零,HTTP 全包竞态约 393.752 秒;代码检查点 `0f2e6bf` 已推送。
+11 -9
View File
@@ -128,16 +128,18 @@ linux-amd64/
```bash
chmod +x install-linux.sh scert scert-admin
sudo ./install-linux.sh --source-dir . --certificate-dir /ssl
sudo ./install-linux.sh --source-dir . --certificate-dir /ssl/scert
```
安装器不会自动启动服务,也不会创建公网防火墙或云安全组规则。首次安装还没有正式配置时,应先启动服务,再通过独立 Bootstrap HTTPS 页面初始化;不需要 Linux 图形界面。
安装器不会自动启动服务,也不会创建公网防火墙或云安全组规则。证书目录使用 Scert 专属子目录,不接管共享 `/ssl`。首次安装通过 Bootstrap HTTPS 页面初始化;本轮公网只使用 Nginx 的 `80/443`,内部服务从首次启动起保持回环监听。
默认初始化监听 `0.0.0.0:8080`。管理员应预先在主机防火墙和云安全组中只对受信任的管理来源放行该端口。如果已有端口占用,先设置 `SCERT_SERVER_PORT` 使用空闲端口。云主机公网 IP 不在本机网卡上时,先使用 `sudo systemctl edit Scert` 写入以下配置(示例 IP 必须替换为实际管理机 IP):
不得沿用默认公网监听或放行 `8080`。首次启动前使用 `sudo systemctl edit Scert` 写入以下配置;内部端口须确认空闲,并与向导最终配置及 Nginx 上游一致:
```ini
[Service]
Environment="SCERT_BOOTSTRAP_PUBLIC_IP=203.0.113.20"
Environment="SCERT_SERVER_HOST=127.0.0.1"
Environment="SCERT_SERVER_PORT=9004"
Environment="SCERT_BOOTSTRAP_FIREWALL_MODE=external"
```
`SCERT_BOOTSTRAP_PUBLIC_IP` 只决定临时初始化地址和证书的 IP,不会改变监听地址、云安全组或最终管理地址。命令行运行时对应参数是 `scert serve --bootstrap-public-ip <服务器公网IP>`。修改 systemd 配置后执行:
@@ -150,15 +152,15 @@ sudo systemctl status Scert --no-pager -l
sudo cat /run/scert/bootstrap-url
```
通过可信运维通道读取并在浏览器打开完整 HTTPS 地址,不能只复制 IP 部分。链接片段包含短期一次性令牌;不要复制到日志、截图、工单或普通文档。地址文件仅允许服务用户和管理员读取,完成初始化或服务退出后会清理;令牌或会话过期时重启尚未初始化的服务再读取新地址,不要删除正式配置强制重新初始化。
受保护地址文件中的内部地址不是公网入口。应通过已经严格验证上游证书及名称的 Nginx 入口访问,浏览器端仍须验证正常域名及可信链;首次反代及切换正式证书尚需实机验证。链接片段包含短期一次性令牌,不要复制到日志、截图、工单或普通文档。地址文件仅允许服务用户和管理员读取,完成初始化或服务退出后会清理;不要删除正式配置强制重新初始化。
临时 HTTPS 使用自签名证书,不代表公共 CA 信任。浏览器首次打开裸 IP 地址时,应先查看证书详情,通过已核对 SSH 主机身份的运维连接或云控制台读取当前启动日志:
初始化上游使用临时自签名证书,不代表公共 CA 信任。建立限定用途的上游信任前,先通过已核对 SSH 主机身份的运维连接或云控制台读取当前启动日志:
```bash
sudo journalctl -u Scert -b -n 30 --no-pager
```
找到最新的 `Bootstrap 临时证书 SHA-256 指纹`,与浏览器证书详情的 SHA-256 指纹逐字比较(忽略显示分隔符和大小写)。必须一致才打开含一次性令牌的完整链接并填写敏感配置;不一致立即停止,不要输入 RAM 凭据或管理员密码。每次未初始化服务重启都会生成新证书,旧日志的指纹不能用于当前核对。指纹是公开证书摘要,日志不包含完整初始化链接、令牌或私钥。不得把“忽略证书警告”本身当作生产 TLS 验收;本轮仍缺少真实浏览器核对证据。
找到最新的 `Bootstrap 临时证书 SHA-256 指纹`,与回环上游实际证书的 SHA-256 指纹逐字比较;不一致立即停止,不得输入 RAM 凭据或管理员密码。核对后仍须保持 Nginx 上游的证书及名称验证,不能通过关闭 TLS 校验接通代理。每次未初始化服务重启都会生成新证书,旧日志的指纹不能用于当前核对。指纹是公开证书摘要,日志不包含完整初始化链接、令牌或私钥。上游核对不代替浏览器到 Nginx 的域名和公共信任验证。
向导依次配置管理员、存储、阿里云 RAM 与域名验证、通知和正式管理入口:
@@ -168,13 +170,13 @@ sudo journalctl -u Scert -b -n 30 --no-pager
- 正式入口可选择域名或 IP;域名证书需要真实 DNS/ACME 验证,IP 入口当前为自签名证书。默认 ACME staging 证书也不受公共信任,不能当作 production 证书。
- 保存成功后,临时初始化服务撤销会话并关闭,再自动加载正式配置启动服务,页面转到返回的正式 HTTPS 地址,无需手工重启切换。
若首次端口与正式端口不同,应由管理员预先准备正式端口规则,确认切换后关闭不再需要的初始化端口。服务不会代替管理员修改云安全组。固定及动态生成的 Linux systemd unit 显式设置 `SCERT_BOOTSTRAP_FIREWALL_MODE=external`:不运行 UFW/firewalld 查询和写入命令,完成响应及运维日志明确提示端口尚未检查。管理员应在首次访问前按受信任来源放行所需端口;反向代理模式仅允许代理访问内部端口,不能为方便初始化而向公网开放内部端口。
首次与正式端口都只能监听回环;若端口不同,应同步准备 Nginx 上游切换,不新增公网放行规则。固定及动态生成的 Linux systemd unit 显式设置 `SCERT_BOOTSTRAP_FIREWALL_MODE=external`:不运行 UFW/firewalld 查询和写入命令,完成响应及运维日志明确提示端口尚未检查。服务不会代替管理员修改云安全组,不能为方便初始化而向公网开放内部端口。
直接执行 `scert serve` 默认仍为 `auto`,自动防火墙操作限时三十秒,权限错误必须中止初始化,不会因失败自动切换外部模式。使用外部策略时可显式传入 `--bootstrap-firewall-mode external`,参数优先于同名用途的 `SCERT_BOOTSTRAP_FIREWALL_MODE` 环境变量。策略只能由本机启动配置选择,不能由浏览器提交。2026-09-17 已通过非特权 systemd 的隔离 Bootstrap 启动与重启协议检查,正式初始化完成及公网可达性仍待验收,不得将整个 Scert 服务改成 root 或取消加固。
主服务地址族白名单必须包含 `AF_NETLINK`,用于 Go 读取本机网卡并生成临时证书;缺失时会出现 `netlinkrib: address family not supported by protocol`。保留空 capability 集,不需要授予 `CAP_NET_ADMIN`。此要求只适用于主服务,不得照搬到仅允许本地 IPC 的超级管理员恢复服务。
反向代理方案应在初始化完成后再应用第 5 节的回环监听配置;若预先设置 `SCERT_SERVER_HOST=127.0.0.1`,远程浏览器将无法直接访问 IP 初始化端口。`SCERT_SERVER_PORT` 等环境变量会持续覆盖向导保存的配置,应与最终选项一致。
回环监听必须在初始化前应用,远程浏览器只使用 Nginx 入口,不直连内部 IP 端口。`SCERT_SERVER_PORT` 等环境变量会持续覆盖向导保存的配置,应与最终选项一致。代理可信链尚未接通时必须先修复,不得退回公网直连。
上述是新版源码的预期安装流程,不代表本轮已构建发布包或完成 Linux systemd 实机验收。
+7
View File
@@ -1,5 +1,12 @@
# 部署事务人工处置设计
## 2026年10月3日22:03 回归完成与发行边界
- [✓] 新增实库测试后的 SQLite 竞态、静态检查和后端全量均通过;同组 PostgreSQL/MySQL 专项通过,任务已正常结束。
- [~] 发行说明同步当前本机交互设计:不提供 HTTP/TCP 恢复入口、不使用验证码文件,断连只能按处置编号查询,禁止重放或手动删锁。
- [ ] 正式 Linux 包、真实终端及双机文件和 HTTPS 验证仍属于待完成门禁。
## 2026年10月3日21:48 外部持久化证据
- [✓] 本机接入五项回归已全部通过,包括 HTTP 全包竞态。
@@ -1,5 +1,12 @@
# 部署事务人工核查任务清单
## 2026年10月3日22:03 本机处置回归终态
- [✓] R4 最新 PostgreSQL/MySQL 实库、SQLite 执行器竞态、静态检查及后端全量全部正常结束,五项退出码零。
- [~] R5 修正正式包管理员单元和操作说明中的旧网页重置流程,改为真实本机终端、邮箱验证、三动作及断连查询。
- [ ] R5 实际 systemd 交互和真实 SSH/TLS 动作尚未验证,不能把实库中的远端夹具记作生产通过。
## 2026年10月3日21:48 外部数据库复核
- [✓] R3-F/G/H 本机接入源码回归全部结束,HTTP 全包竞态通过;正式包入口尚待验证。