1 parent
05f7490c07
commit
f265cc62f5
17 files changed
+833
-47
No files matched your search
@@ -0,0 +1,216 @@
|
||||
# 生产补充验收记录
|
||||
|
||||
## 范围与基线
|
||||
|
||||
本轮从 2026 年 9 月 20 日 22:55 开始,代码基线为 `05f7490`。
|
||||
本记录补充最新单数据库版本的生产门禁,不覆盖原有云端全项目测试报告中的未提交修改。
|
||||
测试域名、账号和密码仅用于测试,不是产品默认配置或放行依据。
|
||||
|
||||
## 当前结论
|
||||
|
||||
**关键补充验收已取得实机通过证据,但整体生产验收尚未通过。**
|
||||
本记录按明确范围更新旧清单:旧双 SQLite 验收、旧 SSH 阻塞、旧资源限额未部署等描述不能继续当作当前事实。
|
||||
源码整改、隔离通过和生产实例正式升级分别记录,不互相替代。
|
||||
|
||||
## 任务清单
|
||||
|
||||
- [✓] 核对历史阻塞、当前部署、隔离产物及证据边界。
|
||||
- [✓] 最新构建 SQLite 空数据初始化、登录、安全设置、三协议认证与中文附件读取。
|
||||
- [✓] 最新构建独立 Nginx 反代、跳转、上游 TLS 校验、双来源限流和过载恢复。
|
||||
- [✓] 三种数据库共十段真实迁移、正式配置事务切换、配置管理器重新加载和历史保真。
|
||||
- [✓] 同机隔离冷备、全新目录还原、历史及新增邮件的正文和附件取回。
|
||||
- [✓] 当前生效证书覆盖根域名与泛域名,管理入口和应用托管证书指纹一致。
|
||||
- [✓] 权威 DNS 与一个公网递归解析器核验地址和邮件记录,DKIM 公钥与部署私钥匹配。
|
||||
- [✓] 前端生产依赖审计、静态检查、全量自动化和全量竞态回归。
|
||||
- [✓] 四个 DNS 工具移除明文云密钥,新增脱敏扫描器及持续集成门禁。
|
||||
- [!] 历史云密钥、服务器凭据的轮换、访问审查和泄露处置没有完成证明。
|
||||
- [!] 静态安全扫描报告 61 条告警,尚未逐条完成修复或可审计排除,不能生产放行。
|
||||
- [ ] MySQL、PostgreSQL 各自从空库完成首次安装及邮件业务闭环。
|
||||
- [ ] 真正应用进程切库重启后的业务验收、故障注入和中断恢复。
|
||||
- [ ] 最新候选浏览器初始化、账号恢复、旧会话及真实协议连接撤销闭环。
|
||||
- [!] Windows 提权本地通道验收需要管理员会话,当前终端未提权。
|
||||
- [!] 生产 DNS 自动续期需要安全注入有效且已轮换的最小权限凭据,当前为手动托管证书。
|
||||
- [!] 外部收件最终到达、真实恢复邮件、外部插件调用需要受控测试账号和收件确认。
|
||||
- [ ] 生产容量、长时运行、告警触发和异机灾备验收。
|
||||
- [✓] 静态安全扫描执行、脱敏统计、回归证据复核与本轮变更整理;提交推送结果以 Git 记录为准。
|
||||
|
||||
## 操作边界
|
||||
|
||||
- 仅操作 Smail;不停止共享数据库、Nginx 或其他项目。
|
||||
- 实机测试先使用全新空数据隔离实例,施加内存、CPU 和运行时间限制。
|
||||
- 不删除用户文件,不擅自轮换服务器凭据,不重写 Git 历史。
|
||||
- 外部收件人的最终收件、凭据轮换、异机灾备等缺少必要条件时明确保留阻塞。
|
||||
- 不将源码检查、模拟测试、跳过项或历史版本证据计为本轮实机通过。
|
||||
|
||||
## 初始只读核对
|
||||
|
||||
- Smail 主进程、其他项目进程与前轮记录一致;当前服务限额为内存上限 512 MiB、高水位 384 MiB、CPU 配额一个核、任务数上限 256。
|
||||
- 上述限额已部署,不能继续沿用旧清单中“限额未部署”的描述;但限额不等于生产容量通过。
|
||||
- 名为 `smail-certificate-renew.timer` 的单元未安装;需要进一步核对应用内续期与其他调度,不能仅据此断言所有续期均不存在。
|
||||
- 旧隔离工具仍断言双 SQLite 完整性,需要更新为单数据库要求并增加反例回归。
|
||||
- 共享主机存在历史交换空间占用;后续压测只在受限隔离单元内执行,不推导全机容量。
|
||||
|
||||
## 产物与部署对应
|
||||
|
||||
本轮前端、Linux 插件嵌入产物和 Linux 主程序重新编译完成。
|
||||
|
||||
| 项目 | 证据 |
|
||||
| --- | --- |
|
||||
| 本地证据目录 | `test-log/production-acceptance-20260920/`,已被 Git 忽略 |
|
||||
| 隔离候选路径 | `/var/tmp/smail-review-acceptance-20260920/smail` |
|
||||
| 候选主程序 SHA-256 | `2ed95b506b4489bc1a971a853826dfc549bfb0712b16adfded328c3011cec0ce` |
|
||||
| 正式主程序 SHA-256 | `c14ef1c5ba1dc2096c312c8357039a7330c985cbeac90765aed01d8151e05e1f` |
|
||||
| 正式运行目录 | `/opt/smail`,本轮未替换、未重启、未清库 |
|
||||
|
||||
候选没有注入正式发行版本号,不伪造发行标识。本轮后续改动属于测试、工具、持续集成及文档,不改变被测应用逻辑。
|
||||
每个隔离实例有独立挂载和网络命名空间;测试密码和协议凭据不输出,备份恢复所需测试密码仅在内存及匿名标准输入管道传递。
|
||||
|
||||
## 云端实机结果
|
||||
|
||||
### 首次安装与反向代理
|
||||
|
||||
- 23:16 的空 SQLite 实例通过一次性初始化令牌保护、HTTPS 登录、会话接口和正式安全设置。
|
||||
- SMTP、IMAP、POP3 使用正式生成的独立协议授权码认证;明文 SMTP 认证被拒绝,错误凭据返回 `535`。
|
||||
- 通过 SMTP 收取中文邮件,IMAP 在收件箱按 Message-ID 搜索并取回正文和附件,POP3 通过 RETR 取回相同内容。
|
||||
- 三轮各八并发的 HTTP 与邮件协议混合认证测试,同时观察成功和可重试繁忙响应,后续正常请求恢复。
|
||||
- 23:31 的独立 Nginx 实例使用仓库部署模板,验证应用 `8001/8002` 与代理 `443` 链路;未关闭上游证书校验。
|
||||
- HTTP 与内部入口跳转均保持公网 HTTPS 地址,恢复页脚本可加载且不缓存;伪造转发头不能绕过限流,不同来源仍可独立登录。
|
||||
- 每次收尾只允许 `smail.db`,要求存在 `config_records`,完整性检查为 `ok`;正式库没有隔离实例测试邮件。
|
||||
|
||||
主要证据:`isolated-runtime-231650.log`、`nginx-runtime-233251.log` 及配套结果、探针和服务日志。
|
||||
SMTP 的实际投递为隔离域内部收信;认证成功不等于已经通过认证外发或外部邮箱最终到达验收。
|
||||
|
||||
### 三种数据库迁移与真实配置事务
|
||||
|
||||
23:44 对真实 MySQL、PostgreSQL 服务执行以下链路,共十段,9.58 秒通过,零跳过:
|
||||
|
||||
1. SQLite → MySQL → MySQL → SQLite。
|
||||
2. SQLite → PostgreSQL → PostgreSQL → SQLite。
|
||||
3. SQLite → MySQL → PostgreSQL → MySQL → SQLite。
|
||||
|
||||
最终轮调用真正的 `ConfigManager.SwitchDatabase`,核验待重启标记、配置代次、重新创建配置管理器后目标连接仍保持一致。
|
||||
每段校验中文主题、中文日志、自增序列、真实配置备份,以及二进制历史 payload 与 SHA-256 不变。
|
||||
配置审计写入器仍使用测试内存实现,未把它计为生产日志持久化验收。
|
||||
|
||||
证据:`live-migration-234401.log`。此前 `live-migration-231721.log` 仅使用替代切换回调,不能替代最终轮证据。
|
||||
测试只使用随机命名的专用库,测试账号已锁定、禁止登录,库保留供复核;没有停止共享数据库或修改其他项目的库。
|
||||
**配置管理器重新加载并不等于应用服务进程切库重启,后者仍未完成。**
|
||||
|
||||
### 冷备与空目标还原
|
||||
|
||||
23:36 完成新空实例全流程后停掉该隔离实例,冷备全部十八个文件并在全新目录还原。
|
||||
|
||||
- 所有文件 SHA-256 与源一致,还原库 inode 与源不同;归档只允许正常文件和目录,拒绝链接、设备和路径穿越。
|
||||
- 23:37 在独立网络和挂载空间启动还原实例,原账号正常登录,三种协议重新授权后认证通过。
|
||||
- IMAP、POP3 均能取回备份中的历史邮件和中文附件。
|
||||
- 还原后再次通过 SMTP 收信,两种取信协议均能取回新增正文和附件。
|
||||
- 源目录字节不变,正式服务状态不变,还原库完整性 `ok`,测试单元全部停止。
|
||||
- 恢复业务验证耗时 16.09 秒;这不是包含传输、故障发现和运维响应的生产恢复时间目标。
|
||||
|
||||
证据:`restore-runtime-233756.log`、`restore-233756-smail-review-restore-20260920-233730-result.json`。
|
||||
范围仅为同机隔离冷备,不覆盖在线备份一致性、异机灾备或生产定时备份。
|
||||
|
||||
### 当前正式实例只读收尾
|
||||
|
||||
`live-final-state.json` 确认:
|
||||
|
||||
- 主域为 `solit.cn`,后台为 `web.solit.cn`;数据目录仅一份 `smail.db`。
|
||||
- 使用系统信任链,分别以根域、后台和邮件域 SNI 访问本机 Nginx,TLS 校验通过;不是跳过校验的探测。
|
||||
- 实际返回证书 SAN 为 `*.solit.cn`、`solit.cn`,与应用配置引用的托管证书 DER 指纹一致。
|
||||
- `ssl/custom.crt` 是旧文件,不是当前证书配置依据;本轮没有删除它。
|
||||
- Smail、Nginx、MySQL、Scert、FDM、PostgreSQL 均运行,既有进程和调用标识未变化,未留下运行中的本轮测试单元。
|
||||
|
||||
这些 TLS 探测走本机地址并保留真实 SNI,不能替代公网 DNS、浏览器或不同用户网络的验证。
|
||||
本轮没有改动 DNS;后续只读 DNS 核验见下一节,不将记录存在等同于真实邮件投递通过。
|
||||
|
||||
### DNS 与 DKIM 只读核验
|
||||
|
||||
证据中的 UTC 时间为 `2026-09-20T16:07:56Z`,对应北京时间 9 月 21 日 00:07:56。
|
||||
|
||||
- 从云服务器直接查询权威服务器 `dns13.hichina.com` 和公网递归服务器 `8.8.8.8`,根域、后台、邮件域和新随机测试子域均返回 `47.108.78.12`。
|
||||
- MX 保留优先级 1 的 `mail.solit.cn`,以及优先级 20 的既有阿里云邮件目标;本轮未删除或改写任何记录。
|
||||
- SPF、`default._domainkey` DKIM、DMARC 均有记录;两处解析结果一致。
|
||||
- 在服务器内由当前部署 DKIM 私钥导出公钥,与权威 DNS 公钥字节比对一致;只记录公钥指纹,不输出私钥。
|
||||
- 对 `1.1.1.1` 的八次查询均超时,不能声称所有公网解析器都通过。
|
||||
- Windows 当前系统解析器的 A 记录返回 `198.18.*.*`,与权威答案不同;原因未查明,不能以此路径证明直接解析到生产地址,也没有擅自修改本机网络设置。
|
||||
|
||||
证据:`public-dns-20260921.json`、`local-dns-20260921.json`、`dkim-dns-match-20260921.json`。
|
||||
以上仅证明所列解析路径及密钥匹配,不证明外部邮件最终到达、收件端 DKIM 验签或浏览器可访问。
|
||||
|
||||
## 自动化与安全回归
|
||||
|
||||
| 验证 | 结果与边界 |
|
||||
| --- | --- |
|
||||
| `node test/run.mjs all -p 1 ./...` | 初轮及最终轮退出码均为零;前端 210 项通过,部署 JavaScript 4 项通过、1 项仅适用 Linux 的测试跳过 |
|
||||
| `node test/run.mjs backend -race -p 1 ./...` | 全量通过;新增真实切换测试再以 `-race -count=1 ./services/dbmigration` 复核通过,耗时 10.044 秒 |
|
||||
| Linux Python 部署回归 | 初轮 82 项通过,新增凭据前置校验后最终 83 项通过;Windows 的 fcntl、POSIX 路径不兼容失败记录保留,不冒充 Windows 全量通过 |
|
||||
| Linux 资源策略回归 | 15 项通过;首次上传漏掉两个只读夹具,补齐后通过,失败日志保留 |
|
||||
| 新增验收与凭据扫描回归 | 13 项验收器反例、6 项凭据扫描反例通过,并加入持续集成;最终六项扫描器回归在 Windows 和 Linux 均通过 |
|
||||
| `go mod verify` | 通过 |
|
||||
| 前端生产依赖审计 | 162 个生产依赖,报告各级漏洞均为零;不包含开发依赖 |
|
||||
| 前端 ESLint | 不使用自动修复,退出码零 |
|
||||
| `govulncheck ./...` | Windows 和 Linux/amd64、CGO 禁用扫描均退出零;可达与导入包层命中为零,依赖模块层命中三项,不能宣称全部依赖零漏洞 |
|
||||
| `gosec ./...` | 未通过,退出码 1;扫描 340 个文件、55,843 行,61 条告警,高等级 13、中等级 26、低等级 22;Go 包加载错误为零 |
|
||||
|
||||
证据包括 `final-all-tests.log`、`race-tests.log`、`linux-deployment-regressions.log`、`linux-resource-policy-retry.log`、`frontend-audit.log` 和 `govulncheck.log`。
|
||||
补充证据为 `final-migration-race.log`、`govulncheck-linux.log`、`linux-secret-regressions-final.log`、`linux-deployment-regressions-final.log`。
|
||||
Linux 漏洞报告中的模块层条目为 `GO-2026-6355`、`GO-2026-6354`、`GO-2026-5932`;当前调用路径未命中,不等于可忽略后续依赖维护。
|
||||
本地未提权的 Windows Named Pipe 用例存在跳过,不计为通过;云端 MySQL、PostgreSQL 专项有单独零跳过证据。
|
||||
|
||||
### 静态安全扫描:结果已复核,门禁未通过
|
||||
|
||||
扫描使用 `gosec v2.22.10`,以可执行文件的 Go 模块构建信息确认版本;报告中的展示版本为 `dev`。
|
||||
本次为 Windows 构建平台扫描,不替代 Linux 平台完整扫描。完整 JSON 位于 `gosec.log` 的末尾,脱敏统计另存 `gosec-summary.json`,没有单独产生原计划的 `gosec.json`。
|
||||
|
||||
| 规则 | 数量 | 需要复核的范围 |
|
||||
| --- | --- | --- |
|
||||
| G115 | 13 | IMAP 序号、UID、消息数量的整数转换,以及旧数据库端口解析 |
|
||||
| G202 | 6 | 跨库迁移中的动态 SQL、标识符转义和来源边界 |
|
||||
| G304 | 13 | 配置、证书、迁移和发布流程中的动态文件路径 |
|
||||
| G302 | 4 | 配置及部署目录的权限设置,需区分目录执行位与普通文件权限 |
|
||||
| G306 | 2 | 发布产物与插件写入权限 |
|
||||
| G505 | 1 | DNS 服务商签名代码中的 SHA-1 导入及协议使用边界 |
|
||||
| G104 | 22 | 文件、锁、连接等关闭或释放操作的错误处理 |
|
||||
|
||||
初步源码复核发现,`config/migrate.go:685,714` 的两个端口转换之前已调用 `validPort`,其范围为 1 至 65535;不能将这两条直接宣布为已确认可利用的整数溢出。
|
||||
迁移 SQL 中存在标识符引用函数,目录权限告警中存在有意使用的 `0700`;这些也需要逐条记录依据,而不是批量视为漏洞或批量忽略。
|
||||
IMAP 相关转换优先复核位置:`services/list/imap_search.go:107`,`listen/imap_server/session_poll.go:38`,`session_messages.go:49,59,63`,`session_expunge.go:39,46,121`,`server.go:210,211`。
|
||||
以上行号相对 `backend/`,其中同一行可能包含多个转换告警。
|
||||
|
||||
**61 条告警不是 61 个已确认可利用漏洞,但当前扫描门禁确实未通过。** 本轮没有关闭规则、添加批量忽略或修改扫描退出码;不能用单元测试通过覆盖这个阻塞。
|
||||
|
||||
## 发现的问题及未关闭门禁
|
||||
|
||||
### 历史凭据:生产阻塞
|
||||
|
||||
四个 Git 跟踪的 DNS 工具原含历史明文云 API 凭据,现已改为读取 `SMAIL_ALIDNS_ACCESS_KEY_ID` 和 `SMAIL_ALIDNS_ACCESS_KEY_SECRET`。
|
||||
新增扫描器仅输出文件、行号和类别,不输出匹配值;检查云 AccessKey 特征、私钥标头和 Python 密钥字面量。
|
||||
同时修复页面探针的 Python 语法错误,测试 URL 改为环境变量注入。
|
||||
最终复核发现 `add_dns.py` 在读取环境变量之前尝试 SSH 连接,现已将凭据检查前移;补充反例覆盖四个工具分别缺少任一凭据时,不创建 SSH 客户端或发起 HTTP 请求。
|
||||
|
||||
**源码和当前提交清理不代表历史凭据已撤销。** 未执行未经授权的密钥轮换、Git 历史重写或强推。
|
||||
需要凭据所有者完成旧凭据撤销、访问审查及安全注入新凭据;在此之前不允许生产放行。
|
||||
|
||||
### 资源容量:记录真实失败
|
||||
|
||||
23:29 的反代测试在 128 MiB 应用限额下,恢复码生成阶段发生 cgroup OOM,代理返回 `502`。
|
||||
线上服务未受影响。验收器增加明确且有限的内存参数,同时提高启动前可用内存门槛。
|
||||
在 192 MiB 限额下,23:31 反代重测通过,应用峰值约 73.9 MiB;23:36 空安装及还原轮也通过且无交换空间使用。
|
||||
单次低峰值不能推翻先前 OOM,不把 128 MiB 宣称为可用生产容量;生产限额仍为 512 MiB,尚缺长时容量和告警演练。
|
||||
|
||||
### 证书续期:有效证书不代表生命周期已验收
|
||||
|
||||
当前 `management=custom`、`mode=managed_upload`。应用仅在自动模式执行自动续期,不能因为有定时检查代码就认定当前手动模式会续期。
|
||||
根域加泛域名的当前证书已通过校验,但真实 DNS 挑战、调度、失败告警和换证后全协议热加载仍需实机验收。
|
||||
仓库旧外部续期脚本仍采用固定五域名配置,不能直接套到根域加泛域名的当前部署;本轮未启用或修改线上续期任务。
|
||||
|
||||
### 其他未完成范围
|
||||
|
||||
真实浏览器流程、超级管理员正式命令交互、旧会话与协议连接撤销、外部邮箱最终收件、插件外部调用、异机灾备等保留未完成状态。
|
||||
Windows 受保护本地通道验收需要提权会话,不得降级成公开 TCP 或普通 HTTP 重置接口。
|
||||
测试全部通过的限定项可以单独复核,但不能将此记录标题或部分勾选解释为整个项目审计结束。
|
||||
|
||||
## 本轮收尾边界
|
||||
|
||||
最终仅整理本轮明确列出的测试、工具、持续集成和本记录;原有 `docs/云端全项目测试报告.md` 的用户修改不加入本轮提交。
|
||||
本轮不执行生产版本替换,测试候选与正式实例保持分离。未关闭门禁继续保留,不能将本轮提交或推送成功解释为生产验收通过。
|
||||
Reference in new issue
Block a user