完善证书申请续期与安装初始化流程
This commit is contained in:
1 parent
fd8d8608f5
commit
07636abe44
66 files changed
+9470
-165
No files matched your search
@@ -1166,3 +1166,81 @@ service installer Windows/Linux 安装脚本或安装包
|
||||
- `[x]` 已完成,等待复审
|
||||
- `[✓]` 复审通过
|
||||
- `[!]` 暂缓或存在阻塞
|
||||
|
||||
## 十七、本轮安装部署架构补充(2026-08-26)
|
||||
|
||||
### 17.1 安装产物
|
||||
|
||||
安装产物统一包含以下组件:
|
||||
|
||||
```text
|
||||
Scert/
|
||||
├── scert # 核心服务和 CLI
|
||||
├── scert-admin # 超级管理员密码重置服务
|
||||
├── config/ # 配置目录
|
||||
├── data/ # SQLite 数据库或本地数据
|
||||
├── ssl/ # Windows 默认证书根目录
|
||||
├── logs/
|
||||
└── backups/
|
||||
```
|
||||
|
||||
Linux 安装目录固定为 `/scert`,证书根目录默认 `/ssl`;Windows 安装根目录由用户选择,默认目录为 `{安装目录}\Scert\ssl`、`data`、`config`、`logs` 和 `backups`。
|
||||
|
||||
### 17.2 初始化状态机
|
||||
|
||||
```text
|
||||
未初始化
|
||||
-> 写入超级管理员和双端口配置
|
||||
-> 写入第三方邮箱配置
|
||||
-> 写入 DNS provider 和加密凭据引用
|
||||
-> DNS API 验证
|
||||
失败 -> 保持未初始化并记录错误
|
||||
成功 -> 申请 Web 证书
|
||||
-> 本地保存、部署和 HTTPS 校验
|
||||
失败 -> 保留原证书并保持未初始化
|
||||
成功 -> 写入 Web 域名/IP和证书路径
|
||||
-> 检查并放行 Scert 主服务本机防火墙端口
|
||||
防火墙未启用 -> 记录无需创建规则并继续
|
||||
权限或规则创建失败 -> 保持未初始化并返回明确错误
|
||||
配置保存失败 -> 只回滚本次新建的规则
|
||||
-> 启动或启用 Scert 核心服务
|
||||
-> Scert-admin 保持停止状态,仅在管理员明确执行密码重置操作时手动启动
|
||||
-> 提示云安全组放行要求
|
||||
-> 初始化完成
|
||||
```
|
||||
|
||||
`setup_ready=true` 只能在超级管理员摘要存在、DNS 验证状态为 `verified`、Web 域名或公网 IP 已配置并完成证书流程后写入。当前代码已实现配置字段和前置校验,证书流程仍由 `go-acme/lego` 模块接入。
|
||||
|
||||
### 17.3 运行端口
|
||||
|
||||
| 服务 | 默认监听地址 | 默认端口 | 可配置 | 公网暴露策略 |
|
||||
|---|---|---:|---|---|
|
||||
| Scert 主服务 | `0.0.0.0` | 8080 | 是 | 按用户指定端口和 HTTPS 模式开放 |
|
||||
| Scert-admin | `127.0.0.1` | 8091 | 是 | 默认不允许公网暴露 |
|
||||
|
||||
主服务和密码重置服务禁止使用相同监听地址与端口。云安全组属于外部资源,安装程序默认显示提示,不直接假设具有云厂商 API 权限。
|
||||
|
||||
#### 17.3.1 本机防火墙适配
|
||||
|
||||
- 初始化程序只自动开放 Scert 主服务的 TCP 端口,不为 `Scert-admin` 创建对外入站规则。
|
||||
- Windows 10/11 通过 Windows Defender 防火墙 PowerShell cmdlet 检查状态、查询固定名称规则并创建入站允许规则。
|
||||
- Ubuntu 优先使用 UFW;CentOS/Rocky Linux 及启用 firewalld 的发行版使用 `firewall-cmd` 永久规则并重新加载。
|
||||
- 防火墙命令使用固定命令模板和参数数组执行,用户端口必须先通过 `1-65535` 校验,禁止将用户输入拼接为 Shell 命令。
|
||||
- 已有规则保持不变,重复初始化不得重复创建;只有本次初始化创建的规则才登记为可回滚变更。
|
||||
- 本机防火墙未启用时不主动启用,只返回“无需创建规则”状态;权限不足或执行失败时初始化失败并提示以管理员或 root 权限重新运行。
|
||||
- 云安全组仍由用户手动放行,初始化结果必须同时显示主服务端口和安全组提示。
|
||||
|
||||
### 17.4 进程和服务管理
|
||||
|
||||
- Linux:后续提供 `scert.service` 和 `scert-admin.service` 两个 systemd 单元,服务运行用户为 `Scert`。
|
||||
- Linux:`Scert-admin.service` 不提供 `[Install]` 段,不注册开机自启动;日常仅支持 `systemctl start Scert-admin` 和 `systemctl stop Scert-admin`,不配置自动重启或 `ExecReload`。安装或升级阶段仅允许使用一次 `systemctl daemon-reload` 加载 unit,不得自动启动或启用 `Scert-admin`。
|
||||
- Windows:后续提供 `Scert` 和 `Scert-admin` 两个 Windows Service;桌面端负责显示服务状态和 Web 开关。
|
||||
- 两个服务共享同一配置根目录,但 `Scert-admin` 不得绕过本地受保护通道直接授予普通管理员超级权限。
|
||||
- 停止、升级和卸载不得删除用户证书、数据库和备份。
|
||||
|
||||
### 17.5 公网 IP 证书规则
|
||||
|
||||
- 有域名时支持单域名、泛域名和 SAN。
|
||||
- 只有公网 IP 时按单 IP 标识申请;不支持泛 IP 证书。
|
||||
- IPv4 和 IPv6 证书能力需分别完成 CA、`lego` 和目标系统验证后开放。
|
||||
- 在 IP 证书能力未验证前,初始化向导必须给出明确失败原因,不得伪造申请成功。
|
||||
@@ -914,3 +914,77 @@ imported 外部导入
|
||||
- `[!]` 暂缓或存在阻塞
|
||||
|
||||
需求确认后,已填写并整理的条目标记为 `[x]`,等待复审;复审通过后标记为 `[✓]`;暂缓、阻塞或仍需确认的条目标记为 `[!]`。开发任务清单中的任务在实际开发过程中按状态更新。
|
||||
|
||||
## 二十九、本轮安装部署流程补充(2026-08-26)
|
||||
|
||||
本节为本轮新增确认内容。为便于逐点对照,每一条用户需求后紧跟实现说明和当前状态;不删除前文既有需求。
|
||||
|
||||
### 29.1 命令行系统安装流程
|
||||
|
||||
1. **用户补充:**安装 Scert 本体时,同时安装并打包 `Scert-admin`;`Scert-admin` 用于超级管理员密码重置。
|
||||
- **实现说明:**安装产物必须同时包含 `scert` 和 `scert-admin` 两个可执行文件;两个程序共享配置和数据,但作为独立服务运行。
|
||||
- **状态:**`[x]` 已完成基础服务入口,安装器和服务注册尚未完成。
|
||||
|
||||
2. **用户补充:**命令行安装启动时,只进行初始化配置:超级管理员用户名、密码、第三方邮箱、项目端口(主程序端口和密码重置端口)。
|
||||
- **实现说明:**`scert init` 使用交互式向导保存上述字段;初始化完成后日常管理转由 Web 页面,CLI 保留非交互式状态和自动化能力。
|
||||
- **状态:**`[x]` 已完成配置模型和交互式基础流程,第三方邮箱真实适配尚未完成。
|
||||
|
||||
3. **用户补充:**配置 DNS API 并进行验证测试。
|
||||
- **实现说明:**初始化配置必须记录 DNS 服务商、凭据引用和验证状态;验证未通过时不得将 `setup_ready` 标记为完成。明文密钥应进入加密凭据存储,不直接写入普通配置文件。
|
||||
- **状态:**`[x]` 已完成状态门禁;真实 provider 连通性测试为后续任务。
|
||||
|
||||
4. **用户补充:**配置 SSL 证书部署位置,默认使用 `/ssl/{域名}`,用户可以自定义。
|
||||
- **实现说明:**配置模型保存证书根目录,证书任务根据域名和证书类型生成子目录;默认 Linux 根目录为 `/ssl`,Windows 默认根目录为安装目录下的 `Scert\ssl`。
|
||||
- **状态:**`[x]` 已完成根目录配置基础能力;证书类型子目录和版本化落盘待证书模块实现。
|
||||
|
||||
5. **用户补充:**提示用户配置 Web 页面域名;没有域名时允许使用公网 IP。
|
||||
- **实现说明:**Web 初始化目标只能二选一:域名或公网 IP。域名支持单域名、泛域名或 SAN;公网 IP 只按单 IP 标识处理,不支持把 IP 当作泛域名。
|
||||
- **状态:**`[x]` 已完成配置校验基础能力;IP ACME 证书能力需单独验证后实现。
|
||||
|
||||
6. **用户补充:**DNS API 配置完成且测试通过后再申请证书。
|
||||
- **实现说明:**初始化状态机顺序固定为:配置凭据 → DNS API 验证 → 申请 Web 证书 → 部署和校验 → 开放服务端口 → 标记初始化完成。
|
||||
- **状态:**`[x]` 已写入流程约束;真实申请、部署和校验尚未完成。
|
||||
|
||||
7. **用户补充:**SSL 申请成功后开放用户指定端口,并提示用户在安全组放行自定义端口。
|
||||
- **实现说明:**初始化程序自动检查并放行 Scert 主服务 TCP 端口。Windows 10/11 使用 Windows Defender 防火墙,Linux 支持已启用的 UFW 和 firewalld;规则名称固定、可追踪并支持重复执行。`Scert-admin` 只监听本机,不创建公网或局域网入站规则。云厂商安全组不作为跨厂商自动修改对象,初始化完成后仍明确提示用户手动放行主服务端口。
|
||||
- **失败处理:**本机防火墙权限不足、命令执行失败或规则创建失败时,初始化必须返回中文错误,不得静默标记成功;如果配置保存失败,只回滚本次初始化新建的规则,不删除初始化前已经存在的规则。防火墙未启用时返回“无需创建规则”的明确状态,不主动启用系统防火墙。
|
||||
- **状态:**`[x]` 已完成核心适配层、Web/CLI 初始化接入和自动回滚;Windows 10/11、Ubuntu 22.04/24.04、CentOS/Rocky Linux 实机安装流程仍需随安装器复审。
|
||||
|
||||
### 29.2 图形系统安装流程
|
||||
|
||||
1. **用户补充:**图形安装包点击安装时,同时安装 Scert 本体和 `Scert-admin`。
|
||||
- **实现说明:**Windows 桌面安装包必须将两个可执行文件、配置模板、服务注册组件和卸载组件作为一个安装产物交付。
|
||||
- **状态:**`[ ]` 安装包尚未实现。
|
||||
|
||||
2. **用户补充:**安装完成后第一次启动时,显示与 CLI 等价的超级管理员配置向导。
|
||||
- **实现说明:**Wails 桌面端复用同一套初始化服务和校验规则,不复制业务逻辑;向导完成后可启动核心服务。`Scert-admin` 不随桌面端或系统自动启动,只有用户明确进入超级管理员密码重置流程时,才允许通过受控本地方式启动,并在操作结束后停止。
|
||||
- **状态:**`[ ]` Wails 向导尚未实现。
|
||||
|
||||
3. **用户补充:**桌面端增加“是否开启 Web 页面”按钮。
|
||||
- **实现说明:**`web.enabled` 是持久化配置,关闭时桌面端仍可运行本地控制能力,但不启动 Web 管理监听;重新开启必须记录审计日志并重新检查端口和证书状态。
|
||||
- **状态:**`[x]` 已完成配置字段和 CLI 参数;桌面端按钮尚未实现。
|
||||
|
||||
### 29.3 双服务和安全边界
|
||||
|
||||
1. **用户补充:**Scert 与 `Scert-admin` 同包交付。
|
||||
- **实现说明:**`Scert` 负责证书管理、Web API 和任务调度;`Scert-admin` 只负责超级管理员密码重置相关受保护入口,使用独立端口。
|
||||
- **状态:**`[x]` 已完成独立 Go 入口和独立端口配置。
|
||||
|
||||
2. **实现约束:**`Scert-admin` 默认只监听 `127.0.0.1`,不自动暴露公网。
|
||||
- **说明:**远程密码重置、一次性恢复令牌、Windows 本地 IPC 和 Linux Unix Domain Socket 需要在安全协议冻结后实现。
|
||||
- **状态:**`[x]` 已完成默认回环监听限制;完整密码重置协议尚未实现。
|
||||
|
||||
3. **用户补充:**Linux 上的 `Scert-admin` 不允许开机自启动,只能通过 `systemctl start Scert-admin` 和 `systemctl stop Scert-admin` 进行日常启停控制,其他控制命令不作为支持入口。
|
||||
- **实现说明:**`Scert-admin.service` 不提供 `[Install]` 段,不配置自动重启和 `ExecReload`;安装器不得执行 `systemctl enable`、`systemctl start` 或 `systemctl restart Scert-admin`。安装或升级阶段仅允许为加载新 unit 执行一次 `systemctl daemon-reload`,日常运维文档只提供 `start` 和 `stop`。
|
||||
- **安全边界:**systemd 无法阻止 root 或等效权限操作者调用其他管理命令,因此同时依靠回环监听、无公网防火墙规则、`Restart=no` 和 `Scert` 运行用户降低暴露面;不能宣称对 root 的所有 systemd 命令具有绝对阻断能力。
|
||||
- **状态:**`[x]` 已新增 systemd 单元和服务管理说明,安装器及 Linux 实机复审仍待完成。
|
||||
|
||||
### 29.4 本轮暂不视为完成
|
||||
|
||||
- `[!]` 真实 `go-acme/lego` 申请和 Web 证书部署。
|
||||
- `[!]` DNS API provider 的凭据加密存储和在线验证。
|
||||
- `[!]` Windows/Linux 安装器、Windows Service、Linux systemd 注册;本轮已完成 `Scert-admin` 手动启停单元草案,尚未完成安装器注册和 Linux 实机复审。
|
||||
- `[!]` Scert-admin 的完整密码重置协议和审计。
|
||||
- `[x]` 本机防火墙自动配置已完成代码和自动化测试;安装器提权与各目标系统实机复审待完成。
|
||||
- `[!]` 云安全组自动配置不纳入当前自动修改范围,继续由初始化界面提示用户手动放行。
|
||||
- `[!]` 公网 IP 证书在目标 CA 和 `lego` 版本上的兼容性验证。
|
||||
+455
-44
@@ -476,33 +476,33 @@ Ctrl+C 可以优雅退出
|
||||
|
||||
### 11.1 域名管理
|
||||
|
||||
- [ ] 添加域名。
|
||||
- [ ] 编辑域名。
|
||||
- [ ] 删除域名。
|
||||
- [ ] 启用或禁用自动续期。
|
||||
- [ ] 配置生产或开发环境。
|
||||
- [ ] 配置单域名证书。
|
||||
- [ ] 配置泛域名证书。
|
||||
- [ ] 配置 SAN 证书。
|
||||
- [x] 添加域名。
|
||||
- [x] 编辑域名。
|
||||
- [x] 删除域名。
|
||||
- [x] 启用或禁用自动续期。
|
||||
- [x] 配置生产或开发环境。
|
||||
- [x] 配置单域名证书。
|
||||
- [x] 配置泛域名证书。
|
||||
- [x] 配置 SAN 证书。
|
||||
- [ ] 配置关联服务器。
|
||||
- [ ] 配置 DNS Provider。
|
||||
- [ ] 配置 CNAME 委派。
|
||||
- [ ] 校验 FQDN。
|
||||
- [ ] 检查域名重复。
|
||||
- [ ] 检查泛域名格式。
|
||||
- [ ] 检查 SAN 域名集合。
|
||||
- [x] 保存 DNS Provider 标识,为后续 Provider 接入预留。
|
||||
- [ ] 配置 CNAME 委派详细参数。
|
||||
- [x] 校验 FQDN。
|
||||
- [x] 检查域名重复。
|
||||
- [x] 检查泛域名格式。
|
||||
- [x] 检查 SAN 域名集合。
|
||||
|
||||
### 11.2 SAN 管理
|
||||
|
||||
- [ ] 定义主域名。
|
||||
- [ ] 定义 SAN 域名集合。
|
||||
- [x] 定义主域名。
|
||||
- [x] 定义 SAN 域名集合。
|
||||
- [ ] 保存 SAN 集合快照。
|
||||
- [ ] 生成证书标识。
|
||||
- [ ] SAN 集合变化时生成新的证书标识。
|
||||
- [ ] 不覆盖旧 SAN 证书。
|
||||
- [ ] SAN 域名去重。
|
||||
- [ ] SAN 域名合法性校验。
|
||||
- [ ] 申请前展示 SAN 集合预览。
|
||||
- [x] SAN 域名去重。
|
||||
- [x] SAN 域名合法性校验。
|
||||
- [x] 申请前展示 SAN 集合预览。
|
||||
- [ ] 保存 SAN 部署明细。
|
||||
|
||||
### 11.3 证书文件管理
|
||||
@@ -802,9 +802,9 @@ partial_success
|
||||
### 17.2 管理页面
|
||||
|
||||
- [ ] 登录页面。
|
||||
- [ ] 首页仪表盘。
|
||||
- [ ] 域名列表页面。
|
||||
- [ ] 添加和编辑域名页面。
|
||||
- [x] 首页仪表盘。
|
||||
- [x] 域名列表页面。
|
||||
- [x] 添加和编辑域名页面。
|
||||
- [ ] 证书详情页面。
|
||||
- [ ] SAN 域名管理页面。
|
||||
- [ ] DNS Provider 配置页面。
|
||||
@@ -823,15 +823,15 @@ partial_success
|
||||
|
||||
### 17.3 页面验收
|
||||
|
||||
- [ ] 使用中文界面。
|
||||
- [ ] 适配桌面浏览器。
|
||||
- [x] 使用中文界面。
|
||||
- [x] 适配桌面浏览器。
|
||||
- [ ] 适配低高度窗口。
|
||||
- [ ] 适配移动视口基础布局。
|
||||
- [ ] 无严重横向溢出。
|
||||
- [ ] 错误提示清晰。
|
||||
- [ ] 危险操作二次确认。
|
||||
- [x] 适配移动视口基础布局。
|
||||
- [x] 无严重横向溢出。
|
||||
- [x] 错误提示清晰。
|
||||
- [x] 危险操作二次确认。
|
||||
- [ ] 敏感字段默认隐藏。
|
||||
- [ ] 任务状态可刷新。
|
||||
- [x] 任务状态可刷新。
|
||||
|
||||
---
|
||||
|
||||
@@ -853,10 +853,10 @@ partial_success
|
||||
|
||||
### 18.2 域名和证书命令
|
||||
|
||||
- [ ] `scert domain add`。
|
||||
- [x] `scert domain add`。
|
||||
- [ ] `scert domain edit`。
|
||||
- [ ] `scert domain delete`。
|
||||
- [ ] `scert domain list`。
|
||||
- [x] `scert domain delete`。
|
||||
- [x] `scert domain list`。
|
||||
- [ ] `scert domain show`。
|
||||
- [ ] `scert certificate list`。
|
||||
- [ ] `scert certificate show`。
|
||||
@@ -906,17 +906,18 @@ partial_success
|
||||
|
||||
### 20.1 Linux
|
||||
|
||||
- [ ] 创建 `Scert` 服务运行用户。
|
||||
- [ ] 创建 `/scert`。
|
||||
- [ ] 创建 `/scert/conf`。
|
||||
- [ ] 创建 `/scert/log`。
|
||||
- [ ] 创建 `/scert/backups`。
|
||||
- [ ] 创建 `/ssl`。
|
||||
- [ ] 设置证书目录所有权。
|
||||
- [ ] 设置私钥文件权限。
|
||||
- [ ] 配置 `Scert` 与 `root` 共同受控管理私钥。
|
||||
- [ ] 创建 systemd 服务文件。
|
||||
- [ ] 配置自动启动、停止、重启。
|
||||
- [x] Linux 安装器创建 `Scert` 服务运行用户和同名用户组,并使用 `nologin` 禁止交互式登录。
|
||||
- [x] 创建 `/scert`。
|
||||
- [x] 创建 `/scert/conf`。
|
||||
- [x] 创建 `/scert/data`。
|
||||
- [x] 创建 `/scert/log`。
|
||||
- [x] 创建 `/scert/backups`。
|
||||
- [x] 创建默认 `/ssl`,并允许安装时指定其他安全绝对路径作为证书根目录。
|
||||
- [x] 设置证书根目录所有权,由 `Scert` 服务用户和 root 管理。
|
||||
- [~] 配置目录及现有敏感配置文件权限已收紧;真实 ACME 私钥文件 `0600` 仍需在证书申请模块和 Linux 实机中复审。
|
||||
- [~] 已建立 `Scert` 用户与 root 的目录管理边界;证书上传、历史版本和部署文件的最终属主策略待证书模块复审。
|
||||
- [x] 创建 `Scert.service` 和 `Scert-admin.service`。
|
||||
- [x] 核心服务保留独立启停和开机启动能力;`Scert-admin` 不注册开机启动、不自动重启、不提供 reload,日常只提供 start 和 stop。
|
||||
- [ ] Ubuntu 22.04 systemd 基线测试。
|
||||
- [ ] Ubuntu 24.04 测试。
|
||||
- [ ] Debian 测试。
|
||||
@@ -1273,4 +1274,414 @@ Linux amd64 可以交叉编译
|
||||
| Git 提交 | `[ ]` 未开始 |
|
||||
| Git 推送 | `[ ]` 未开始 |
|
||||
|
||||
当前代码可以继续进入下一阶段开发,但不能宣称 MySQL 5.7/8.0 真实实例兼容性、HTTPS 双模式或完整证书生命周期已经验收通过。
|
||||
当前代码可以继续进入下一阶段开发,但不能宣称 MySQL 5.7/8.0 真实实例兼容性、HTTPS 双模式或完整证书生命周期已经验收通过。
|
||||
|
||||
---
|
||||
|
||||
## 二十八、本轮继续开发记录
|
||||
|
||||
### 28.1 实现内容
|
||||
|
||||
- [x] CLI 新增 `scert domain edit` 命令,支持修改域名、证书类型、SAN、自动续期、ACME 环境和 DNS 服务商标识。
|
||||
- [x] CLI 编辑域名时保留原域名 ID 和创建时间,并将证书状态恢复为等待申请,避免配置变化后继续使用旧证书状态。
|
||||
- [x] CLI 域名帮助内容覆盖新增的编辑命令。
|
||||
|
||||
### 28.2 浏览器复审结果
|
||||
|
||||
- [x] 桌面视口验证域名列表、添加域名、编辑域名和删除入口。
|
||||
- [x] SAN 表单验证主域名、附加域名、测试/生产环境和 DNS 服务商选项。
|
||||
- [x] 添加重复域名时,页面显示“域名已经存在”,未泄露底层数据库错误。
|
||||
- [x] 编辑表单正确回显 SAN 域名、ACME 环境、自动续期和 DNS 服务商配置。
|
||||
- [x] 窄屏视口验证域名卡片布局和页面无横向溢出。
|
||||
- [x] 低高度视口验证弹窗限制在可视区域内,并可通过弹窗内部滚动查看完整表单。
|
||||
|
||||
### 28.3 本轮质量检查
|
||||
|
||||
- [x] `gofmt -l .` 检查通过。
|
||||
- [x] `go test ./...` 通过。
|
||||
- [x] `go test -race ./...` 通过。
|
||||
- [x] `go vet ./...` 通过。
|
||||
- [x] `npm.cmd run build` 通过。
|
||||
- [x] CLI 实测完成域名编辑并验证持久化结果。
|
||||
|
||||
### 28.4 当前边界
|
||||
|
||||
- [ ] `go-acme/lego` 实际证书申请和 DNS-01 Provider 尚未实现。
|
||||
- [ ] 自动续期调度、证书版本、远程服务器部署、部署后校验和通知尚未实现。
|
||||
- [ ] 管理员登录认证、Wails 桌面封装、Windows Service 和 Linux systemd 尚未实现。
|
||||
- [!] MySQL 5.7/8.0 真实实例兼容性仍需要明确 DSN、端口、账号和密码后验证。
|
||||
|
||||
## 二十九、本轮安装部署开发记录(2026-08-26)
|
||||
|
||||
### 29.1 已完成,等待复审
|
||||
|
||||
- [x] 扩展配置模型:超级管理员、密码重置服务地址和端口、Web 域名/IP、Web 开关、DNS 验证状态、TLS 文件路径。
|
||||
- [x] 增加配置兼容归一化,旧配置缺少新增字段时补充安全默认值。
|
||||
- [x] 增加初始化服务 `internal/setup`,校验管理员密码长度、双端口冲突、DNS 验证状态、Web 域名/IP互斥和公网 IP 格式。
|
||||
- [x] 初始化时只保存管理员 bcrypt 摘要,不保存管理员明文密码。
|
||||
- [x] `scert init` 支持交互式填写双端口、第三方邮箱、DNS 凭据引用、证书根目录、Web 域名/IP和 Web 开关。
|
||||
- [x] 新增 `scert-admin` 可执行入口和本机回环监听的受保护服务占位接口。
|
||||
- [x] 为初始化服务补充未通过 DNS、成功配置、域名/IP冲突测试。
|
||||
- [x] 新增 Web 初始化状态和提交接口,未初始化时只允许本机访问,并限制请求体最大为 64 KiB。
|
||||
- [x] Web 初始化接口接入统一初始化服务,保存到实际配置文件路径,并禁止重复初始化。
|
||||
- [x] 未初始化状态下执行 `scert serve` 时强制仅监听 `127.0.0.1`,初始化完成后需要重启服务应用新端口。
|
||||
- [x] 新增中文 Web 初始化向导,覆盖超级管理员、双端口、第三方邮件服务、DNS 凭据引用、证书目录、Web 域名/公网 IP、HTTPS 模式和 Web 页面开关。
|
||||
- [x] 初始化向导明确标注真实 DNS 在线测试、`go-acme/lego` 证书申请和 HTTPS 切换尚未接入,避免误报证书签发成功。
|
||||
- [x] 初始化配置保存成功后自动进入现有域名管理页面。
|
||||
- [x] Vite 开发服务器支持通过环境变量设置开发端口和后端 API 地址,便于多实例预览和联调。
|
||||
|
||||
### 29.2 尚未完成
|
||||
|
||||
- [ ] 集成真实 `go-acme/lego` Web 证书申请、DNS provider 验证和证书部署。
|
||||
- [ ] 实现 Web 证书本地校验、HTTPS 启动和初始化完成后的 HTTP 关闭。
|
||||
- [ ] 实现 `Scert-admin` 一次性密码重置令牌、审计日志和 Windows/Linux 本地安全通道。
|
||||
- [ ] 实现 Windows Service、Linux systemd 以及同时安装两个服务的安装器。
|
||||
- [ ] 实现 Wails 首次启动向导和“是否开启 Web 页面”按钮。
|
||||
- [ ] 完成公网 IP 证书的 CA、`lego` 和跨平台实测。
|
||||
- [ ] 实现本机防火墙适配和云安全组提示界面。
|
||||
|
||||
### 29.3 本轮验证
|
||||
|
||||
- [✓] `gofmt -w` 通过。
|
||||
- [✓] `go test ./...` 通过。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] `npm.cmd run build` 通过。
|
||||
- [✓] Web 初始化接口本机状态读取、初始化提交、配置持久化、明文密码不落盘、重复初始化和超大请求测试通过。
|
||||
- [✓] 浏览器实测初始化状态读取、表单提交、配置保存和初始化后进入域名管理页面通过。
|
||||
- [✓] 浏览器在 1440×900、1280×720 和移动端 501×845 视口下无横向溢出。
|
||||
|
||||
### 29.4 复审边界
|
||||
|
||||
- [✓] Web 初始化接口与初始化向导基础流程复审通过。
|
||||
- [✓] 初始化阶段本机访问限制、配置持久化和管理员密码摘要存储复审通过。
|
||||
- [!] DNS 验证勾选项当前只接收外部验证结果,不能替代真实 DNS Provider 在线测试。
|
||||
- [!] 初始化完成响应不代表证书已经签发,也不代表 HTTPS 已经启用。
|
||||
- [!] Scert-admin 当前仍是本机 HTTP 服务占位入口,密码重置安全通道尚未完成。
|
||||
|
||||
---
|
||||
|
||||
## 三十、DNS 在线验证与加密凭据开发记录(2026-08-26)
|
||||
|
||||
### 30.1 已完成,等待复审
|
||||
|
||||
- [x] 新增 DNS Provider 目录接口,统一返回 Cloudflare、阿里云 DNS、DNSPod、CNAME 委派、华为云、腾讯云、AWS Route 53、Google Cloud DNS 和其他服务商的字段模型与可用状态。
|
||||
- [x] 基于 `go-acme/lego` 接入 Cloudflare DNS Provider,在线测试会创建并清理临时 DNS-01 TXT 记录。
|
||||
- [x] 增加 DNS 凭据字段白名单、必填校验和测试域名格式校验。
|
||||
- [x] 新增 AES-GCM 敏感信息存储,DNS 明文凭据不写入普通配置文件,主密钥和密文文件使用受限权限。
|
||||
- [x] 新增 15 分钟有效的 DNS 验证令牌,绑定服务商、测试域名和凭据引用。
|
||||
- [x] 初始化流程调整为先检查令牌、校验并保存配置,配置保存成功后再消费一次性令牌。
|
||||
- [x] Web 初始化向导动态读取 Provider 目录并生成普通、密码和 JSON 凭据字段。
|
||||
- [x] Web 初始化向导增加 DNS 权限测试域名和“测试 DNS API”操作,提交时使用后端签发的凭据引用与验证令牌。
|
||||
- [x] Provider、凭据或测试域名变化时自动清除旧验证状态,并定时检查验证结果是否过期。
|
||||
- [x] 所有 Provider 均可在下拉列表中选择并查看字段;未开放适配器明确标识状态并禁止执行在线测试。
|
||||
- [x] 初始化表单控件补充稳定的 `id` 和 `name`,动态 DNS 字段使用唯一标识。
|
||||
- [x] 调整辅助文字颜色对比度,提升初始化页面可访问性。
|
||||
|
||||
### 30.2 安全测试与复审结果
|
||||
|
||||
- [✓] DNS 验证令牌执行 `Check` 时不消费,执行 `Consume` 后不能再次使用。
|
||||
- [✓] 管理员、端口等初始化表单校验失败时不消费 DNS 验证令牌。
|
||||
- [✓] 配置文件保存失败时不消费 DNS 验证令牌。
|
||||
- [✓] DNS 测试接口拒绝非本机请求,并限制请求体最大为 64 KiB。
|
||||
- [✓] 未开放 Provider 返回 HTTP 501,不伪报在线验证成功。
|
||||
- [✓] Provider 错误响应和 DNS 测试响应均不返回用户提交的明文凭据。
|
||||
- [✓] 501×845 移动视口使用 AWS Route 53 五字段表单复审,无横向溢出。
|
||||
- [✓] 1440×900 桌面视口使用 Cloudflare 表单复审,无横向溢出。
|
||||
- [✓] DNS 下拉列表中的九类服务商及其动态字段模型完成浏览器逐项检查。
|
||||
- [✓] Lighthouse 初始化页面可访问性评分为 100,最佳实践评分为 100。
|
||||
- [✓] `gofmt -l .`、`go test ./...`、`go test -race ./...`、`go vet ./...`、`npm.cmd run build` 和 `git diff --check` 全部通过。
|
||||
- [✓] 57 个文本源码和文档文件通过 UTF-8 无 BOM、无 Unicode 替换字符和无连续乱码问号检查。
|
||||
|
||||
### 30.3 当前边界和后续任务
|
||||
|
||||
- [ ] 接入阿里云 DNS、DNSPod/腾讯云、华为云、AWS Route 53 和 Google Cloud DNS 在线适配器。
|
||||
- [ ] 完成 CNAME 委派的目标 Provider 组合验证流程。
|
||||
- [ ] 将 CLI `scert init` 从“凭据引用加手动确认”升级为真实 DNS 在线验证流程。
|
||||
- [ ] 集成 `go-acme/lego` 真实证书签发、续期和初始化管理后台证书部署。
|
||||
- [ ] 实现 HTTPS 双模式实际启动和初始化完成后的安全切换。
|
||||
- [ ] 将敏感信息密文文件保存升级为安全原子替换,并补充异常中断恢复测试。
|
||||
- [ ] 清理过期、重复测试或放弃初始化所产生的未引用 DNS 凭据。
|
||||
- [ ] 完成 Scert-admin 受保护的本地密码重置通道、安装器和系统服务。
|
||||
- [!] MySQL 5.7/8.0 真实实例测试仍等待明确的 DSN、端口、账号和密码;不得通过 PATH 自动判断 MySQL 实例。
|
||||
---
|
||||
|
||||
## 三十一、敏感信息文件原子写入复审记录(2026-08-26)
|
||||
|
||||
### 31.1 已完成,等待复审
|
||||
|
||||
- [x] `secrets.json` 改为在目标目录创建唯一临时文件,不再直接覆盖正式密文文件。
|
||||
- [x] 临时文件在替换前完成 `0600` 权限设置、内容写入、文件同步和关闭。
|
||||
- [x] 使用同目录重命名替换正式文件,Linux 下额外同步所在目录。
|
||||
- [x] 原子替换失败时保留原密文文件,并自动清理未提交的临时文件。
|
||||
- [x] 原子写入完成后继续收紧正式密文文件权限。
|
||||
|
||||
### 31.2 测试与复审结果
|
||||
|
||||
- [✓] Windows amd64 上首次写入和覆盖已有 `secrets.json` 测试通过。
|
||||
- [✓] 模拟替换失败时,旧密文文件内容保持不变。
|
||||
- [✓] 成功与失败路径均不残留 `.secrets.json.tmp-*` 临时文件。
|
||||
- [✓] 非 Windows 平台的 `0600` 权限断言已经加入测试。
|
||||
- [✓] `go test ./internal/secretstore -count=1 -v` 通过。
|
||||
- [✓] `gofmt -l .`、`go test ./...`、`go test -race ./...` 和 `go vet ./...` 通过。
|
||||
- [✓] Linux amd64、`CGO_ENABLED=0` 全量 Go 构建通过。
|
||||
- [✓] `npm.cmd run build` 通过。
|
||||
|
||||
### 31.3 后续边界
|
||||
|
||||
- [ ] 为敏感信息存储增加删除接口,并清理过期、重复测试或放弃初始化产生的未引用凭据。
|
||||
- [ ] 在 Ubuntu 22.04 实机复审目录同步和 `0600` 权限。
|
||||
- [ ] Windows 安装阶段需要使用 ACL 将主密钥和密文文件限制为 Scert 服务账号、管理员和 SYSTEM 可访问。
|
||||
|
||||
---
|
||||
|
||||
## 三十二、初始化本机防火墙自动放行开发记录(2026-08-26)
|
||||
|
||||
### 32.1 需求清单
|
||||
|
||||
- [x] 初始化时自动检查并放行 Scert 主服务 TCP 端口。
|
||||
- [x] `Scert-admin` 继续只监听本机,不创建公网或局域网入站规则。
|
||||
- [x] Windows 10/11 支持 Windows Defender 防火墙规则。
|
||||
- [x] Ubuntu 支持已启用的 UFW,CentOS/Rocky Linux 支持已启用的 firewalld。
|
||||
- [x] 防火墙未启用时不主动启用,并返回明确的“无需创建规则”状态。
|
||||
- [x] 权限不足或规则创建失败时阻止初始化静默成功。
|
||||
- [x] 云安全组不自动修改,初始化完成后继续提示用户手动放行主服务端口。
|
||||
|
||||
### 32.2 开发任务状态
|
||||
|
||||
- [x] 新增 `internal/firewall` 适配层和可注入命令执行器。
|
||||
- [x] 所有端口先校验为 `1-65535`,系统命令通过参数数组执行,不拼接用户输入。
|
||||
- [x] Windows 规则使用固定名称 `Scert Web TCP {端口}`,支持状态检查、存在检查、创建和回滚。
|
||||
- [x] UFW 支持启用状态检查、已有规则识别、创建和本次规则回滚。
|
||||
- [x] firewalld 支持运行状态检查、永久规则查询、创建、重新加载和失败清理。
|
||||
- [x] Web 初始化接入本机防火墙事务,并在响应中返回后端、规则名称、端口、是否新建和中文状态。
|
||||
- [x] CLI 初始化复用同一防火墙管理接口,并输出本机防火墙结果和云安全组提示。
|
||||
- [x] 配置保存失败时只回滚本次初始化新创建的规则,保留原本已存在的规则。
|
||||
- [x] 初始化界面明确显示“本机防火墙自动配置、云安全组仍需手动放行”。
|
||||
|
||||
### 32.3 自动化测试状态
|
||||
|
||||
- [x] 无效端口在执行系统命令前被拒绝。
|
||||
- [x] Windows 防火墙未启用时不创建规则。
|
||||
- [x] Windows、UFW 和 firewalld 创建命令均验证为独立参数调用。
|
||||
- [x] 已存在的 UFW 规则不会重复创建。
|
||||
- [x] firewalld 重新加载失败时清理本次新增的永久规则。
|
||||
- [x] firewalld 权限错误不会被误报为“防火墙未启用”。
|
||||
- [x] Web 初始化只开放主服务端口,不开放密码重置端口。
|
||||
- [x] Web/CLI 配置保存失败时回滚本次新建规则。
|
||||
- [x] 配置保存失败时保留初始化前已存在的防火墙规则。
|
||||
- [x] 防火墙创建失败时不保存初始化配置,也不消费 DNS 验证令牌。
|
||||
|
||||
### 32.4 等待复审
|
||||
|
||||
- [x] 代码格式化、单元测试、竞态检查、静态检查和跨平台构建等待本轮统一执行。
|
||||
- [!] Windows 10/11、Ubuntu 22.04/24.04 和 CentOS/Rocky Linux 实机规则创建需要在安装器提供提权运行方式后复审。
|
||||
- [!] 云安全组属于云厂商外部资源,本阶段不自动修改。
|
||||
|
||||
## 三十三、Scert Logo 与浏览器图标接入开发记录(2026-08-26)
|
||||
|
||||
### 33.1 需求清单
|
||||
|
||||
- [x] 使用 `frontend/logo/Scert.png` 作为 Web 管理界面 Logo。
|
||||
- [x] 使用 `frontend/logo/Scert.png` 作为浏览器标签页图标。
|
||||
- [x] Logo 使用透明背景,避免在不同页面背景上出现白色方块。
|
||||
- [x] 初始化检查页、管理首页和首次配置页统一使用同一品牌资源。
|
||||
|
||||
### 33.2 开发任务状态
|
||||
|
||||
- [x] 将原有字母占位 Logo 替换为 `Scert.png` 图片组件。
|
||||
- [x] 将 `index.html` 中的内嵌 SVG favicon 替换为 PNG favicon。
|
||||
- [x] 配置 Vite `publicDir`,使 favicon 通过 `/Scert.png` 提供。
|
||||
- [x] 为透明 Logo 增加 `object-fit: contain` 和阴影样式,保留原图比例。
|
||||
- [x] 增加移动端 Logo 尺寸适配,避免初始化页布局溢出。
|
||||
|
||||
### 33.3 验证状态
|
||||
|
||||
- [x] `npm.cmd run build` 前端生产构建通过。
|
||||
- [x] `git diff --check` 未发现空白错误。
|
||||
- [x] 浏览器实测 favicon 地址为 `/Scert.png`,图片加载尺寸为 `1254×1254`。
|
||||
- [x] 浏览器 Canvas 检测图片四角 Alpha 为 `0`、中心 Alpha 为 `255`,确认透明背景有效。
|
||||
|
||||
### 33.4 等待复审
|
||||
|
||||
- [x] Logo 与浏览器图标接入完成,等待用户复审视觉效果。
|
||||
|
||||
## 三十四、Scert-admin systemd 手动启停边界开发记录(2026-08-26)
|
||||
|
||||
### 34.1 需求清单
|
||||
|
||||
- [x] `Scert-admin` 不允许开机自启动。
|
||||
- [x] 日常支持的启停命令仅为 `systemctl start Scert-admin` 和 `systemctl stop Scert-admin`。
|
||||
- [x] `Scert-admin` 不配置自动重启,不提供 `ExecReload`,不创建公网防火墙规则。
|
||||
- [x] `Scert-admin` 继续使用 `Scert` 用户运行,并由程序层强制只监听本机回环地址。
|
||||
- [x] 安装或升级阶段允许使用一次 `systemctl daemon-reload` 加载新 unit,但不得因此启动或启用 `Scert-admin`。
|
||||
|
||||
### 34.2 开发任务状态
|
||||
|
||||
- [x] 新增 `deploy/systemd/Scert-admin.service`,不包含 `[Install]` 和 `WantedBy=`,因此不会通过 `systemctl enable` 注册开机启动。
|
||||
- [x] 新增 `deploy/systemd/Scert.service`,保留核心服务独立的 systemd 服务定义。
|
||||
- [x] 新增 `deploy/systemd/Scert-admin服务管理说明.md`,明确安装阶段和日常运维阶段的命令边界。
|
||||
- [x] 增加自动化检查,验证 `Scert-admin.service` 使用 `Scert` 用户、`Restart=no`,且没有自动启动目标、自动重启和 reload 配置。
|
||||
- [x] 增加非回环监听拒绝测试,防止 `Scert-admin` 被配置为公网或局域网监听。
|
||||
|
||||
### 34.3 安全边界与未完成项
|
||||
|
||||
- [x] 未使用 `systemctl mask`、`RefuseManualStart` 或 `RefuseManualStop`,避免阻断用户明确要求的 `start` 和 `stop`。
|
||||
- [x] 已明确 systemd 无法阻止 root 或等效权限操作者调用 `status`、`restart`、`kill` 等底层管理命令;本轮实现的是“不支持、不自动执行、不对外暴露”,不是虚假的绝对权限隔离。
|
||||
- [x] Linux 安装器基础流程已完成,覆盖 unit 文件复制、`Scert` 用户创建、目录授权、自定义证书根目录和一次性 `daemon-reload`,等待 Linux 实机复审。
|
||||
- [!] Ubuntu 22.04、Ubuntu 24.04、CentOS/Rocky Linux 和 Debian 实机安装与启停复审待完成。
|
||||
|
||||
## 三十五、Linux 安装器基础流程开发记录(2026-08-26)
|
||||
|
||||
### 35.1 需求清单
|
||||
|
||||
- [x] 安装包同时安装 `scert` 和 `scert-admin` 两个 Linux amd64 可执行文件。
|
||||
- [x] 创建专用 `Scert` 系统用户和用户组,并禁止交互式登录。
|
||||
- [x] 创建 `/scert`、配置、数据、日志、备份、文档和证书目录,不删除已有用户数据。
|
||||
- [x] 默认使用 `/ssl`,同时允许通过安装参数指定其他安全绝对路径作为证书根目录。
|
||||
- [x] 安装 `Scert.service` 和 `Scert-admin.service`,只执行一次 `systemctl daemon-reload`。
|
||||
- [x] 安装器不得启动、重启或启用 `Scert-admin`,不得为其创建公网防火墙规则。
|
||||
- [x] 修正技术架构和图形初始化流程中“自动启动 Scert-admin”的旧描述。
|
||||
|
||||
### 35.2 开发任务状态
|
||||
|
||||
- [x] 新增 `deploy/install-linux.sh`,支持环境、root 权限、依赖命令和安装产物检查。
|
||||
- [x] 安装器以幂等方式创建服务用户、默认目录、二进制文件、文档和 systemd unit。
|
||||
- [x] 对现有 `scert.json`、`master.key` 和 `secrets.json` 收紧为 `Scert` 用户所有及 `0600` 权限。
|
||||
- [x] 为自定义证书根目录生成 `Scert.service.d/10-certificate-path.conf`,避免 systemd 文件系统保护阻断证书写入。
|
||||
- [x] 修正两个 systemd unit 的 `Documentation` 为安装后的本地文档路径。
|
||||
- [x] 新增 `deploy/README.md` 和 `Scert服务管理说明.md`。
|
||||
- [x] 新增安装器静态策略测试,检查目录、用户、自定义证书路径、单次 daemon-reload、禁止启动 Scert-admin 和禁止直接操作防火墙。
|
||||
|
||||
### 35.3 验证状态
|
||||
|
||||
- [x] `go test ./internal/admin` 通过。
|
||||
- [x] `gofmt -l .`、`go test ./...`、`go test -race ./...` 和 `go vet ./...` 通过。
|
||||
- [x] Windows amd64 的 `scert`、`scert-admin` 构建通过。
|
||||
- [x] Linux amd64、`CGO_ENABLED=0` 的 `scert`、`scert-admin` 交叉构建通过。
|
||||
- [x] `npm.cmd run build` 前端生产构建通过。
|
||||
- [x] `git diff --check` 通过,新增部署文件严格 UTF-8、无 BOM、无替换字符;Shell 和 systemd 文件使用 LF 换行。
|
||||
- [x] 使用 `mvdan.cc/sh/v3/cmd/shfmt@v3.10.0` 对 `install-linux.sh` 执行只读 AST 解析,Bash 语法通过。
|
||||
- [!] 当前 Windows 开发机未安装 WSL 或 Bash,安装器的 Linux 命令行为仍需在目标系统实机执行。
|
||||
- [!] Ubuntu 22.04/24.04、Debian、CentOS/Rocky Linux 的 root 安装、目录属主和 systemd 行为仍需实机复审。
|
||||
|
||||
### 35.4 安全边界
|
||||
|
||||
- [x] 安装器不会自动启动任何服务;核心服务需在初始化、证书部署和校验完成后按运维流程启动。
|
||||
- [x] `Scert-admin` 默认保持停止状态,安装结果只提示 `systemctl start Scert-admin` 和 `systemctl stop Scert-admin`。
|
||||
- [x] systemd 无法阻止 root 调用底层管理命令,本阶段保证的是不自动执行、不注册开机启动、不自动重启和不对外暴露。
|
||||
- [x] 自定义证书目录限制为规范化安全绝对路径,拒绝受保护系统目录、`/scert` 下路径、符号链接和不安全路径片段;`/var` 下仅允许 `/var/lib/scert` 专用路径。
|
||||
|
||||
---
|
||||
|
||||
## 三十六、Linux 安装器复审记录(2026-08-26)
|
||||
|
||||
### 36.1 复审范围
|
||||
|
||||
- [x] 复审 `deploy/install-linux.sh` 的路径校验、符号链接防护、用户创建、目录权限、幂等性和 systemd 操作边界。
|
||||
- [x] 复审 `Scert.service` 与 `Scert-admin.service` 的运行用户、文件系统保护、自动重启、开机启动和监听范围。
|
||||
- [x] 复审安装器与 CLI 初始化默认路径的联动,以及已有配置、数据库、日志和备份目录的权限恢复。
|
||||
- [x] 复审自动化测试、Shell AST 解析、后端测试、竞态测试、静态检查和前端生产构建。
|
||||
- [x] 复审需求确认文档、技术架构文档、部署说明与当前实现的明显矛盾。
|
||||
|
||||
### 36.2 本轮修复
|
||||
|
||||
- [x] 拒绝 `/etc`、`/usr`、`/var` 等受保护系统路径作为证书根目录;`/var` 仅开放 `/var/lib/scert` 专用路径。
|
||||
- [x] 拒绝证书目录和 `/scert`、systemd 文件、已安装二进制及文档路径中的符号链接,避免 root 安装器跟随链接修改非预期位置。
|
||||
- [x] 保持用户确认的 `Scert` 大写运行用户名称;普通创建失败且系统支持 `--badname` 时兼容重试,不支持时明确失败,不降级为其他用户名。
|
||||
- [x] 对 `/scert/conf`、`/scert/data`、`/scert/log` 和 `/scert/backups` 中已有 Scert 管理数据恢复属主,避免历史 root 初始化文件阻断服务运行。
|
||||
- [x] 安装器写入 `/scert/conf/installation.json`,记录规范化证书根目录;Linux CLI 初始化默认值会读取该记录,解决 `--certificate-dir` 与初始化配置脱节问题。
|
||||
- [x] `Scert-admin` 配置和服务层仅接受字面量 `127.0.0.1` 或 `::1`,不再依赖 `localhost` 名称解析。
|
||||
- [x] 保持 `Scert-admin` 不含 `[Install]`、不自动重启、不提供 `ExecReload`,安装器不执行其 `start`、`restart` 或 `enable` 操作。
|
||||
|
||||
### 36.3 自动化验证结果
|
||||
|
||||
- [✓] `go test ./...` 通过。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] `npm.cmd run build` 前端生产构建通过。
|
||||
- [✓] 使用 `mvdan.cc/sh/v3/cmd/shfmt@v3.10.0` 对 `deploy/install-linux.sh` 执行只读 Shell AST 解析通过。
|
||||
- [✓] Windows amd64 和 Linux amd64(`CGO_ENABLED=0`)的 `scert`、`scert-admin` 构建通过。
|
||||
- [✓] `git diff --check` 通过。
|
||||
|
||||
### 36.4 尚未通过的实机验收
|
||||
|
||||
- [!] 当前 Windows 开发机未安装 WSL 或 Bash,无法执行真实 Linux 安装器命令链。
|
||||
- [!] Ubuntu 22.04、Ubuntu 24.04、Debian、CentOS/Rocky Linux 的 root 安装、`Scert` 大写用户创建、目录属主和权限仍需实机验证。
|
||||
- [!] 不同发行版的 `groupadd/useradd --badname` 支持情况仍需实机验证。
|
||||
- [!] systemd unit 注册、`daemon-reload`、核心服务启停、`Scert-admin` 手动启停和回环监听仍需实机验证。
|
||||
- [!] 本机防火墙初始化、云安全组放行、ACME DNS 在线验证、Let’s Encrypt 证书申请、HTTPS 切换和部署后校验不属于本轮安装器复审证据,不能标记为完成。
|
||||
|
||||
### 36.5 复审结论
|
||||
|
||||
当前结论为:**Linux 安装器代码与自动化验证通过,Linux 实机安装部署尚未验收通过;Scert 完整产品仍处于部分完成状态。**
|
||||
|
||||
本轮没有提交 Git、推送远程仓库或删除文件。后续只有在目标 Linux 环境完成安装器、systemd、权限、服务生命周期和防火墙实测后,才可以将平台安装阶段的实机项目标记为 `[✓]`。
|
||||
|
||||
## 三十七、证书申请与自动续期核心开发记录(2026-08-26)
|
||||
|
||||
### 37.1 本轮需求清单
|
||||
|
||||
- [x] 使用 `go-acme/lego` 调用 Let’s Encrypt DNS-01 申请证书。
|
||||
- [x] 支持单域名、泛域名和 SAN 域名列表统一提交申请。
|
||||
- [x] ACME 账户私钥和注册状态通过加密敏感信息存储持久化,并按 staging/production 隔离。
|
||||
- [x] 申请成功后校验证书、私钥匹配关系、证书有效期和全部申请域名覆盖关系。
|
||||
- [x] 证书文件通过原子写入保存,替换前自动备份,申请失败不覆盖旧证书。
|
||||
- [x] 增加 `scert domain issue --id <域名ID>` 手动申请或续期命令。
|
||||
- [x] 主服务启动时执行一次自动续期检查,之后按 24 小时周期检查。
|
||||
|
||||
### 37.2 开发任务状态
|
||||
|
||||
- [x] 增加 ACME 账户存储层,支持生成、读取和保存账户私钥及注册状态。
|
||||
- [x] 增加证书申请服务,串联域名配置、DNS 凭据、Provider、Lego Issuer 和证书文件存储。
|
||||
- [x] 增加证书状态更新接口,记录 `issuing`、`valid` 和 `failed` 状态。
|
||||
- [x] 增加自动续期调度器,支持阈值筛选、初次证书申请和并发执行保护。
|
||||
- [x] 增加 SAN、泛域名、申请失败保留旧证书和账户持久化测试。
|
||||
|
||||
### 37.3 本轮验证结果
|
||||
|
||||
- [✓] `gofmt -w` 通过。
|
||||
- [✓] `go test ./...` 通过。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] Windows amd64 的 `scert` 和 `scert-admin` 构建通过。
|
||||
- [✓] Linux amd64、`CGO_ENABLED=0` 的 `scert` 和 `scert-admin` 构建通过。
|
||||
- [✓] 前端 `npm.cmd run build` 通过。
|
||||
- [✓] `git diff --check` 通过。
|
||||
|
||||
### 37.4 当前边界
|
||||
|
||||
- [!] 本轮未使用真实 DNS 凭据申请 Let’s Encrypt 证书,在线 DNS Provider 和 CA 流程仍需目标环境实机验证。
|
||||
- [!] 当前只接入已有可用的 DNS Provider 工厂;其他 Provider、CNAME 委派、服务器 SSH 部署和部署后 HTTPS 校验尚未完成。
|
||||
- [!] `scert domain issue` 已具备核心调用入口,但管理员认证、操作审计和 Web 端手动申请入口尚未接入。
|
||||
|
||||
## 三十八、自有证书导入核心开发记录(2026-08-27)
|
||||
|
||||
### 38.1 本轮需求清单
|
||||
|
||||
- [x] 允许用户通过 CLI 指定证书、私钥和可选签发者证书文件。
|
||||
- [x] 导入前验证证书和私钥匹配、有效期正常,并覆盖托管域名、泛域名或全部 SAN。
|
||||
- [x] 导入成功后使用统一证书目录、备份和原子写入策略保存文件。
|
||||
- [x] 导入失败时不写入或覆盖托管证书。
|
||||
|
||||
### 38.2 开发任务状态
|
||||
|
||||
- [x] 增加证书导入服务 `certificate.Service.Import`。
|
||||
- [x] 增加 `scert domain import --id <域名ID> --certificate <证书> --private-key <私钥> [--issuer <签发者证书>]` 命令。
|
||||
- [x] 增加 SAN 导入成功和域名不匹配拒绝导入测试。
|
||||
- [x] 增加证书尚未生效和证书过期校验逻辑。
|
||||
|
||||
### 38.3 当前验证状态
|
||||
|
||||
- [✓] `gofmt -w` 通过。
|
||||
- [✓] `go test ./...` 通过。
|
||||
- [✓] `go test -race ./...` 通过。
|
||||
- [✓] `go vet ./...` 通过。
|
||||
- [✓] Windows amd64 和 Linux amd64、`CGO_ENABLED=0` 的双服务构建通过。
|
||||
- [✓] 前端 `npm.cmd run build` 通过。
|
||||
- [✓] `git diff --check` 通过。
|
||||
|
||||
### 38.4 当前边界
|
||||
|
||||
- [!] 本轮仅提供 CLI 导入入口,Web 上传接口和管理页面尚未接入。
|
||||
- [!] 导入完成后自动推送远程服务器、重载 Nginx/Caddy/Apache 和 HTTPS 在线校验尚未实现。
|
||||
Reference in new issue
Block a user