完善 Scert 前后端与部署支持

This commit is contained in:
xuans committed 2026-08-30 17:44:54 +08:00
1 parent afdb947bea
commit 7f0af703ed
85 files changed
+7530 -800

No files matched your search

+12 -19
View File
@@ -687,7 +687,7 @@ POST /api/v1/domains/{id}/test-servers
| fingerprint | 证书指纹 |
| issued_at | 签发时间 |
| expires_at | 到期时间 |
| status | `current`、`history`、`failed`、`rolled_back` |
| status | `current`、`failed`、`rolled_back` |
| created_at | 创建时间 |
### 5.4 servers
@@ -795,29 +795,20 @@ SAN 进入默认 UI、自动续期、证书版本保存、部署关联和验收
```text
{storage_root}/{domain}/
├── production/
│ ├── wildcard/
│ │ ├── current/
│ │ └── versions/{version}/
│ └── single/
│ ├── current/
│ └── versions/{version}/
└── development/
├── wildcard/
│ ├── current/
│ └── versions/{version}/
└── single/
├── current/
└── versions/{version}/
├── wildcard/
│ └── YYYYMMDD-Vx.x/
├── single/
│ └── YYYYMMDD-Vx.x/
└── san/{certificate_identifier}/
└── YYYYMMDD-Vx.x/
```
每个版本目录至少包含:
```text
cert.pem
chain.pem
fullchain.pem
privkey.pem
key.pem
metadata.json
```
@@ -825,9 +816,11 @@ metadata.json
- Linux 私钥文件使用 600 或更严格权限。
- Windows 使用仅服务账户和授权管理员可读的 ACL。
- `current` 可以使用目录切换或受控复制,不直接覆盖正在使用的版本。
- 生产和开发申请环境由域名配置中的 ACME 环境字段区分,不再创建两套证书目录。
- 每个证书类型正式目录只保留一个当前版本目录;版本目录名称使用 `YYYYMMDD-Vx.x`。
- 新证书写入新版本目录并完成校验后移除旧当前版本;失败时从备份目录恢复。
- 删除域名时先停止相关任务,再删除数据库记录和证书文件。
- 用户上传证书默认保留当前版本和一个最近历史版本。
- 用户上传证书默认只保留当前版本,备份目录仅用于失败回滚,不作为历史版本目录展示。
### 6.1 跨平台默认路径
+14 -22
View File
@@ -65,35 +65,27 @@
```text
/ssl/{域名}/
├── production/ 生产证书
│ ├── wildcard/ 泛域名证书,例如 *.example.com
│ │ ├── current/ 当前使用版本
│ │ └── versions/{版本}/ 历史版本
│ └── single/ 单域名证书,例如 example.com
│ ├── current/
│ └── versions/{版本}/
└── development/ 开发证书,目录结构与 production 相同
├── wildcard/ 泛域名证书,例如 *.example.com
│ └── {日期}-Vx.x/ 当前使用版本
├── single/ 单域名证书,例如 example.com
│ └── {日期}-Vx.x/ 当前使用版本
└── san/{证书标识}/ 多域名 SAN 证书
└── {日期}-Vx.x/ 当前使用版本
```
版本目录名称格式为 `YYYYMMDD-Vx.x`,例如 `20260830-V1.0`。同一天再次保存时递增版本号,例如 `20260830-V1.1`。生产和开发证书不再使用两套目录层级,统一由域名配置中的 ACME 环境字段区分申请环境。正式证书目录只保留当前使用版本;新证书保存成功后替换旧当前版本,旧文件仅在失败回滚所需时进入备份目录。
多域名 SAN 证书纳入第一阶段,证书以主域名作为管理归属,并保存完整的 SAN 域名集合。SAN 证书目录使用证书标识区分不同域名集合:
```text
/ssl/{主域名}/
├── production/
│ ├── wildcard/
│ ├── single/
│ └── san/{证书标识}/
│ ├── current/
│ └── versions/{版本}/
└── development/
├── wildcard/
├── single/
└── san/{证书标识}/
├── current/
└── versions/{版本}/
└── san/{证书标识}/
└── {日期}-Vx.x/
```
其中 `{证书标识}` 必须能够稳定对应主域名和 SAN 域名集合;域名集合发生变化时创建新的证书版本,不覆盖原有证书版本。
其中 `{证书标识}` 必须能够稳定对应主域名和 SAN 域名集合;域名集合发生变化时更新当前证书版本目录,不在正式证书目录中保留历史版本。
【用户补充 U-074】(2026-08-30):将生产/开发目录和当前/历史版本目录合并简化;正式证书目录只保留当前使用版本,版本目录名称使用日期加 `Vx.x`。本补充作为当前实现约束,优先于本节之前关于双环境目录和正式目录保留历史版本的描述。
### 1.3 DNS 验证
@@ -1020,4 +1012,4 @@ imported 外部导入
- **用户补充:**为不熟悉 SSH 密钥生成的用户提供从生成密钥到粘贴公钥的完整指导,并支持更省事的操作方式。
- **实现说明:**服务器配置页面增加 Windows、Linux/macOS 命令切换;支持复制密钥生成命令、复制公钥安装命令、选择本机私钥文件导入、私钥口令显示/隐藏,以及 Linux 和 Windows OpenSSH 授权位置说明。私钥只在页面内存中读取,保存时由后端加密存储。
- **状态:**`[x]` 已完成前端引导和中文说明文档,待前端构建和真实浏览器页面复审。
- **状态:**`[x]` 已完成前端引导和中文说明文档,待前端构建和真实浏览器页面复审。
+231
View File
@@ -2710,3 +2710,234 @@ Linux Ubuntu 22.04 上的 `Scert-admin` 手动启停、无开机自启动、无
- [x] 源码中未发现 HTML 数字编码中文字符。
- [x] `git diff --check` 通过。
- [!] 浏览器 MCP 当前因共享 Chrome Profile 被其他浏览器进程占用,暂未完成本次实际输入交互截图复审。
## 六十三、初始化向导布局与 DNS API 在线测试完善(2026-08-29)
### 63.1 本轮需求
- [✓] 将 Scert 主服务端口放入初始化向导第 1 步。
- [✓] 将管理页面使用的域名或公网 IP 放入初始化向导第 1 步。
- [✓] 补全 DNS API 在线测试的临时 TXT 记录创建、公网 DNS 查询确认和自动清理流程。
- [✓] 在前端展示 DNS 在线测试的创建、查询和清理阶段状态及诊断信息。
### 63.2 细节修复
- [✓] 将“管理页面访问方式”从嵌套 `label` 调整为独立可访问性控件,避免按钮名称错误继承外层字段标题。
- [✓] 为域名/IP切换按钮补充 `aria-pressed` 状态。
- [✓] 将 DNS 验证兜底错误改为中文提示“DNS API 在线验证失败”。
### 63.3 验证状态
- [✓] 后端单元测试、竞态测试、静态检查和模块校验通过。
- [✓] 前端生产构建通过。
- [✓] 无效 DNS 凭据测试能够展示“创建记录:失败”阶段诊断,未暴露 TXT 验证值或凭据。
- [✓] 桌面浏览器已完成 1440×900、1200×700 宽度/低高度复审,内容区可滚动且底部操作栏保持可见。
- [!] 真实 DNS 服务商成功链路不能在无用户授权凭据和测试域名时重复执行;现有真实验证记录仍以此前授权测试结果为准。
## 六十四、临时文件清理与 DNS 在线测试取消场景保护(2026-08-29)
### 64.1 文件清理
- [✓] 删除根目录已确认无用的 `.codex-*` 临时补丁和临时源码副本。
- [✓] 删除 `.review-reset-docs.patch`、`backend/codex-restore.patch` 和 `backend/.codex-test-build/`。
- [✓] 未删除源码、文档、配置、数据库、证书、运行数据、依赖目录或可能正在使用的构建产物。
- [✓] 清理后确认工作区中未残留上述 Codex 临时文件。
### 64.2 DNS 在线测试保护
- [✓] 公网 DNS 查询失败或请求被取消后,仍使用独立清理上下文尝试删除临时 TXT 记录。
- [✓] 清理上下文最多保留 30 秒,避免继承已取消的请求上下文,也避免清理操作无限等待。
- [✓] 增加查询取消后自动清理的回归测试。
- [✓] 增加查询失败且自动清理失败时的组合诊断和阶段报告回归测试。
- [✓] 修复 DNS 测试辅助代码中的连续问号占位错误,恢复可读的中文诊断。
### 64.3 验证结果
- [✓] DNS Provider 定向测试通过。
- [✓] `go test -race ./...` 通过。
- [✓] `go vet ./...` 通过。
- [✓] `go mod verify` 通过。
- [✓] `npm.cmd run build` 通过。
- [✓] `git diff --check` 通过;Git 的换行格式提示不属于差异错误。
- [✓] 跟踪中的源码和文档未发现连续问号、替换字符或 HTML 数字编码中文。
- [!] 本轮未重复使用真实 DNS 凭据写入公网记录;真实服务商成功链路继续沿用此前授权测试结果。
## 六十五、管理后台登录态门禁接入(2026-08-29)
### 65.1 本轮需求清单
- [✓] 初始化完成后,前端先读取服务端登录会话,再决定显示管理后台或登录页面。
- [✓] 未登录访问根路径时显示管理员登录界面,不再把管理接口 401 错误误报为核心服务连接失败。
- [✓] 初始化向导完成后进入登录状态检查,避免初始化完成后直接渲染未授权管理后台。
- [✓] 登录态检查请求显式携带 Cookie,并保留后端会话过期后的重新登录入口。
### 65.2 修改文件
- `frontend/src/App.js`
- 增加初始化完成后的 `/api/v1/auth/session` 会话检查。
- 区分未登录、已登录和服务检查失败状态。
- 初始化向导完成后将管理后台置为未登录状态。
- `frontend/src/App.vue`
- 未登录时渲染管理员登录页面。
- 只有确认已登录后才渲染管理后台。
- `frontend/src/views/Dashboard/Dashboard.js`
- 管理接口统一携带登录 Cookie。
- 会话过期时跳转到管理员登录页面,并显示重新登录提示。
### 65.3 验证状态
- [✓] 前端生产构建。
- [✓] 后端回归测试、竞态测试、静态检查和模块完整性检查。
- [x] 通过浏览器隔离模拟已初始化且未登录场景,根路径显示管理员登录页面,未直接渲染管理数据。
- [x] 通过浏览器隔离模拟已初始化且已登录场景,根路径显示管理后台并完成空数据状态加载。
- [x] 当前管理后台会话过期时跳转管理员登录页面,并提示重新登录。
- [!] 当前运行配置仍未完成首次初始化,尚未在真实已初始化运行数据上重复执行登录流程;隔离模拟不替代生产验收。
- [!] 真实浏览器截图复审仍需独立浏览器 MCP 窗口;不能用移动端预览替代桌面端复审。
## 六十六、CNAME 委派与凭据规范化完成记录(2026-08-29)
### 66.1 开发任务状态
- [✓] CNAME Provider 标记为可用,并支持配置专用验证域。
- [✓] CNAME 委派支持选择已接入的目标 DNS Provider。
- [✓] CNAME 委派支持嵌套 JSON 凭据,并复用目标 Provider 的凭据校验和 lego 适配器。
- [✓] DNS-01 临时 TXT 记录的创建和清理转发到专用验证域。
- [✓] 委派目标禁止再次选择 CNAME 或其他未接入 Provider,避免递归和不明确的适配器行为。
- [✓] 初始化保存 DNS 凭据前复制并规范化键和值,不修改调用方输入。
- [✓] 增加委派转发、错误透传、递归保护、凭据 JSON 校验和凭据规范化测试。
### 66.2 验证状态
- [✓] `go test ./...` 通过。
- [ ] `go test -race ./...`、`go vet ./...`、`go mod verify` 和前端生产构建等待本轮最终复核。
- [!] 未使用真实 DNS 凭据执行公网 CNAME、TXT 传播和 Let’s Encrypt Production 验收;该项必须在用户授权的真实域名环境执行。
## 六十七、全量代码复审与最终验证记录(2026-08-29)
### 67.1 本轮需求与开发状态
- [✓] 系统设置页面补充服务监听地址、服务端口、HTTPS 模式、管理页面域名和管理页面公网 IP。
- [✓] 初始化向导保留首次运行所需的端口和 Web 访问方式配置,并与服务端配置字段保持一致。
- [✓] DNS API 在线测试支持服务商目录、动态凭据字段、CNAME 委派专用验证域、目标 Provider 和嵌套凭据 JSON。
- [✓] DNS 在线测试覆盖临时 TXT 记录创建、公网查询、自动清理和失败阶段报告。
- [✓] CNAME 委派 Provider 已接入,目标 Provider 禁止再次选择 CNAME 或未接入 Provider。
- [✓] DNS 凭据在验证前规范化并在验证成功后加密保存,普通配置和接口响应不返回明文凭据。
- [✓] 设置接口仅在监听地址、服务端口或 HTTPS 模式变化时返回 `restart_required: true`。
- [✓] 手动续期检查接口已接入管理后台。
### 67.2 实际浏览器和接口复核
- [✓] 当前源码后端已重新构建并启动于 `127.0.0.1:5200`。
- [✓] 前端开发服务运行于 `127.0.0.1:5273`,独立 Chrome DevTools 页面可正常访问。
- [✓] 初始化向导第 1 步实际显示 Scert 主服务端口、管理页面域名/IP 切换和密码重置地址预览。
- [✓] DNS Provider 实际显示“CNAME 委派”,不再显示“适配器待开放”。
- [✓] 选择 CNAME 委派后实际显示专用验证域、委派目标 DNS 服务商和委派凭据 JSON 字段。
- [✓] 使用伪造 Cloudflare 凭据实际触发在线测试,页面显示“创建记录:失败”,未误报验证成功。
- [✓] 设置和初始化接口实际返回服务端口、Web 域名/IP、传播参数和 DNS Provider 状态。
### 67.3 最终自动化验证
- [✓] `go test ./...`
- [✓] `go test -race ./...`
- [✓] `go vet ./...`
- [✓] `go mod verify`
- [✓] `npm.cmd run build`
- [✓] `git diff --check`
### 67.4 文件清理与验收边界
- [✓] 根目录没有发现 `.codex` 目录或已知 Codex 临时源码副本。
- [!] `.runtime` 中仍有 3 个已确认的 Codex 临时补丁文件;本轮逐个删除命令被当前执行环境安全策略拒绝,因此未绕过策略强制删除。
- [✓] 未删除源码、文档、配置、数据库、证书、密钥、运行目录或构建产物。
- [!] 未在本轮使用新的真实 DNS 凭据、Let’s Encrypt Production、SSH 私钥、远程服务器或生产 HTTPS 环境;这些仍需用户授权后的实机验收。
- [✓] 代码层开发和本地验证完成,Git 提交与推送仍未执行。
## 六十八、部署脚本、发布构建与通知安全复核(2026-08-30)
### 68.1 本轮需求清单
- [✓] 增加 Windows 安装器,检查平台、管理员权限、安装产物、服务名称和系统工具。
- [✓] Windows 安装器创建程序、配置、数据、日志、备份、文档、运行时和证书目录。
- [✓] Windows 安装器使用 `LocalService` 注册 `Scert` 和手动启动的 `Scert-admin`,并设置 ACL。
- [✓] Windows 安装器不启动服务、不创建公网防火墙规则、不删除已有配置、数据库、证书和备份。
- [✓] 增加 Windows amd64 和 Linux amd64 的跨平台发布构建脚本。
- [✓] 发布构建输出核心服务、密码重置程序和 SHA-256 校验清单。
- [✓] 通知会话认证保留密码原始字节,不对密码使用 `TrimSpace`;登录业务错误解析 `errorNo`,并保留非敏感错误说明。
- [✓] 通知发送接口仍按“进入邮件服务队列”处理,不将 HTTP 成功误称为最终收件成功。
### 68.2 新增和修改文件
- `deploy/install-windows.ps1`
- `deploy/README.md`
- `build/build-release.ps1`
- `build/README.md`
- `backend/internal/notification/service.go`
- `backend/internal/notification/service_test.go`
### 68.3 验证边界
- [x] Windows 安装脚本已完成代码编写,等待 Windows 管理员权限、服务控制台和 ACL 实机复审。
- [x] 发布构建脚本已完成代码编写,等待本轮执行 Windows/Linux 目标构建。
- [x] 通知会话流程已完成本地测试覆盖,真实临时邮箱最终投递仍需查看邮件详情状态和收件证据。
- [!] 未使用真实 DNS 凭据、Let’s Encrypt Production、SSH 私钥、远程服务器或生产 HTTPS 环境;这些项目仍需用户授权后的实机验收。
## 六十九、SSH 密钥随机路径与配置引导复核(2026-08-30)
### 69.1 本轮需求与实现状态
- [✓] 本机 SSH 密钥统一使用 `/ssl/ssh/` 目录生成。
- [✓] 密钥文件名使用 `用户名+scert-随机标识` 格式,公钥文件追加 `.pub`。
- [✓] 每次打开 SSH 密钥配置弹窗都会重新生成随机标识,避免不同主机或不同配置复用固定文件名。
- [✓] Windows、Linux/macOS 密钥生成命令和公钥安装命令统一使用当前随机路径。
- [✓] 页面显示本次密钥文件名、本地私钥路径、本地公钥路径和远程登录目标。
- [✓] Scert 后端仍仅保存加密敏感信息引用,不将本地明文私钥路径或私钥内容写入普通配置。
### 69.2 本轮验证结果
- [✓] `npm.cmd run build` 通过。
- [✓] 浏览器复核首次打开和再次打开弹窗时随机文件名发生变化。
- [✓] 浏览器复核服务器配置填写 `deploy` 和 `192.0.2.50` 后,路径和 SSH 目标同步更新。
- [✓] 浏览器复核 Windows 与 Linux/macOS 命令均包含当前随机路径和公钥 `.pub` 路径。
- [✓] 桌面端 1440×901 视口下弹窗宽度为 1080px,页面背景滚动已锁定,弹窗内部无垂直溢出。
- [!] 真实 SSH 主机、公钥安装、私钥登录和证书部署仍需用户提供并授权实机环境后验收。
## 七十、证书目录结构合并与当前版本简化(2026-08-30)
### 70.1 本轮需求清单
- [✓] 合并生产和开发证书目录层级,申请环境继续由域名配置中的 ACME 环境字段区分。
- [✓] 合并当前和历史版本目录层级,正式证书目录只保留当前使用版本。
- [✓] 版本目录名称改为 `YYYYMMDD-Vx.x`,例如 `20260830-V1.0`。
- [✓] 同一天重复保存时递增版本号,避免目录覆盖。
- [✓] 保留备份目录用于保存失败回滚所需的旧证书文件,不将备份目录作为历史版本列表。
- [✓] 前端移除历史版本查看和恢复入口,只显示当前证书状态。
### 70.2 代码和文档调整
- `backend/internal/certificate/lifecycle.go`
- `backend/internal/certificate/lifecycle_version_test.go`
- `backend/internal/certificate/service_test.go`
- `frontend/src/views/Dashboard/Dashboard.vue`
- `frontend/src/views/Dashboard/Dashboard.js`
- `frontend/src/views/Dashboard/Dashboard.css`
- `doc/SSL服务程序需求确认文档.md`
- `doc/SSL服务程序技术架构设计文档.md`
### 70.3 验证状态
- [x] 证书生命周期专项测试已通过,等待全量后端测试复审。
- [x] 新目录格式、重复保存唯一性、旧当前目录清理和失败回滚已覆盖自动化测试。
- [x] 前端历史版本面板和恢复操作已移除,等待前端构建复审。
- [!] 旧安装目录中的历史文件未执行批量清理,避免未经授权删除用户证书、私钥或备份;后续迁移清理需单独授权。
## 七十一、登录界面用户化(2026-08-30)
### 71.1 本轮需求清单
- [✓] 登录页面标题由“管理员登录”调整为“用户登录”。
- [✓] 登录页面说明、密码占位符和无障碍标签统一使用“用户”文案。
- [✓] 登录流程阶段标题同步调整为“用户登录”,不改变服务端认证、角色识别和会话逻辑。
### 71.2 验证状态
- [✓] 登录相关前端文件已完成修改,等待本轮构建复审。
- [!] 后端仍根据服务端返回结果识别超级管理员、管理员和普通用户,未因页面文案调整而改变权限模型。
+3 -3
View File
@@ -2,7 +2,7 @@
## 1. 配置目的
Scert 的证书申请、续期、部署和校验任务完成后,可以通过第三方邮件服务 API 发送通知。SMTP、IMAP、POP3 协议仅作为外部邮件服务兼容性参考,Scert 不实现邮件服务器端;当前已接入 HTTP 邮件 API 通知。
Scert 的证书申请、续期、部署和校验任务完成后,可以通过第三方邮件服务 API 或 SMTP 服务发送通知。Scert 只实现出站通知客户端,不实现 SMTP、IMAP、POP3 邮件服务器端;HTTP 邮件 API 和 SMTP 出站通知均已接入。
## 2. HTTP 邮件服务配置
@@ -58,7 +58,7 @@ Smail 当前接口需要登录会话 Cookie、`smail_csrf` Cookie、`X-CSRF-Toke
## 6. 当前实现边界
当前阶段已完成邮件通知配置的保存、校验、初始化接口、CLI/Web 表单接入和 HTTP 通知发送器。SMTP 发送器尚未接入;当前应优先使用 HTTP 邮件 API 方式配置邮件服务。Smail 登录会话可通过 `session` 认证模式自动建立和刷新。
当前阶段已完成邮件通知配置的保存、校验、初始化接口、CLI/Web 表单接入、HTTP 通知发送器和 SMTP 出站通知发送器。SMTP 支持 `plain`、`starttls` 和 `implicit_tls` 三种连接模式;生产环境建议使用 STARTTLS 或隐式 TLS。Smail 登录会话可通过 `session` 认证模式自动建立和刷新。
## 7. 当前开发状态补充
@@ -73,4 +73,4 @@ Smail 当前接口需要登录会话 Cookie、`smail_csrf` Cookie、`X-CSRF-Toke
- 将所有 2xx 响应视为成功,其他响应按重试配置处理。
- 证书工作流会在任务成功、失败或部署错误后触发通知;通知发送失败会写入 Scert 日志,不覆盖原证书任务结果。
SMTP 发送器仍未接入。初始化界面和 CLI 不再暴露 SMTP 开关,旧配置字段仅为兼容已有配置文件保留,并不会在初始化时启用。Smail 登录会话的自动适配已通过 `session` 模式接入,仍需在目标部署环境使用实际凭据进行上线前复核。
SMTP 出站通知已经接入。初始化界面和 CLI 可以配置 SMTP 主机、端口、用户名、凭据引用、连接模式和明文认证开关;SMTP 密码只保存到加密敏感信息存储,配置文件仅保存 `secret://` 凭据引用。明文连接认证默认拒绝,只有明确启用 `SMTP 明文认证` 后才允许。CLI 可使用 `scert config set-secret --key notification.smtp_password` 保存敏感值。SMTP 是出站连接,Scert 不需要开放 SMTP 入站端口。Smail 登录会话的自动适配已通过 `session` 模式接入,仍需在目标部署环境使用实际凭据进行上线前复核。