完善初始化向导、通知配置与证书流程
This commit is contained in:
1 parent
b2833b761d
commit
f85ef10527
41 files changed
+3645
-1697
No files matched your search
@@ -157,6 +157,8 @@ CLI 在初始化完成后不直接操作数据库。`init` 负责交互式填写
|
||||
- `lego`、DNS provider、证书解析、任务调度和部署逻辑均作为 Go 模块或内部适配器实现,减少 Linux 与 Windows 的行为差异。
|
||||
- 初始化阶段仍需要预检公网连通性、DNS API 权限、证书存储目录、系统时间和文件权限;这些预检必须使用 Go 实现,不依赖平台特定 Shell 命令。
|
||||
- DNS 凭据只以受控配置对象传递到 provider,禁止出现在命令行参数、日志、任务错误详情和 API 响应中。
|
||||
- DNS-01 传播最大等待时间:默认900秒,可通过配置修改。
|
||||
- DNS-01 传播检测间隔:默认10秒,不得大于最大等待时间。
|
||||
- 证书链和私钥校验优先使用 Go 标准库 `crypto/x509`;只有确实需要调用外部 Web 服务器检查命令时,才通过平台命令执行适配器运行白名单命令。
|
||||
- Windows 和 Linux 的服务注册、文件权限、路径规范化和系统托盘仍由平台适配层分别实现。
|
||||
- 安装、升级和卸载不得删除用户证书、数据库或备份;所有删除操作必须经过 Web/CLI 明确确认并写入审计日志。
|
||||
@@ -543,6 +545,8 @@ POST /api/v1/domains/{id}/renew
|
||||
- 允许域名级覆盖:需要时覆盖全局 DNS 配置
|
||||
- CNAME 委派:自动创建、失败手动提示
|
||||
- DNS 传播检测超时
|
||||
- DNS-01 传播最大等待时间:默认900秒,可通过配置修改。
|
||||
- DNS-01 传播检测间隔:默认10秒,不得大于最大等待时间。
|
||||
- 测试 DNS 权限和 Zone
|
||||
|
||||
**三、部署服务器配置**
|
||||
@@ -652,7 +656,6 @@ POST /api/v1/domains/{id}/test-servers
|
||||
| check_interval_days | 常规检查间隔,默认 3 天 |
|
||||
| near_expiry_check_days | 临近到期检查阈值,默认 10 天 |
|
||||
| renewal_threshold_days | 自动续期阈值,默认 6 天 |
|
||||
| emergency_threshold_days | 紧急重试阈值,默认 3 天 |
|
||||
| next_check_at | 下一次计划检查时间 |
|
||||
| next_renewal_at | 下一次计划续期时间,可为空 |
|
||||
| notification_rule_id | 域名级通知规则引用 |
|
||||
|
||||
@@ -104,6 +104,12 @@
|
||||
- [x] 支持 DNSPod API Token
|
||||
- [x] 预留其他 DNS 服务商适配接口
|
||||
- [x] 支持 CNAME 委派方式
|
||||
- [x] 已确认需求:配置 DNS API 凭据时允许在 CLI 和 Web 初始化界面中明文查看,便于用户核对输入内容;提交保存后不得将明文凭据写入普通配置文件、数据库字段、日志或命令行输出。
|
||||
- 【用户补充 U-074】(请填写):
|
||||
- 补充内容:配置时允许明文显示,存入数据库和调用时加密
|
||||
- 确认结果:已填写
|
||||
- [x] 已确认需求:DNS API 凭据在线验证期间仅在内存中使用;验证成功后写入加密敏感信息存储并返回凭据引用,证书申请和续期时根据凭据引用解密后调用 Provider。
|
||||
- 【实现约束】:Web 和 CLI 不得把完整凭据写入响应、日志、错误信息、测试输出或备份;配置文件只保存 `secret://` 凭据引用。
|
||||
- [x] 第一阶段 DNS 验证方式支持 Cloudflare、阿里云 DNS、DNSPod、CNAME 委派、华为云、腾讯云、AWS Route 53、Google Cloud DNS,并预留其他服务商适配接口。
|
||||
- [x] 已确认需求:第一阶段使用 Let's Encrypt 作为 ACME CA,并使用 `go-acme/lego` 负责证书申请、DNS-01 验证和自动续期。
|
||||
- 【用户补充 U-007】(请填写):
|
||||
@@ -539,6 +545,8 @@ web页面:站内信提示全部的通知状态
|
||||
- [x] DNS API 密钥加密存储
|
||||
- [x] SMTP 密码加密存储
|
||||
- [x] 日志中禁止记录明文密钥
|
||||
- [x] 已确认需求:敏感凭据在配置录入阶段允许明文显示,但仅限当前配置页面或当前交互输入过程;保存时使用 AES-GCM 等认证加密方式持久化,业务调用时按凭据引用解密,普通配置和数据库业务字段不保存明文。
|
||||
- 【安全边界】:明文只允许短时存在于进程内存;验证失败、取消配置或保存失败时不得留下可复用的普通配置记录;敏感信息文件和主密钥继续使用受限权限保护。
|
||||
- [x] 所有重要操作记录审计日志
|
||||
- [x] 已确认需求:使用主密码保护的加密配置。
|
||||
- 【用户补充 U-063】(请填写):
|
||||
|
||||
+488
-2
@@ -1397,13 +1397,50 @@ Linux amd64 可以交叉编译
|
||||
|
||||
- [ ] 接入阿里云 DNS、DNSPod/腾讯云、华为云、AWS Route 53 和 Google Cloud DNS 在线适配器。
|
||||
- [ ] 完成 CNAME 委派的目标 Provider 组合验证流程。
|
||||
- [ ] 将 CLI `scert init` 从“凭据引用加手动确认”升级为真实 DNS 在线验证流程。
|
||||
- [x] 将 CLI `scert init` 从“凭据引用加手动确认”升级为真实 DNS 在线验证流程;交互输入允许明文查看,验证通过后只保存加密凭据引用。
|
||||
- [ ] 集成 `go-acme/lego` 真实证书签发、续期和初始化管理后台证书部署。
|
||||
- [ ] 实现 HTTPS 双模式实际启动和初始化完成后的安全切换。
|
||||
- [ ] 将敏感信息密文文件保存升级为安全原子替换,并补充异常中断恢复测试。
|
||||
- [x] 将敏感信息密文文件保存升级为安全原子替换,并补充异常替换失败时保留旧文件的测试。
|
||||
- [ ] 清理过期、重复测试或放弃初始化所产生的未引用 DNS 凭据。
|
||||
- [ ] 完成 Scert-admin 受保护的本地密码重置通道、安装器和系统服务。
|
||||
- [!] MySQL 5.7/8.0 真实实例测试仍等待明确的 DSN、端口、账号和密码;不得通过 PATH 自动判断 MySQL 实例。
|
||||
|
||||
## 五十七、配置凭据明文查看与加密存储复审记录(2026-08-28)
|
||||
|
||||
### 57.1 需求清单
|
||||
|
||||
- [x] 配置阶段允许用户在 CLI 中明文查看 DNS API 凭据,便于核对输入内容。
|
||||
- [x] 配置阶段允许用户在 Web 初始化页面中切换 DNS 凭据的明文显示和隐藏显示。
|
||||
- [x] DNS 凭据在线验证时只在进程内存中传递给 Provider 测试器。
|
||||
- [x] 验证成功后使用 AES-GCM 加密写入敏感信息存储,普通配置文件只保存 `secret://` 凭据引用。
|
||||
- [x] 证书申请和续期通过凭据引用从敏感信息存储解密后创建 DNS Provider,不要求业务配置保存明文凭据。
|
||||
- [x] 验证失败、初始化提交失败或配置保存失败时,不消费验证令牌,不把明文凭据写入普通配置或日志。
|
||||
|
||||
### 57.2 实现和测试状态
|
||||
|
||||
- [x] CLI 动态读取 DNS Provider 凭据字段,并在明文输入提示中明确说明提交后的加密保存边界。
|
||||
- [x] Web 初始化向导新增“显示凭据明文”控制项;隐藏状态使用掩码显示,JSON 凭据不在隐藏状态下暴露内容。
|
||||
- [x] 增加 CLI 凭据输入、验证、加密保存、输入清空和临时凭据清理测试。
|
||||
- [x] 增加最终 `scert.json` 只保存 DNS 凭据引用、不保存 Token 或字段名的测试。
|
||||
- [x] 增加证书服务根据加密凭据引用解密后创建 DNS Provider 的测试。
|
||||
- [x] 增加敏感信息密文文件不包含明文凭据、权限受限和原子替换失败保留旧文件的测试。
|
||||
|
||||
### 57.3 验证结果
|
||||
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] 前端 `npm.cmd run build` 通过。
|
||||
- [✓] 代码和文档中未新增明文测试凭据输出;测试使用的凭据仅用于断言,未写入仓库文件。
|
||||
|
||||
### 57.4 复审边界
|
||||
|
||||
- [!] 浏览器真实操作时,初始化页面仍应限制为本机访问;明文凭据只应在用户明确操作期间短时显示。
|
||||
- [!] 生产环境仍需继续执行真实 DNS Provider、Let’s Encrypt、MySQL 5.7/8.0 和远程部署验收;本轮自动化测试不替代实机验收。
|
||||
- [!] 未引用敏感信息的定期清理策略仍需后续实现,不能在本轮擅自删除可能仍被业务引用的密文记录。
|
||||
|
||||
### 57.5 复审结论
|
||||
|
||||
本轮“配置时可明文查看、保存时加密、调用时按引用解密”的代码链路和自动化测试已完成并通过复审。明文凭据不进入普通配置文件、业务数据库字段、日志、错误响应或 Git 文件;生产级部署和真实外部服务验收仍按既有边界执行。
|
||||
---
|
||||
|
||||
## 三十一、敏感信息文件原子写入复审记录(2026-08-26)
|
||||
@@ -2097,3 +2134,452 @@ Linux amd64 可以交叉编译
|
||||
### 48.3 复审结论
|
||||
|
||||
本轮已完成 HTTP 邮件通知的 UTF-8 编码、业务响应判断、会话失效刷新和配置入口开发,并通过自动化验证;同时已通过临时邮件服务的接口详情确认修复后的中文内容正常。Scert 代码链路已经避免因客户端默认字符集导致的中文乱码,但最终收件邮箱客户端的到达和渲染仍需在发布环境继续复核。
|
||||
|
||||
## 四十九、持续开发复审记录(2026-08-28)
|
||||
|
||||
### 49.1 本轮需求清单
|
||||
|
||||
- [x] 继续复审上一轮 Ubuntu 模拟测试后的配置、任务、重置地址、安装服务和数据库备份恢复改动。
|
||||
- [x] 增强 MySQL 5.7/8.0 备份 SQL 的数据字面量和恢复语句拆分兼容性。
|
||||
- [x] 补充失败证书任务 HTTP 响应的嵌套状态、顶层状态和完成时间断言。
|
||||
- [x] 补充管理页面域名带路径时的 `/reset` 地址边界测试。
|
||||
- [x] 复核 systemd 技术文档路径与 Linux 安装脚本复制路径的一致性。
|
||||
- [x] 执行本地全量自动化验证和 Windows/Linux amd64 交叉构建。
|
||||
|
||||
### 49.2 本轮开发任务状态
|
||||
|
||||
- [x] MySQL 备份导出支持 `sql.RawBytes`,并对字符串中的反斜杠、空字节、换行、回车、控制字符和单引号进行 SQL 字面量转义。
|
||||
- [x] MySQL 恢复语句拆分器保留 `/*!...*/` 和 `/*+...*/` 可执行注释,避免丢失 MySQL 版本条件语句或优化提示。
|
||||
- [x] 失败证书任务返回 JSON 中的 `task.status`、`task.stage`、`task.message`、完成时间、更新时间与 `task_status` 已增加一致性测试。
|
||||
- [x] `/reset` 地址生成支持不带协议的域名、完整 URL、IPv4、IPv6、显式端口和附带路径的域名输入。
|
||||
- [x] systemd unit 使用 ASCII 技术文档文件名,安装脚本保留中文源文档并复制为技术文件名。
|
||||
|
||||
### 49.3 自动化验证状态
|
||||
|
||||
- [✓] `go test ./...` 通过。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] `go mod verify` 通过。
|
||||
- [✓] `npm.cmd run build` 通过。
|
||||
- [✓] Windows amd64 核心服务和 `Scert-admin` 交叉构建通过。
|
||||
- [✓] Linux amd64 核心服务和 `Scert-admin` 交叉构建通过。
|
||||
- [✓] `git diff --check` 通过;Git 输出的 LF/CRLF 提示不属于代码差异错误。
|
||||
- [✓] 源码范围未发现 `acme.sh`、旧的 `super-admin-reset` 或旧独立重置端口配置引用;测试中保留的旧字段字符串仅用于确认配置不会再次写入该字段。
|
||||
- [✓] 本轮未删除文件,未清理 `.runtime`,未执行 Git 提交、推送、重置或强制操作。
|
||||
|
||||
### 49.4 当前边界和后续验收
|
||||
|
||||
- [!] 尚未使用真实 MySQL 5.7 和 MySQL 8.0 实例执行备份、恢复、迁移和回滚;当前结论为代码级和 SQLite 自动化验证通过。
|
||||
- [!] 尚未在真实 Let’s Encrypt、DNS Provider、远程 SSH/SFTP、Windows 服务器和各类反向代理环境中完成端到端验收。
|
||||
- [!] 尚未完成生产级 HTTPS 终止、高级代理内部 HTTPS、Wails 桌面安装器、Windows Service 和跨平台防火墙的完整实机验收。
|
||||
- [!] `Scert-admin` 一次性重置入口仍需受保护的本地校验码呈现机制,不能把标准输出校验码作为生产方案。
|
||||
|
||||
### 49.5 复审结论
|
||||
|
||||
本轮可以在本机独立验证的代码修复、测试和构建任务已完成并通过复审。项目仍处于“本地开发复审通过、真实环境和产品级验收未完成”状态,不能据此宣称完整需求已全部交付。
|
||||
|
||||
## 五十、Ubuntu 22.04 服务生命周期复测与重置地址修复记录(2026-08-28)
|
||||
|
||||
### 50.1 本轮需求清单
|
||||
|
||||
- [✓] 使用 Ubuntu 22.04 测试环境复测 `Scert` 和 `Scert-admin` 的手动启停流程。
|
||||
- [✓] 确认 `Scert-admin` 不开机自启动、不监听独立 TCP/UDP 端口,只通过 `systemctl start Scert-admin` 和 `systemctl stop Scert-admin` 控制。
|
||||
- [✓] 确认 `Scert-admin` 启动后 `/reset` 可用,停止后 `/reset` 返回 404。
|
||||
- [✓] 按已确认规则修复重置地址,不在 `https://域名或IP/reset` 中暴露主服务端口。
|
||||
- [✓] 同步当前 Linux amd64 构建产物到 Ubuntu 测试机,并保留远程旧二进制备份。
|
||||
- [✓] 复核本机全量测试、竞态测试、静态检查、模块校验和前端构建。
|
||||
|
||||
### 50.2 Ubuntu 22.04 实测结果
|
||||
|
||||
- [✓] 测试环境为 Ubuntu 22.04.5 LTS,systemd 版本为 249.11。
|
||||
- [✓] `Scert.service` 使用当前构建产物后正常启动并保持 `active` 状态。
|
||||
- [✓] `Scert-admin.service` 使用当前构建产物后可以手动启动并保持 `active` 状态。
|
||||
- [✓] `systemctl is-enabled Scert-admin` 返回 `static`,服务未配置 `[Install]` 和 `WantedBy=`,不能纳入开机启动。
|
||||
- [✓] `ss -lntup` 仅观察到核心 `Scert` 监听 `*:5200`,没有发现 `Scert-admin` 独立监听端口。
|
||||
- [✓] `Scert-admin` 启动后访问 `/reset` 返回 HTTP 200,页面中文正常显示。
|
||||
- [✓] `systemctl stop Scert-admin` 后访问 `/reset` 返回 HTTP 404,临时入口已关闭。
|
||||
- [✓] systemd unit 的 `Documentation` 已同步为 ASCII 技术文档路径,`systemctl show` 不再出现中文路径 URL 警告。
|
||||
|
||||
### 50.3 本轮修复内容
|
||||
|
||||
- [✓] `Config.ResetURL()` 现在始终根据管理域名或公网 IP 生成不带端口的 `https://域名或IP/reset` 地址。
|
||||
- [✓] 保留 IPv4、IPv6、完整 URL、附带路径和显式端口输入的解析能力,但不把输入端口写入公开重置地址。
|
||||
- [✓] 更新配置、初始化、管理接口和重置控制器相关测试,覆盖不带端口的域名、IPv4、IPv6、完整 URL和附带路径场景。
|
||||
- [✓] 测试机直接模式使用临时自签名测试证书启动,仅用于本次 HTTPS 服务生命周期验证,不代表生产证书验收。
|
||||
|
||||
### 50.4 自动化验证状态
|
||||
|
||||
- [✓] `go test ./...` 通过。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] `go mod verify` 通过。
|
||||
- [✓] `npm.cmd run build` 通过。
|
||||
- [✓] `git diff --check` 通过;Git 输出的换行格式提示不属于差异错误。
|
||||
- [✓] Linux amd64 核心服务和 `Scert-admin` 重新构建并在 Ubuntu 22.04 测试机启动验证通过。
|
||||
|
||||
### 50.5 当前边界
|
||||
|
||||
- [!] 测试机使用的是临时自签名证书,尚未完成 Let’s Encrypt Production 真实申请、证书链校验和公网域名访问验收。
|
||||
- [!] 尚未使用真实 DNS API 权限执行 DNS-01 记录创建、传播检测、清理和证书续期。
|
||||
- [!] 尚未完成真实远程 SSH/SFTP 部署、Nginx reload、部署失败回滚以及 Windows 服务器实测。
|
||||
- [!] `Scert-admin` 一次性校验码当前仍通过标准输出和 systemd 日志呈现,正式生产前需要替换为受保护的本地呈现机制。
|
||||
- [!] 当前测试机原有 SQLite 配置未切换为 MySQL,MySQL 5.7 和 8.0 的真实迁移、备份、恢复和回滚仍需单独验收。
|
||||
|
||||
### 50.6 复审结论
|
||||
|
||||
Ubuntu 22.04 上的核心服务启动、`Scert-admin` 手动控制、无独立重置端口、`/reset` 入口启停生命周期和当前构建产物验证通过。本轮同时修复了重置地址仍暴露主服务端口的问题。项目仍为“本地代码和受控测试环境复审通过”,真实 ACME、DNS、远程部署、生产 HTTPS、Windows 和 MySQL 双版本验收仍未完成。
|
||||
|
||||
## 五十一、真实环境集成测试记录(2026-08-28)
|
||||
|
||||
### 51.1 本轮测试范围
|
||||
|
||||
- [x] 使用临时邮件服务执行真实登录和邮件发送接口调用。
|
||||
- [✓] 在 Ubuntu 22.04 测试机上使用独立 MySQL 数据库执行 Scert 迁移。
|
||||
- [✓] 在独立 MySQL 数据库中写入中文配置和域名测试数据。
|
||||
- [✓] 执行 Scert MySQL 备份,检查备份文件权限和内容可恢复性。
|
||||
- [✓] 将备份恢复到第二个独立 MySQL 数据库,并核对迁移、配置和域名数据。
|
||||
- [✓] 停止临时 MySQL 测试服务,确认原有 `Scert.service` 和 `5200` 监听不受影响。
|
||||
|
||||
### 51.2 临时邮件服务真实调用结果
|
||||
|
||||
- [x] 登录接口返回 HTTP 200,业务错误码为 `0`。
|
||||
- [x] 邮件发送接口返回 HTTP 200,业务错误码为 `0`。
|
||||
- [x] 请求使用 UTF-8 中文主题、纯文本正文、HTML 正文和外部收件人。
|
||||
- [x] 邮件服务实际登录响应只返回会话 Cookie,当前响应未返回 `smail_csrf` Cookie;在本次部署中,携带会话和同源请求头即可完成发送。
|
||||
- [!] 尚未从外部收件箱客户端确认最终投递、中文显示和邮件状态异步处理结果;API 返回成功只代表邮件已通过接口校验并创建发送任务。
|
||||
- [!] 需要在正式接入前确认临时服务部署版本是否与 `doc/后端接口说明文档.md` 中的 CSRF 约定一致,并保留无 CSRF Cookie 的兼容行为或补充服务端配置。
|
||||
|
||||
测试过程中未将密码、会话 Cookie 或令牌写入 Scert 配置、日志、Git 文件或本任务清单。
|
||||
|
||||
### 51.3 Ubuntu 22.04 MySQL 8.0 真实测试结果
|
||||
|
||||
测试机信息:
|
||||
|
||||
```text
|
||||
系统:Ubuntu 22.04.5 LTS
|
||||
MySQL:8.0.46-0ubuntu0.22.04.3
|
||||
监听端口:3306
|
||||
连接方式:本机 Unix Socket,使用独立测试数据库
|
||||
```
|
||||
|
||||
- [✓] 创建独立数据库 `scert_real_test_20260828`,字符集为 `utf8mb4`;未修改原有数据库。
|
||||
- [✓] 使用当前 Scert 二进制和 MySQL DSN 启动临时服务,应用启动自动完成 1—4 号迁移。
|
||||
- [✓] 迁移后确认存在 `settings`、`domains`、`tasks`、`audit_logs`、`servers`、`domain_servers`、`task_attempts` 和 `schema_migrations` 表。
|
||||
- [✓] 写入中文设置项和域名记录,读取结果与写入内容一致。
|
||||
- [✓] 执行 `scert backup`,生成 `scert.json` 和 `scert.sql` 备份。
|
||||
- [✓] SQL 备份文件权限为 `600`。
|
||||
- [✓] 创建第二个独立数据库 `scert_real_restore_20260828`,执行 `scert restore` 后,迁移版本 1—4、中文设置项和域名记录均恢复正确。
|
||||
- [✓] 临时服务停止后,原有 `Scert.service` 仍为运行状态,原有 `5200` 端口保持监听,临时 `5290` 端口已关闭。
|
||||
|
||||
### 51.4 MySQL 5.7 兼容性状态
|
||||
|
||||
- [!] 本轮未找到可安全使用的 MySQL 5.7 实际服务授权账号,未对本机或测试机的 MySQL 5.7 实例进行登录、迁移、备份或恢复操作。
|
||||
- [✓] 已通过代码级迁移语句兼容性检查;当前实现避免使用 MySQL 5.7 不支持的 `ADD COLUMN IF NOT EXISTS`,并在迁移前查询字段和索引是否存在。
|
||||
- [!] MySQL 5.7 仍需使用独立测试库完成真实迁移、中文数据、备份、恢复和重复迁移幂等性验证后,才能标记为复审通过。
|
||||
|
||||
### 51.5 DNS、ACME 和远程部署边界
|
||||
|
||||
- [!] 当前没有获得可确认的真实测试域名和可执行的 DNS API 凭据,本轮未创建或清理 `_acme-challenge` 记录,未执行 Let’s Encrypt Staging 或 Production 申请。
|
||||
- [!] 当前未执行真实 SSH/SFTP 证书推送、Nginx/Caddy/Apache reload、失败回滚和部署后公网 HTTPS 校验。
|
||||
- [!] Ubuntu 测试机本轮使用的临时自签名证书只用于 HTTPS 服务生命周期验证,不能作为 Let’s Encrypt 证书链验收结果。
|
||||
|
||||
### 51.6 本轮复审结论
|
||||
|
||||
- [✓] 临时邮件服务的真实登录和发送接口调用通过,Scert 当前 HTTP 通知请求格式与该部署的接口行为兼容。
|
||||
- [✓] Ubuntu 22.04 + MySQL 8.0 的 Scert 迁移、中文数据读写、备份和恢复通过。
|
||||
- [x] 外部邮箱最终收件、MySQL 5.7 真实实例、DNS API、Let’s Encrypt、远程服务器部署和多类反向代理仍处于等待真实环境或凭据验证状态。
|
||||
|
||||
当前准确结论:
|
||||
|
||||
```text
|
||||
Scert 本地代码、Ubuntu 22.04 服务生命周期、HTTP 邮件接口调用和 MySQL 8.0 独立数据库流程已完成验证;
|
||||
外部邮箱最终投递、MySQL 5.7 实例、DNS/ACME 证书申请、远程部署和生产级跨平台验收仍未完成。
|
||||
```
|
||||
|
||||
## 五十二、持续开发:MySQL 恢复失败保护(2026-08-28)
|
||||
|
||||
### 52.1 本轮需求清单
|
||||
|
||||
- [✓] 复审当前未提交代码,确认不覆盖两个已有补丁文件,不执行文件删除和 Git 操作。
|
||||
- [✓] 检查 MySQL 备份和恢复流程的失败安全边界。
|
||||
- [✓] 补充 MySQL 恢复前快照和失败回滚保护。
|
||||
- [✓] 防止不同数据库类型的备份被错误恢复。
|
||||
- [✓] 完成 Go、前端和差异检查。
|
||||
|
||||
### 52.2 本轮代码调整
|
||||
|
||||
- [✓] MySQL 恢复前在配置的备份目录创建 `scert-before-restore-*` 快照目录。
|
||||
- [✓] 快照目录权限设置为 `700`,SQL 快照文件权限设置为 `600`。
|
||||
- [✓] MySQL 恢复失败时自动尝试恢复目标数据库快照。
|
||||
- [✓] MySQL 数据库回滚失败时,将原始恢复错误和回滚错误同时返回。
|
||||
- [✓] 配置文件恢复仍保留原有的失败回滚逻辑。
|
||||
- [✓] SQLite 非内存数据库恢复时强制要求备份目录包含 `scert.db`。
|
||||
- [✓] 备份配置与当前配置的数据库驱动不一致时拒绝恢复。
|
||||
|
||||
### 52.3 自动化验证
|
||||
|
||||
- [✓] `go test ./...` 通过。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] `go mod verify` 通过。
|
||||
- [✓] `npm.cmd run build` 通过。
|
||||
- [✓] `git diff --check` 通过;仅报告现有 Windows 工作区换行格式提示,没有发现空白错误。
|
||||
|
||||
### 52.4 复审边界
|
||||
|
||||
- [!] 本轮未对真实 MySQL 5.7 服务执行故障注入回滚测试,仍需独立测试库和明确授权账号。
|
||||
- [!] MySQL 恢复快照在恢复成功后保留,后续需要增加备份保留策略和管理员可控清理功能;本轮不自动删除快照。
|
||||
- [!] DNS/ACME、远程服务器部署、生产 HTTPS、Windows 实机和外部邮箱最终投递仍不属于本轮已完成验收范围。
|
||||
|
||||
### 52.5 本轮复审结论
|
||||
|
||||
本轮代码修改已完成并通过现有自动化验证。MySQL 恢复流程现在具备恢复前快照、失败回滚和数据库类型隔离保护;但真实 MySQL 5.7 故障注入以及完整生产环境验收仍保持阻塞状态,不能标记为整体项目完成。
|
||||
|
||||
## 五十三、持续开发:Scert-admin 校验码安全呈现(2026-08-28)
|
||||
|
||||
### 53.1 本轮需求清单
|
||||
|
||||
- [✓] Scert-admin 不监听独立 TCP/UDP 端口,继续保持手动启动和停止策略。
|
||||
- [✓] 一次性校验码不得写入标准输出、systemd 日志、配置文件或审计日志。
|
||||
- [✓] Linux systemd 使用受保护的运行时目录保存一次性校验码。
|
||||
- [✓] 校验码文件仅允许服务运行用户和 root 读取,并在使用后销毁。
|
||||
- [✓] 补充服务停止、租约失效、成功消费和文件覆盖保护测试。
|
||||
- [!] Windows 受 ACL 保护的本地校验码呈现适配仍需单独实现和实机验收。
|
||||
|
||||
### 53.2 本轮代码调整
|
||||
|
||||
- [✓] `Scert-admin` 增加 `--code-output` 参数,支持指定一次性校验码文件路径。
|
||||
- [✓] Linux systemd 默认使用 `/run/scert-admin/reset-code`,并配置 `RuntimeDirectoryMode=0700`。
|
||||
- [✓] 一次性校验码文件采用排他创建和 `0600` 权限,禁止覆盖已有文件。
|
||||
- [✓] 状态文件只保存校验码 SHA-256 摘要和校验码文件路径,不保存明文校验码。
|
||||
- [✓] 服务停止、租约失效、校验码消费成功后自动销毁校验码文件。
|
||||
- [✓] 命令行只显示重置地址和受保护文件路径,不显示校验码明文。
|
||||
- [✓] 更新 Linux systemd unit、部署说明和 Scert-admin 运维说明。
|
||||
|
||||
### 53.3 自动化验证
|
||||
|
||||
- [✓] Scert-admin 控制器测试通过。
|
||||
- [✓] 校验码文件权限、内容、消费销毁、租约失效销毁和禁止覆盖测试通过。
|
||||
- [✓] 命令行输出测试确认不会泄露一次性校验码。
|
||||
- [✓] systemd unit 测试确认包含受保护运行时目录和 `--code-output` 参数。
|
||||
|
||||
### 53.4 复审边界
|
||||
|
||||
- [!] 本轮未在 Ubuntu 22.04 实机上验证 systemd `RuntimeDirectory` 实际权限、root/Scert 读取边界和 journal 输出;需要后续在测试机执行交互式验证。
|
||||
- [!] Windows 暂使用通用文件实现,尚未切换为 ACL 或命名管道保护方案,不能标记为跨平台安全验收通过。
|
||||
|
||||
### 53.5 本轮复审结论
|
||||
|
||||
Scert-admin 的 Linux 代码路径已经不再通过标准输出泄露一次性校验码,默认 systemd 部署改为受保护的 `/run/scert-admin/reset-code` 临时文件,并覆盖了生命周期销毁和命令行输出回归测试。Linux 实机权限边界与 Windows 受保护呈现仍保持待验证状态。
|
||||
|
||||
## 五十四、持续开发:校验码跨平台保护接入复审(2026-08-28)
|
||||
|
||||
### 54.1 本轮需求清单
|
||||
|
||||
- [✓] 继续保留超级管理员、管理员、普通用户、多角色和权限控制逻辑,不改为单账户模式。
|
||||
- [✓] 一次性校验码不得写入标准输出、systemd journal、普通配置、审计日志或备份。
|
||||
- [✓] Linux 使用 `0600` 文件权限和受保护运行时目录保存一次性校验码。
|
||||
- [✓] Windows 使用当前服务账户、Local System 和本地管理员组构造受保护 ACL。
|
||||
- [✓] 校验码成功消费、服务停止、租约失效和过期消费时销毁临时文件。
|
||||
- [✓] 已有校验码文件不得被新的重置会话覆盖。
|
||||
|
||||
### 54.2 代码复审与调整
|
||||
|
||||
- [✓] 复审发现 Windows ACL 函数已实现但未接入实际写入流程。
|
||||
- [✓] `writeCodeFile` 在写入并同步校验码后调用 `protectCodeFile`,保护失败时沿用失败清理逻辑删除临时文件。
|
||||
- [✓] Windows ACL 使用受保护 DACL,服务账户仅获得读取和删除权限,Local System 与本地管理员组保留管理权限。
|
||||
- [✓] Linux 路径继续使用 `0600` 权限,不引入不必要的平台特定依赖。
|
||||
- [✓] 保留排他创建逻辑,避免覆盖已有校验码文件。
|
||||
|
||||
### 54.3 自动化验证
|
||||
|
||||
- [✓] `go test ./...` 通过。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] `go mod verify` 通过。
|
||||
- [✓] `GOOS=windows GOARCH=amd64 go build ./internal/admin ./cmd/scert-admin` 通过。
|
||||
- [✓] `npm.cmd run build` 通过。
|
||||
- [✓] `git diff --check` 未发现空白错误;换行格式提示属于 Windows 工作区提示。
|
||||
|
||||
### 54.4 复审边界
|
||||
|
||||
- [!] 尚未在真实 Windows 服务账户环境中验证 ACL 的实际读取、删除和拒绝其他账户读取效果。
|
||||
- [!] 尚未在 Ubuntu 22.04 实机中再次验证 systemd 运行时目录权限、journal 内容和停止服务后的文件销毁。
|
||||
- [!] 真实 ACME/DNS API、远程 SSH 部署、Nginx/Caddy/Apache、生产 HTTPS 和外部邮箱最终投递仍不属于本轮已完成验收范围。
|
||||
|
||||
### 54.5 本轮复审结论
|
||||
|
||||
Windows ACL 保护现在已经接入一次性校验码实际写入流程,失败会自动清理临时文件;Linux 文件权限和生命周期销毁逻辑保持通过。自动化构建与测试通过,但 Windows 权限实测和 Ubuntu 22.04 systemd 实机复审仍需单独完成,不能将跨平台生产安全验收标记为已完成。
|
||||
|
||||
## 五十五、Ubuntu 22.04 实机复审:Scert-admin 受保护校验码(2026-08-28)
|
||||
|
||||
### 55.1 测试范围
|
||||
|
||||
- [✓] 在 Ubuntu 22.04.5 LTS 测试机 `192.168.2.3` 上部署本轮 Linux amd64 `Scert-admin` 构建产物。
|
||||
- [✓] 部署本轮 `Scert-admin.service`,执行 `systemctl daemon-reload` 和 `systemd-analyze verify`。
|
||||
- [✓] 测试机原有 `Scert-admin` 二进制和 unit 已创建带时间戳的 `/tmp` 备份,未删除原文件。
|
||||
- [✓] 验证手动启停、运行时目录权限、校验码文件权限、日志泄露、网络监听和停止后销毁行为。
|
||||
|
||||
### 55.2 实机验证结果
|
||||
|
||||
- [✓] `systemctl is-enabled Scert-admin` 返回 `static`,没有开机自启动注册。
|
||||
- [✓] `systemctl start Scert-admin` 后服务状态为 `active`。
|
||||
- [✓] `/run/scert-admin` 实际权限为 `700`,所有者为 `Scert:Scert`。
|
||||
- [✓] `/run/scert-admin/reset-code` 实际权限为 `600`,所有者为 `Scert:Scert`。
|
||||
- [✓] 本次新版服务启动后的最近日志未发现校验码明文。
|
||||
- [✓] 未发现 `Scert-admin` 独立 TCP/UDP 网络监听;核心服务继续使用既有 `5200` 监听。
|
||||
- [✓] `systemctl stop Scert-admin` 后服务变为 `inactive`,校验码文件和运行时目录均被清理。
|
||||
|
||||
### 55.3 测试机历史遗留说明
|
||||
|
||||
- [!] 测试机旧版服务在本次升级前的历史 journal 中曾保存过明文校验码;这属于旧版本遗留日志,不能通过本轮代码自动消除。
|
||||
- [!] 生产升级前应根据组织日志保留策略处理旧 journal,并确保升级后的服务不再写入明文校验码。
|
||||
- [!] `systemd-analyze verify` 同时报告了测试机其他 `snapd.service` 的未知配置项警告,与 Scert unit 无关;Scert unit 本身未产生语法错误。
|
||||
|
||||
### 55.4 当前复审结论
|
||||
|
||||
Linux Ubuntu 22.04 上的 `Scert-admin` 手动启停、无开机自启动、无独立网络监听、受保护运行时目录、校验码权限、日志不泄露和停止后销毁均已完成实机验证。Windows ACL 仍只完成代码接入、自动化交叉编译和静态复审,尚未完成 Windows 服务账户权限实测,因此整体跨平台安全验收仍不能标记为完成。
|
||||
|
||||
## 五十六、真实 ACME/DNS 测试:阿里云 DNS 与 Let’s Encrypt(2026-08-28)
|
||||
|
||||
### 56.1 测试范围
|
||||
|
||||
- [✓] 使用项目现有 `go-acme/lego` 实现进行 DNS-01 验证。
|
||||
- [✓] 使用阿里云 DNS Provider 验证 RAM 凭据和 DNS 记录操作权限。
|
||||
- [✓] 测试域名 `salg.cn` 的 DNS TXT 记录创建、传播检查和清理。
|
||||
- [!] 测试域名 `zhuguang.asia` 暂未申请证书,不修改其现有 DNS 配置。
|
||||
- [✓] 证书申请使用独立临时进程和内存密钥,不写入 Scert 证书目录、配置、数据库或备份。
|
||||
|
||||
### 56.2 代码修正
|
||||
|
||||
- [✓] 修正 `backend/internal/certificate/lego.go`:ACME 账户邮箱仅用于账户注册,不再写入证书 CSR 的 `EmailAddresses` 字段。
|
||||
- [✓] 修正后通过 Let’s Encrypt Staging 的证书申请验证,确认不再触发 `CSR contains one or more email address fields` 错误。
|
||||
|
||||
### 56.3 实测结果
|
||||
|
||||
- [✓] `salg.cn` 阿里云 DNS API 测试成功,临时 `_acme-challenge` TXT 记录能够创建和清理。
|
||||
- [✓] `salg.cn` Let’s Encrypt Staging DNS-01 验证成功。
|
||||
- [✓] `salg.cn` Let’s Encrypt Staging 证书签发成功。
|
||||
- [✓] Staging 证书域名匹配成功,证书与私钥匹配成功。
|
||||
- [✓] Staging 证书链解析成功,共解析到 5 张证书。
|
||||
- [✓] Staging 证书有效期为 2026-08-28T15:49:14Z 至 2026-11-26T15:49:13Z。
|
||||
- [✓] 通过阿里云 DNS API 查询确认测试结束后 `_acme-challenge.salg.cn` TXT 记录数为 0。
|
||||
- [✓] `go test ./...`、`go vet ./...`、`go mod verify` 和 `npm.cmd run build` 全部通过。
|
||||
|
||||
### 56.4 `zhuguang.asia` 阻塞原因
|
||||
|
||||
- [!] `_acme-challenge.zhuguang.asia` 当前存在 CNAME 委派,目标为 `expired.hichina.com`。
|
||||
- [!] 阿里云 Provider 按 CNAME 委派查找目标 DNS 区域时,无法在当前阿里云账号中找到 `expired.hichina.com` 托管区域。
|
||||
- [!] 在用户修正或确认该 CNAME 委派前,不执行自动删除、替换或新增 DNS 记录。
|
||||
|
||||
### 56.5 Production 实测边界
|
||||
|
||||
- [!] `salg.cn` Production 申请已发起,但因递归 DNS 服务器在传播窗口内仍返回此前测试的旧 TXT 值,未能完成本次验证。
|
||||
- [✓] Production 失败后 lego 已执行 DNS-01 清理和授权停用,没有留下运行中的申请任务。
|
||||
- [!] 该失败暴露出 DNS 删除/新增后的缓存传播窗口约为 600 秒;后续应在生产流程中支持可配置传播等待时间、重试策略和失败后的明确诊断。
|
||||
- [!] 本轮未将生产证书保存到 Scert 默认目录,也未执行远程服务器部署或修改 Nginx、Caddy、Apache 配置。
|
||||
|
||||
### 56.6 本轮复审结论
|
||||
|
||||
阿里云 DNS Provider 的 RAM 权限、`salg.cn` 的 DNS-01 验证、lego Staging 证书申请、证书解析、域名匹配、私钥匹配和清理流程已完成真实验证。当前需要后续处理的事项为:修正 `zhuguang.asia` 的 CNAME 委派,以及在 DNS 传播延迟场景下完善 Production 申请的等待和重试策略。Production 证书签发、证书落盘、自动续期、远程部署和线上 HTTPS 校验仍不能标记为整体完成。
|
||||
|
||||
|
||||
## 五十七、DNS-01 传播等待与诊断配置(2026-08-29)
|
||||
|
||||
### 57.1 需求清单
|
||||
|
||||
- [✓] 为 DNS-01 增加可配置的最大传播等待时间。
|
||||
- [✓] 为 DNS-01 增加可配置的传播检测间隔。
|
||||
- [✓] 保留旧配置兼容性,读取缺少新字段的配置时自动补齐默认值。
|
||||
- [✓] 对等待时间和检测间隔增加范围校验,避免无效参数进入证书申请流程。
|
||||
- [✓] 证书申请失败时输出本次使用的传播等待参数,便于诊断 DNS 缓存传播延迟。
|
||||
|
||||
### 57.2 实现清单
|
||||
|
||||
- [✓] 在 `ACMEConfig` 中增加 `propagation_timeout_secs`,默认值为 900 秒。
|
||||
- [✓] 在 `ACMEConfig` 中增加 `propagation_polling_interval_secs`,默认值为 10 秒。
|
||||
- [✓] 通过 `challenge.ProviderTimeout` 包装实际 DNS Provider,并注入 `go-acme/lego`。
|
||||
- [✓] 在 `scert config set` 支持修改上述两个配置项。
|
||||
- [✓] 增加默认值、旧配置归一化、范围校验和保存加载测试。
|
||||
- [✓] 增加 Provider 操作转发、参数读取、无效参数保护和空 Provider 测试。
|
||||
- [✓] 保持敏感 DNS 凭据仅在调用时解密,未改变明文配置阶段和加密持久化策略。
|
||||
|
||||
### 57.3 参数规则
|
||||
|
||||
| 配置项 | 默认值 | 允许范围 | 说明 |
|
||||
|---|---:|---:|---|
|
||||
| `acme.propagation_timeout_secs` | 900 秒 | 1 至 86400 秒 | DNS 记录发布后,lego 等待验证传播的最长时间 |
|
||||
| `acme.propagation_polling_interval_secs` | 10 秒 | 大于 0 且不大于等待时间 | lego 检查 DNS 记录传播状态的间隔 |
|
||||
|
||||
### 57.4 验证结果
|
||||
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] `go mod verify` 通过。
|
||||
- [✓] 前端生产构建通过。
|
||||
- [✓] `git diff --check` 通过。
|
||||
|
||||
### 57.5 当前边界
|
||||
|
||||
- [!] 配置已接入真实 lego DNS-01 流程,但仍需使用真实 DNS Provider 和 Let's Encrypt Production 在公网传播延迟场景完成最终验收。
|
||||
- [!] 本轮未修改远程服务器部署、Nginx、Caddy、Apache 或证书文件替换逻辑。
|
||||
|
||||
## 五十八、Web 初始化接入 DNS-01 传播等待配置(2026-08-29)
|
||||
|
||||
### 58.1 本轮需求清单
|
||||
|
||||
- [✓] Web 初始化向导可以配置 DNS-01 最大传播等待时间。
|
||||
- [✓] Web 初始化向导可以配置 DNS-01 传播检测间隔。
|
||||
- [✓] Web 表单显示默认值:最大等待 900 秒、检测间隔 10 秒。
|
||||
- [✓] 前端阻止小于 1 秒、超过 86400 秒或检测间隔大于最大等待时间的输入。
|
||||
- [✓] 配置完成前参数只保留在向导内存,提交时由后端统一校验并保存。
|
||||
- [✓] 兼容未提交这两个字段的旧调用,后端沿用配置默认值。
|
||||
|
||||
### 58.2 代码调整
|
||||
|
||||
- [✓] `backend/internal/httpapi/setup.go` 接收并返回两个 DNS 传播配置字段。
|
||||
- [✓] `backend/internal/setup/setup.go` 将 Web 初始化请求写入 `ACMEConfig`,保留零值缺省兼容行为。
|
||||
- [✓] `frontend/src/views/SetupWizard/SetupWizard.js` 增加表单状态、前端校验和提交字段。
|
||||
- [✓] `frontend/src/views/SetupWizard/SetupWizard.vue` 在 DNS 验证步骤增加两个中文配置项及说明。
|
||||
- [✓] 保持页面相关文件按 `src/views/SetupWizard/` 目录集中管理。
|
||||
|
||||
### 58.3 自动化验证
|
||||
|
||||
- [✓] 增加初始化层的非法传播参数回归测试。
|
||||
- [✓] 增加 Web 初始化接口保存传播参数回归测试。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] `go mod verify` 通过。
|
||||
- [✓] `npm.cmd run build` 通过。
|
||||
- [✓] `git diff --check` 通过。
|
||||
- [✓] 目标代码范围未发现连续问号、替换字符或错误换行标记。
|
||||
|
||||
### 58.4 复审边界
|
||||
|
||||
- [!] 本轮未使用浏览器 MCP 进行页面截图验收;本轮目标是配置链路接入,不包含布局和视觉改版。
|
||||
- [!] 真实 DNS Provider、Let's Encrypt Production 公网传播延迟和生产续期仍需在授权环境完成最终验收。
|
||||
- [!] 本轮未执行 Git 提交、推送、文件清理或删除。
|
||||
## 五十九、初始化向导通知布局与敏感凭据交互优化(2026-08-29)
|
||||
|
||||
### 59.1 需求清单
|
||||
|
||||
- [x] 初始化向导第二步按服务配置、认证配置、敏感凭据、收发件人和投递策略分组显示。
|
||||
- [x] HTTP 通知的 Token、HMAC 密钥和会话凭据支持配置时明文查看与隐藏切换。
|
||||
- [x] 配置提交后由后端加密保存敏感凭据,普通配置文件不保存明文密钥。
|
||||
- [x] DNS 凭据字段使用不同的动态 ID,避免模板静态检查发现重复 ID。
|
||||
- [x] 页面显示文字保持中文,源码范围未发现 HTML 编码中文和替换字符。
|
||||
|
||||
### 59.2 实现与验证清单
|
||||
|
||||
- [x] 完成 `SetupWizard.vue` 中 DNS 普通凭据输入框动态 ID 修正。
|
||||
- [x] 完成前端生产构建验证:`npm.cmd run build`。
|
||||
- [x] 完成后端竞态测试:`go test -race ./...`。
|
||||
- [x] 完成后端静态检查:`go vet ./...`。
|
||||
- [x] 完成 Go 模块完整性检查:`go mod verify`。
|
||||
- [x] 完成 Git 差异格式检查:`git diff --check`。
|
||||
- [!] 浏览器 MCP 因共享 Chrome Profile 已被其他浏览器进程占用,本轮未完成真实截图验收;未强制关闭用户浏览器。
|
||||
- [!] 低高度桌面窗口下的初始化向导最终视觉效果仍需在 MCP 可用后复测。
|
||||
|
||||
### 59.3 当前状态
|
||||
|
||||
本轮代码调整和自动化检查已完成,相关任务标记为“已完成,等待复审”。浏览器 MCP 视觉验收属于外部运行环境阻塞,不影响前端构建和后端自动化检查结果;待独立浏览器窗口可用后,再对桌面宽屏、中等窗口和低高度窗口进行实际显示复审。
|
||||
Reference in new issue
Block a user