补充生产服务资源防护与只读预检并记录远程验收阻塞
Security Checks / security (push) Waiting to run

This commit is contained in:
xuans committed 2026-09-17 15:39:28 +08:00
1 parent e14c538322
commit 3532f76c66
8 files changed
+609 -5

No files matched your search

+4 -2
View File
@@ -12,12 +12,14 @@
13:05,POP3 与 SMTP 错误分类修复的三包远程回归共 48 项通过,无跳过。13:10 同版候选程序通过空数据副本初始化、真实协议及三轮混合认证过载恢复;随后完成备份部署,线上为 `review-b47f36643547`。13:12 部署后内部 SMTP 五项真实收信、产物摘要、双库和安全边界复核通过。生产容量、资源规划和正式浏览器验收仍未通过。
15:21 起继续资源隔离整改。已补充 systemd 候选资源预算、OOM 整组收尾、启动限频、90 秒停止期限、只读资源预检及反例测试;本轮仅完成源码复审、语法检查和 Linux 测试程序交叉编译,未在本机执行应用或测试用例。当前会话无法通过 47 的 SSH 认证,没有上传或部署,也没有重新核实线上版本与资源。详见《生产资源部署说明》,不得把本轮源码变化计为 PROD-013 已通过。
## 任务状态
| 编号 | 优先级 | 任务 | 状态 | 验收边界 |
| --- | --- | --- | --- | --- |
| PROD-001 | P0 | 移除脚本中的已知明文凭据 | [x] | 工作区已清理,历史泄露处置未结束 |
| PROD-002 | P0 | 轮换泄露凭据、核查访问记录 | [!] | 旧 SSH 密码仍有效,需要协调替代登录及轮换 |
| PROD-002 | P0 | 轮换泄露凭据、核查访问记录 | [!] | 前轮记录旧 SSH 密码仍有效;本轮不复用泄露密码,已有密钥无法登录,需要恢复受信任访问并确认轮换状态 |
| PROD-003 | P0 | 处置 Git 历史中的凭据 | [!] | 未授权重写历史或强推;轮换应先于历史清理 |
| PROD-004 | P0 | 持久化逐收件人投递、防不确定重投 | [x] | 相关自动测试通过,真实网页业务闭环待验收 |
| PROD-005 | P1 | MX、备用路由、DNS 错误分类 | [✓] | 针对性测试通过,不代表各外部邮件供应商兼容性 |
@@ -28,7 +30,7 @@
| PROD-010 | P1 | 内部 SMTP 与部署后安全回归 | [✓] | 五项真实收信、双库、产物、未认证 API 均通过 |
| PROD-011 | P1 | 全量测试、竞态、数据库兼容性和压测 | [~] | 60 包分批执行、958 个顶层用例通过;8 处跳过单列,竞态、真实跨库和容量验收未完成 |
| PROD-012 | P1 | 最新版本清库首次安装验收 | [~] | 新部署产物的空数据副本正式初始化 API、协议收信和认证过载恢复通过;真实浏览器首次安装待验收 |
| PROD-013 | P0 | 共享主机资源隔离与容量 | [!] | 首轮测试期间发生全机 OOM,MySQL 被终止后自动重启;必须补齐资源规划 |
| PROD-013 | P0 | 共享主机资源隔离与容量 | [!] | 首轮全机 OOM 后补充候选服务限额和只读预检;SSH 认证阻塞,尚未部署或测试,实际预算与容量未验收 |
| PROD-014 | P1 | 投递结果写库恢复 | [✓] | 12 项远程测试及源码复审通过;持久故障后的进程退出仍需人工核对,不代表生产故障演练通过 |
| PROD-015 | P1 | 跨平台证书路径与插件测试 | [✓] | Linux 拒绝异平台路径误解析;保持证书校验、托管导入和插件目录权限要求 |
| PROD-016 | P0 | 密码计算全局并发和过载处理 | [✓] | 48 项远程回归及新部署产物三轮真实混合认证过载恢复通过;区分 SMTP 535/454、IMAP UNAVAILABLE、POP3 SYS/TEMP,不代表生产容量或浏览器验收通过 |
+76
View File
@@ -0,0 +1,76 @@
# 生产资源部署说明
## 状态与边界
本说明对应 2026 年 9 月 17 日的共享主机资源整改。以下配置和检查工具是待远程验收的候选变更,不表示已经部署到 47 服务器,也不是生产容量承诺。
- [x] 增加主服务资源上限、OOM 收尾与重启频率限制,等待远程复审。
- [x] 增加只读资源预检和失败反例测试,等待远程执行。
- [!] 当前会话没有可用的 47 服务器 SSH 登录凭据,无法取得实时资源快照或部署。
- [ ] 明确同机 MySQL、Scert、操作系统的增长预算,选择 Smail 的实际限额。
- [ ] 清空隔离验收实例的全部项目数据库,部署最新产物,执行安装、恢复、队列和内部 25 端口验收。
- [ ] 记录峰值、持续运行、过载恢复和监控告警,完成资源项复审。
不要停止其他项目以通过测试,不自动扩充内存限额,不创建交换文件,不把旧记录中的可用内存当作当前资源。数据库清理只涉及获准的 Smail 测试实例,执行前必须备份并确认全部数据库的归属。
## 候选默认预算
正式安装模板新增如下配置,部署人员需要先核算宿主机预算。默认值不是根据完整生产负载测得的安全容量。
| 配置 | 候选默认值 | 用途 |
| --- | --- | --- |
| `GOMEMLIMIT` | `256MiB` | 新建环境文件中的 Go 回收目标,不是进程硬上限 |
| `MemoryHigh` | `384M` | 控制组内存高水位 |
| `MemoryMax` | `512M` | 主服务及同组子进程的内存硬上限 |
| `MemorySwapMax` | `0` | 不以交换空间掩盖内存不足 |
| `CPUQuota` | `100%` | 默认最多使用一个 CPU 的时间配额,不是整机所有 CPU |
| `TasksMax` | `256` | 限制同组进程及线程数量,不等同于邮件用户数 |
| `OOMPolicy` / `KillMode` | `stop` / `control-group` | OOM 或停止时收尾整个服务进程组 |
| `Restart` / `RestartSec` | `on-failure` / `10s` | 故障后退避重启 |
| `StartLimitIntervalSec` / `StartLimitBurst` | `300s` / `3` | 五分钟内最多三次启动,防止持续重启占用主机资源 |
| `TimeoutStopSec` | `90s` | 覆盖队列 25 秒、数据库 35 秒及其他服务收尾时间 |
已有 `/etc/smail/smail.env` 始终保留,不自动添加或改写已有 `GOMEMLIMIT`。维护人员应在停服备份后人工检查该文件,保持 `root:root`、`0600` 权限。不要将整个环境文件输出到日志、聊天或验收文档。
若已有本机 systemd drop-in,它可能覆盖仓库模板。不能只看文件内容或 `daemon-reload` 成功;必须核对运行进程、服务管理器和内核控制组的实际值。
## 只读预检
工具只在 Linux 部署主机检查正在运行的 `smail.service`,要求 root、Python 3 和 cgroup v2。不会启动程序、改配置、重启服务、读写数据库或进行压测。
在服务器的本次审查源码目录运行:
```sh
python3 deploy/check_resources.py --reserve-mib 256
```
`256` 只是命令示例,必须按同机服务的增长及系统开销核算。工具要求显式指定且不得小于 `128`,不能为了通过检查降低已确定的预算。
预检逐项核对:
1. 服务处于运行状态,主 PID 位于本服务独立的统一控制组。
2. 内存高水位、硬上限、交换与任务数的 systemd 属性和实际内核值相符,CPU 配额有限。
3. 进程设置了有效的 `GOMEMLIMIT`,低于内存高水位,当前内存未达到高水位。
4. 从当前占用增长到 `MemoryMax` 后,主机仍有指定的保留内存;同时检查上级控制组的内存、任务数和 CPU 约束。
5. OOM 收尾、整个进程组停止、至少 90 秒且有界的停止期限、重启退避和启动频率限制有效,当前控制组没有累计 OOM 或 OOM kill。
6. 取证前后 PID、调用标识和所查服务属性一致,避免把重启前后的数据拼成通过证据。
工具仅从进程环境解析 `GOMEMLIMIT` 的数值,不输出其他环境项。报告中 `resource_checks_passed=true` 只表示这一次快照通过资源规则,`production_approved` 始终是 `false`;退出码 `0` 不构成完整生产放行。取证失败、权限不足、cgroup v1、属性缺失或检查不通过时返回非零。
主机资源随其他服务负载变化。瞬时检查没有为 Smail 预留物理内存,也不证明 MySQL、Scert 已分别受到合适的限制;必须另行确定这些服务的预算、监控并验证持续运行。
## 部署与远程验收
1. 恢复受信任 SSH 登录,核对主机身份、线上版本、服务 PID、重启计数、完整预算及 OOM 记录。不要复用已泄露的历史密码。
2. 先执行只读检查。旧服务缺少新规则时预期失败,保留结果作为整改前证据,不能通过重置计数掩盖 OOM。
3. 用最新源码构建产物;在 47 的独立目录和隔离网络创建清洁数据库验收实例,保持硬资源上限。正式 unit 的检查使用 `systemd-analyze verify`,不得仅用字符串断言代替系统解析。
4. 在受限的远程测试单元中执行 `python3 test/deployment/resource_policy_test.py`;也可使用统一部署测试入口 `node test/run.mjs deployment`。这些测试使用模拟快照和全新临时夹具,不访问业务数据库,不替代线上资源检查。
5. 完成正式安装流程、真实网页发信队列、中文附件、内部 `127.0.0.1:25`、混合认证和受控故障恢复,记录内存峰值、延迟、繁忙响应、任务数、OOM 和同机服务状态。仅用小样本成功不能声明最大容量。
6. 预算通过后安排停服窗口,备份双程序、unit、环境文件、所有数据库和密钥证书。安装程序不会自动停止正在运行的服务,部署时保留原数据与可回退产物。
7. 部署后重新执行只读预检与内部 SMTP 回归,检查限额、线上摘要和其他服务状态;未通过时停止放行,按备份方案恢复,不扩大预算以掩盖失败。
触发启动频率限制后,先保存故障证据并处理原因,再由维护人员决定恢复启动。不能在定时任务里循环 `reset-failed`,不能把自动重启当作队列和数据库的故障验收。
## 本轮未证明的事项
尚未在 47 上执行本说明新增的测试或真实预检,尚未核实默认 512 MiB 硬上限适用于该主机。TLS、凭据轮换、完整浏览器流程、超管恢复撤销、竞态、真实跨库和异机恢复继续以《生产整改验收清单》为准,不因资源配置补齐而自动通过。
+18
View File
@@ -478,3 +478,21 @@ TLS 前未公布 AUTH,主动尝试明文 AUTH 返回 523。未认证外域邮
部署后 Smail `active/running`,PID `563364`、重启计数 0;MySQL PID `549584`、Scert PID `530794` 均未改变,重启计数仍为 1 和 0。双库完整性正常,迁移 23,队列为空,恢复 socket `0600`,未认证用户信息与邮件列表业务码均为 403。双程序摘要与上表一致,13:11 以后没有新增 OOM。
本轮完成协议错误分类、完整响应回归、空数据 API 安装与混合认证过载恢复、备份升级及内部 SMTP 回归。可信 TLS、真实浏览器安装和发信闭环、正式超管恢复交互及撤销、泄露凭据处置、生产资源预算、竞态及跨库、异机恢复等门槛仍未验收,不能签署生产放行。
## 2026 年 9 月 17 日下午:资源防护候选,远程认证阻塞
15:21 起恢复工作。本轮先提交上一轮遗留的两份验收记录和 `runtime_review.py` 元组断言修正,检查点为 `e14c53832241aac4a9d052de82c1b450c5e30566`;推送首轮出现认证失败,重试成功,并以 `git ls-remote` 确认远程分支摘要一致。
当前会话、用户级和机器级环境均没有 `SMAIL_SSH_KEY` 或 `SMAIL_SSH_PASSWORD`。使用强制已知主机校验的连接工具、现有默认密钥、Smail 专用密钥及 OpenSSH 默认认证均未通过 47 的认证。没有关闭主机校验,没有从 Git 历史或旧日志提取泄露密码。本轮未登录服务器,未上传、重启、部署或清库;不能据此断言旧密码已撤销,也不能把 13:12 的运行状态当作本轮实时状态。
资源整改候选包括:
- 主服务内存高水位 384 MiB、硬上限 512 MiB、禁用交换配额、单 CPU 时间配额与 256 个任务上限。这些是待核算、待验收的模板值,不是 47 的已确认容量。
- OOM 后整组停止、故障后 10 秒退避、五分钟最多三次启动;停止期限 90 秒,覆盖现有队列 25 秒与数据库 35 秒等待以及其他收尾。
- 新安装环境文件增加 `GOMEMLIMIT=256MiB`,已有环境文件不改写;权限和备份逻辑保留。
- 只读检查实际 cgroup v2、主进程环境中的 Go 内存数值、上级控制组、剩余增长预算、OOM 记录和服务取证稳定性;不记录其他环境变量。
- 新增部署策略、缺失限额、预算不足、重启竞态、错误控制组和敏感信息隐藏的反例测试,并接入统一部署测试入口。测试尚未执行,不能登记通过数。
本机仅执行 Python 字节码语法编译、Node 语法检查、Bash `-n`、Git 差异检查和 `go test -c` 交叉编译;没有执行应用、测试用例或浏览器测试。交叉编译产物为 `out/resource-review-20260917/backend/cmd/smail-admin/review.test`,Go 构建信息确认 `go1.26.6`、`linux/amd64`、`CGO_ENABLED=0`。这些证据不替代远程 `systemd-analyze verify`、反例执行、真实资源预检或清库部署验收。
下一步需要通过受保护环境恢复受信任 SSH 访问,再在 47 的受限环境验收新增策略、核算同机预算、编译部署最新产物并按内部 `127.0.0.1:25` 继续业务验收。当前仍不具备生产放行证据。