整改基线:封存无停机续期候选及远程回归证据
Security Checks / security (push) Waiting to run

This commit is contained in:
xuans committed 2026-09-18 00:33:42 +08:00
1 parent 06c49e88b7
commit 9aff6f9dfb
12 files changed
+879 -110

No files matched your search

+11 -1
View File
@@ -1,5 +1,13 @@
# Nginx 反代与证书部署说明
## 最新整改状态
远程主机 2026-09-18 00:22 已将 Nginx 证书路径迁移为 `/opt/smail/ssl/custom.crt`、`custom.key`,不再直接使用签发目录。只对 Smail 站点执行路径迁移和平滑重载,正式证书、应用程序、其他站点配置未改动。58 次双站 HTTPS 探测和预先建立的下载连接通过,七个 TLS/STARTTLS 入口再次通过。
仓库中的续期和部署脚本已改为 DNS 验证、校验快照、平滑重载、实际指纹检查及失败回退,27 项远程隔离回归通过。由于缺少专用 DNS 授权和真实挑战证据,线上续期脚本及 systemd 单元尚未替换,旧自动任务仍然存在到期停机风险。不得把仓库候选代码、未到期检查或路径迁移当作无停机续期已经启用。
实时配置确认 Scert 已使用 `web.apmmk.cn:443`,不再监听旧记录中的 8003/8004。本轮没有修改其配置。完整证据、失败过程和启用门槛见《无停机续期整改记录》;以下签发和维护窗口章节保留原部署过程。
## 已部署拓扑
2026-09-17 在 47.108.78.12 部署,本机不运行应用测试。
@@ -27,7 +35,7 @@
- 有效期:2026-09-17 13:54:40 UTC 至 2026-12-16 13:54:39 UTC。
- 叶证书 SHA256:`608fb55e3b8add3426a63f672debd86a58389a1a78d0961b9603b2e1abecae43`。
- ACME 状态目录:`/var/lib/smail-acme-tls`,0700,仅 root 使用。
- Nginx 证书:上述目录下的 `certificates/solit.cn.crt` 和 `solit.cn.key`。
- Nginx 证书:现为 `/opt/smail/ssl/custom.crt`、`custom.key`;初次部署曾直接使用上述签发目录,最新整改已分离。
- Smail 证书:`/opt/smail/ssl/custom.crt` 和 `custom.key`,属主 smail,0600。新握手热加载,不为换证重启邮件服务。
HTTP-01 测试失败,CA 报告部分节点收到 403 或连接重置,本机 Nginx 仅记录部分节点的 200。外部路径原因尚未定位,不能断言具体运营商策略。改用 TLS-ALPN-01 后,五个域名的测试和正式签发均成功,没有使用 DNS 密钥。
@@ -36,6 +44,8 @@ lego 固定为项目同版本 v4.34.0,官方发布包 SHA256 为 `c681c09d3f2a
## 续期运维
本节描述当前仍在运行的旧续期任务,不是仓库中待启用的 DNS 候选。两个新脚本必须成套部署,不能将带互斥锁的新部署脚本单独混入持锁后再启动子进程的旧续期实现。
脚本安装在 `/usr/local/libexec/smail-acme/`。`smail-certificate-renew.timer` 每日 04:00 加 0 至 30 分钟错峰运行;未到期时校验证书并确认运行文件已同步,不暂停 Web。剩余不足 30 天时执行续期,复用密钥,避免证书与私钥切换间隙。
续期会暂停 Nginx 使用公网 443。执行上限 150 秒,服务总超时 240 秒,正常异常路径使用 `finally` 恢复,systemd `ExecStopPost` 额外覆盖任务终止后的恢复。邮件服务不随 Nginx 停止。此方案存在短暂 Web 维护窗口,不是无中断续期。
+70
View File
@@ -0,0 +1,70 @@
# 无停机续期整改记录
## 范围与当前结论
远程主机时间:2026-09-18 00:00 至 00:24,时区为 Asia/Shanghai。测试仅在 `47.108.78.12` 执行,本机仅编辑和传输。本文中的日期以远程命令及证据时间为准。
- [✓] 明确原停机原因:线上旧脚本使用 TLS-ALPN-01 独占公网 443,并显式停止整个 Nginx 服务。
- [✓] Nginx 已从签发目录迁移到 `/opt/smail/ssl/custom.crt`、`custom.key`,与 Smail 共用已发布证书;8001/8002、上游 TLS 校验及其他站点配置未改动。
- [✓] 27 项远程隔离回归通过,包括真实独立 Nginx 换证、平滑重载和失败回退后的实际 TLS 指纹验证。
- [✓] 线上配置迁移期间两站点 58 次 HTTPS 请求全部成功,一条迁移前已建立的下载连接完整返回 312,377 字节;主服务进程未重启。
- [✓] 候选脚本在真实未到期状态完成系统信任、域名、密钥、权限和线上证书一致性检查;七个 TLS/STARTTLS 入口再次通过。
- [!] DNS-01 候选未替换线上续期脚本和 systemd 定时任务。尚无 Smail 专用 DNS 凭据配置,不得借用 Scert 凭据,也不能以模拟结果代替真实挑战。
- [!] 全新 DNS 挑战、正式新证书签发发布、外部失败和到期告警未验收;整体生产放行仍不通过。
本轮没有清库、发送业务邮件、重置账号、重编译应用或停止共享服务。正式证书、程序及现有续期脚本均未替换,不构成最新应用首次安装或业务浏览器验收。
## 代码变更
`deploy/nginx/renew_certificate.py` 使用 `SMAIL_ACME_DNS_PROVIDER` 指定 DNS 服务商,不再调用 `stop/start nginx`,不允许配置缺失时退回停机验证。依据线上实际使用证书判断是否临近到期,而不是依据签发目录中的候选证书。ACME 正式服务地址显式指定,命令超时为 600 秒,保留密钥复用及互斥控制。
`deploy/nginx/deploy_certificate.py` 与续期入口共用同一进程锁。候选、旧证书和旧私钥首先保存到 root 专属快照,再对同一份快照进行系统信任链、五个域名、服务用途、剩余至少七天有效期以及私钥匹配验证。普通续期只允许复用已有密钥,密钥轮换另行验收。
发布后执行 `nginx -t`、平滑重载,并实际检查 443 和 8002 的系统信任及证书指纹。失败时恢复旧文件、重新重载并检查旧指纹。文件已经一致但线上仍使用旧证书时,会补做重载,避免上次任务在写文件后被中断导致永久不同步。校验快照和回退副本保留在 `/var/backups/smail-certificate-*`,不会自动删除。
候选 service 移除了 `ExecStopPost` 启动 Nginx 的旧钩子,支持 `/etc/smail/acme-dns.env`,总超时 720 秒。原有 96/128 MiB、禁用交换空间、CPU 和任务数限额保留。`acme-dns.env.example` 只包含空白凭据示例,不是可直接启用的正式授权。
历史维护窗口工具 `test/deployment/renewal_drill.py` 增加旧续期脚本摘要限定,拒绝将原先针对停机实现的演练用于新的 DNS 实现。
修正 `test/tools/remote_review.py`:项目审查上传目录使用 `0700`,不再把已保护的目录改回 `0755`。已通过真实上传后的远程权限检查确认。
## 隔离测试证据
证据目录:`/var/tmp/smail-review-cert-safe-20260918`。
最终日志:`tests-final-2.txt`。单元 `smail-cert-safe-tests-20260918-0025` 返回成功,27 项通过,零跳过;运行约 3.609 秒,内存峰值约 22.3 MiB,交换空间为零。这不是生产容量结论。
测试使用独立网络空间和只读系统目录,禁止访问线上应用、正式 ACME 状态、管理 socket 及 Nginx 配置。测试证书由隔离 CA 签发,只有隔离验证上下文信任,不导入系统信任库。真实 Nginx 实例监听隔离空间的 18443/18002,测试完成后仅终止该测试实例。
覆盖申请失败及超时不停止业务、不发布候选;未配置或非法服务商拒绝;不可信链、错误域名、临近到期、私钥不匹配及密钥轮换拒绝;并发、锁权限、证书权限、符号链接拒绝;重载失败和线上指纹失败回退;中断后的重载补偿;候选文件在快照后变化不能影响发布内容。
第一轮 23 项模拟及文件系统回归通过。新增真实 Nginx 测试首次失败,是该实例试图使用被只读保护的主机 `/var/lib/nginx/body`,并非生产服务故障;随后将其全部临时路径指向隔离测试目录。失败日志 `tests-final.txt` 与最终通过日志均保留,未放宽隔离边界。
`candidate-live-check.txt` 为候选脚本的真实未到期检查,成功返回;运行约 450 毫秒,峰值约 11.8 MiB。应用和 ACME 目录只读挂载;本次未申请证书、未改正式文件,也没有替换线上定时任务。其受保护快照为 `/var/backups/smail-certificate-20260917T162339-e3f3d284`,名称时间为 UTC。
## 线上迁移证据
最终目录:`/var/tmp/smail-review-cert-safe-20260918-cutover-final`。
- `cutover-result.json`:完整前后摘要、服务状态、连续探测和下载证据。
- `smail.conf.before`:原 Smail 站点配置,迁移工具只接受已核对的原配置摘要和仅变更两条证书路径的候选配置。
- `cutover-output.txt`:单元 `smail-cert-cutover-20260918-4` 执行输出。
- `transport-result.json`:七个 TLS/STARTTLS 入口、Host/SNI 和 HTTP 跳转复测。
迁移时间为本地 00:22:31 至 00:22:38,仅执行一次平滑重载。Nginx 主进程 `578671`、Smail 主进程 `574584` 及各自 InvocationID 前后一致。两站点探测使用 `mail.solit.cn:443` 和 `web.apmmk.cn:443`,没有关闭系统信任或域名校验。
下载使用线上实际资源 `/assets/main-app-96760af3.js`,重载前建立连接并读取前 1024 字节,重载后读取余下内容,与独立请求返回的完整内容比较相同。此项证明本次已有下载连接完成,不扩大为任意长连接或长期可用性保证。
Smail 站点配置 SHA-256 从 `2c6e42ce1c996947a13b35bddd9840888a4bd9e7e2de7480954daa3fafbb18a4` 变为 `bf6816c38f9c639ab17fd7344fff4b06afc5a2388f74318e18c60b8b3311ebd8`。其他站点配置、正式证书、私钥、应用双程序和线上续期脚本摘要未变。
迁移前有三次拒绝或失败,均未修改线上配置:第一次权限检查发现上传目录变为 0755;第二次发现入口 JS 仅为小型引导脚本,不能充当持续下载样本;第三次按旧记录探测 Scert 8004 被拒绝。实时核查确认 Scert 已迁移至按域名共享 443,工具随后按当前实际入口执行,未恢复或修改 Scert 配置。对应日志及失败结果保留在主证据目录和 `-cutover` 目录。
## 启用 DNS 续期前的门槛
1. 确认 `solit.cn` 实际 DNS 服务商及专用最小权限授权。凭据只保存在远程受保护文件,不在聊天、仓库、普通文档或日志中传递;示例采用阿里云不代表已获得该账号授权。
2. 使用全新、独立的 ACME 测试账号完成五个域名的真实 DNS-01 挑战,验证 TXT 创建、传播及清理,不以已有授权缓存代替挑战。
3. 验证 DNS 拒绝、超时与清理失败期间两个站点及邮件服务仍可用,正式证书和私钥保持不变。
4. 在受保护备份和持续探测下同步安装新的续期脚本、部署脚本和 service,再完成正式签发及七个入口的新指纹检查。不能只替换其中一个脚本:旧续期脚本在持锁期间通过子进程调用部署脚本,与新版本共用锁的执行方式不同,混用会导致锁冲突。
5. 接入真实外部续期失败、证书临近到期告警,完成一次失败告警送达及恢复验证,再将无停机续期列为验收通过。
截至本轮结束,线上仍使用旧续期定时任务,证书有效期至 2026-12-16。保留旧任务不代表批准未来停机维护窗口;必须在进入到期续期窗口前完成 DNS 迁移。发布验收清单中的其他业务、安全、容量和恢复门槛继续有效。
+13 -2
View File
@@ -2,9 +2,20 @@
## 范围与结论
### 当前状态:2026 年 9 月 17 日晚间复测
### 当前状态:远程主机 2026 年 9 月 18 日凌晨无停机续期整改
本节与《晚间验收复测记录》作为当前状态入口;下方带时间的旧记录保留追溯,不应把早期 SSH 失败、自签名或单次资源失败当作当前结论。已部署程序仍为 `review-2263779`,本轮没有编译或替换应用。
- [✓] Nginx 已迁移到已发布证书目录,不再直接读取 ACME 签发产物;Smail 8001/8002 和其他站点配置未修改。
- [✓] 27 项远程隔离回归通过,含真实独立 Nginx 换证、重载和回退后的 TLS 指纹检查。
- [✓] 线上平滑重载期间两个站点 58 次 HTTPS 探测成功,已有连接完整下载 312,377 字节,Nginx 与 Smail 主进程未重启;七个 TLS/STARTTLS 入口复测通过。
- [✓] DNS 候选脚本在真实未到期状态校验通过,但没有签发新证书或替换自动任务。
- [!] Smail 专用 DNS 授权、全新 DNS 挑战、正式新证书发布、外部告警尚未验收;线上续期脚本和定时任务仍为旧版本,不能宣称无停机自动续期已启用。
- [!] 实时配置显示 Scert 已按域名共享 443,旧记录中的 8003/8004 不再是当前入口。其他生产门槛继续有效,整体结论仍为“不满足生产放行”。
本轮无业务数据写入,不清库、不重编译应用、不替代首次安装和浏览器业务验收。详情及失败记录见《无停机续期整改记录》。
### 历史状态:2026 年 9 月 17 日晚间复测
本节与《晚间验收复测记录》保留当时状态;当前以顶部较新章节为准,不应把早期 SSH 失败、自签名或单次资源失败当作当前结论。已部署程序仍为 `review-2263779`,本轮没有编译或替换应用。
- [✓] SSH 可用;8001/8002 与 Nginx 反代、正式可信证书、七个 TLS/STARTTLS 入口复测通过。
- [✓] 六项远程隔离续期回归通过;备份摘要、证书有效期与关键文件权限复核通过。