完善证书管理与初始化流程

This commit is contained in:
xuans committed 2026-08-27 22:16:10 +08:00
1 parent 07636abe44
commit c74372284a
84 files changed
+10151 -3502

No files matched your search

+9 -9
View File
@@ -925,8 +925,8 @@ imported 外部导入
- **实现说明:**安装产物必须同时包含 `scert` 和 `scert-admin` 两个可执行文件;两个程序共享配置和数据,但作为独立服务运行。
- **状态:**`[x]` 已完成基础服务入口,安装器和服务注册尚未完成。
2. **用户补充:**命令行安装启动时,只进行初始化配置:超级管理员用户名、密码、第三方邮箱、项目端口(主程序端口和密码重置端口)。
- **实现说明:**`scert init` 使用交互式向导保存上述字段;初始化完成后日常管理转由 Web 页面,CLI 保留非交互式状态和自动化能力。
2. **用户补充:**命令行安装启动时,只进行初始化配置:超级管理员用户名、密码、第三方邮箱和 Scert 主服务端口;密码重置功能不再配置独立端口。
- **实现说明:**`scert init` 使用交互式向导保存上述字段;系统根据 Web 管理域名或公网 IP 与主服务端口自动生成密码重置地址。主端口为 `443` 时地址为 `https://域名或IP/reset`,其他端口为 `https://域名或IP:主端口/reset`。初始化完成后日常管理转由 Web 页面,CLI 保留非交互式状态和自动化能力。
- **状态:**`[x]` 已完成配置模型和交互式基础流程,第三方邮箱真实适配尚未完成。
3. **用户补充:**配置 DNS API 并进行验证测试。
@@ -946,7 +946,7 @@ imported 外部导入
- **状态:**`[x]` 已写入流程约束;真实申请、部署和校验尚未完成。
7. **用户补充:**SSL 申请成功后开放用户指定端口,并提示用户在安全组放行自定义端口。
- **实现说明:**初始化程序自动检查并放行 Scert 主服务 TCP 端口。Windows 10/11 使用 Windows Defender 防火墙,Linux 支持已启用的 UFW 和 firewalld;规则名称固定、可追踪并支持重复执行。`Scert-admin` 只监听本机,不创建公网或局域网入站规则。云厂商安全组不作为跨厂商自动修改对象,初始化完成后仍明确提示用户手动放行主服务端口。
- **实现说明:**初始化程序自动检查并放行 Scert 主服务 TCP 端口。Windows 10/11 使用 Windows Defender 防火墙,Linux 支持已启用的 UFW 和 firewalld;规则名称固定、可追踪并支持重复执行。`Scert-admin` 不监听任何 TCP/UDP 端口,因此不创建额外防火墙规则。云厂商安全组不作为跨厂商自动修改对象,初始化完成后仍明确提示用户只需手动放行主服务端口。
- **失败处理:**本机防火墙权限不足、命令执行失败或规则创建失败时,初始化必须返回中文错误,不得静默标记成功;如果配置保存失败,只回滚本次初始化新建的规则,不删除初始化前已经存在的规则。防火墙未启用时返回“无需创建规则”的明确状态,不主动启用系统防火墙。
- **状态:**`[x]` 已完成核心适配层、Web/CLI 初始化接入和自动回滚;Windows 10/11、Ubuntu 22.04/24.04、CentOS/Rocky Linux 实机安装流程仍需随安装器复审。
@@ -967,16 +967,16 @@ imported 外部导入
### 29.3 双服务和安全边界
1. **用户补充:**Scert 与 `Scert-admin` 同包交付。
- **实现说明:**`Scert` 负责证书管理、Web API 和任务调度;`Scert-admin` 只负责超级管理员密码重置相关受保护入口,使用独立端口。
- **状态:**`[x]` 已完成独立 Go 入口和独立端口配置。
- **实现说明:**`Scert` 负责证书管理、Web API、`/reset` 路由和任务调度;`Scert-admin` 是不监听网络端口的临时入口激活器,只负责生成一次性校验码并维护短时激活租约。
- **状态:**`[x]` 已完成独立 Go 入口、无网络监听控制器和主服务 `/reset` 路由;完整密码修改接口尚未实现。
2. **实现约束:**`Scert-admin` 默认只监听 `127.0.0.1`,不自动暴露公网。
- **说明:**远程密码重置、一次性恢复令牌、Windows 本地 IPC 和 Linux Unix Domain Socket 需要在安全协议冻结后实现。
- **状态:**`[x]` 已完成默认回环监听限制;完整密码重置协议尚未实现。
2. **实现约束:**`Scert-admin` 不监听任何 TCP/UDP 端口;Scert 主服务固定注册 `/reset`,但仅在 `Scert-admin` 运行并持有有效租约时显示重置页面,未激活、停止或租约过期时统一返回 `404`。
- **说明:**启动 `Scert-admin` 时生成一次性校验码,状态文件只保存校验码的 SHA-256 摘要。租约有效期为 90 秒,每 30 秒刷新;正常停止时立即失效,异常退出后最迟在租约过期时失效。systemd 将单次运行最长时间限制为 30 分钟。
- **状态:**`[x]` 已完成 `/reset` 临时入口、租约、一次性校验码摘要和安全响应头;密码提交、校验码消费、密码摘要更新、频率限制及审计尚未实现。
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 命令具有绝对阻断能力。
- **安全边界:**systemd 无法阻止 root 或等效权限操作者调用其他管理命令,因此同时依靠无独立网络监听、短时租约、30 分钟运行上限、未激活时返回 `404`、`Restart=no` 和 `Scert` 运行用户降低暴露面;不能宣称对 root 的所有 systemd 命令具有绝对阻断能力。
- **状态:**`[x]` 已新增 systemd 单元和服务管理说明,安装器及 Linux 实机复审仍待完成。
### 29.4 本轮暂不视为完成
+287 -9
View File
@@ -1315,17 +1315,17 @@ Linux amd64 可以交叉编译
### 29.1 已完成,等待复审
- [x] 扩展配置模型:超级管理员、密码重置服务地址和端口、Web 域名/IP、Web 开关、DNS 验证状态、TLS 文件路径。
- [x] 当时扩展配置模型:超级管理员、密码重置服务地址和端口、Web 域名/IP、Web 开关、DNS 验证状态、TLS 文件路径;其中独立重置地址和端口方案已由第四十三节的主服务 `/reset` 临时入口方案替代。
- [x] 增加配置兼容归一化,旧配置缺少新增字段时补充安全默认值。
- [x] 增加初始化服务 `internal/setup`,校验管理员密码长度、双端口冲突、DNS 验证状态、Web 域名/IP互斥和公网 IP 格式。
- [x] 当时增加初始化服务 `internal/setup`,校验管理员密码长度、双端口冲突、DNS 验证状态、Web 域名/IP互斥和公网 IP 格式;双端口校验现已取消,只校验 Scert 主服务端口。
- [x] 初始化时只保存管理员 bcrypt 摘要,不保存管理员明文密码。
- [x] `scert init` 支持交互式填写双端口、第三方邮箱、DNS 凭据引用、证书根目录、Web 域名/IP和 Web 开关。
- [x] 新增 `scert-admin` 可执行入口和本机回环监听的受保护服务占位接口。
- [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] 当时新增中文 Web 初始化向导,覆盖超级管理员、双端口、第三方邮件服务、DNS 凭据引用、证书目录、Web 域名/公网 IP、HTTPS 模式和 Web 页面开关;当前界面只保留主服务端口并实时预览 `/reset` 地址。
- [x] 初始化向导明确标注真实 DNS 在线测试、`go-acme/lego` 证书申请和 HTTPS 切换尚未接入,避免误报证书签发成功。
- [x] 初始化配置保存成功后自动进入现有域名管理页面。
- [x] Vite 开发服务器支持通过环境变量设置开发端口和后端 API 地址,便于多实例预览和联调。
@@ -1334,7 +1334,7 @@ Linux amd64 可以交叉编译
- [ ] 集成真实 `go-acme/lego` Web 证书申请、DNS provider 验证和证书部署。
- [ ] 实现 Web 证书本地校验、HTTPS 启动和初始化完成后的 HTTP 关闭。
- [ ] 实现 `Scert-admin` 一次性密码重置令牌、审计日志和 Windows/Linux 本地安全通道。
- [ ] 实现 `/reset` 密码提交、一次性校验码校验与单次消费、bcrypt 密码摘要更新、频率限制和审计日志。
- [ ] 实现 Windows Service、Linux systemd 以及同时安装两个服务的安装器。
- [ ] 实现 Wails 首次启动向导和“是否开启 Web 页面”按钮。
- [ ] 完成公网 IP 证书的 CA、`lego` 和跨平台实测。
@@ -1513,7 +1513,7 @@ Linux amd64 可以交叉编译
- [x] `Scert-admin` 不允许开机自启动。
- [x] 日常支持的启停命令仅为 `systemctl start Scert-admin` 和 `systemctl stop Scert-admin`。
- [x] `Scert-admin` 不配置自动重启,不提供 `ExecReload`,不创建公网防火墙规则。
- [x] `Scert-admin` 继续使用 `Scert` 用户运行,并由程序层强制只监听本机回环地址。
- [x] `Scert-admin` 继续使用 `Scert` 用户运行;本节最初采用回环监听,现已由第四十三节改为不监听任何 TCP/UDP 端口。
- [x] 安装或升级阶段允许使用一次 `systemctl daemon-reload` 加载新 unit,但不得因此启动或启用 `Scert-admin`。
### 34.2 开发任务状态
@@ -1522,7 +1522,7 @@ Linux amd64 可以交叉编译
- [x] 新增 `deploy/systemd/Scert.service`,保留核心服务独立的 systemd 服务定义。
- [x] 新增 `deploy/systemd/Scert-admin服务管理说明.md`,明确安装阶段和日常运维阶段的命令边界。
- [x] 增加自动化检查,验证 `Scert-admin.service` 使用 `Scert` 用户、`Restart=no`,且没有自动启动目标、自动重启和 reload 配置。
- [x] 增加非回环监听拒绝测试,防止 `Scert-admin` 被配置为公网或局域网监听。
- [x] 原非回环监听拒绝测试已被无网络监听验证替代;当前自动化检查要求 systemd 只允许 `AF_UNIX`,并禁止 `AF_INET` 和 `AF_INET6`。
### 34.3 安全边界与未完成项
@@ -1609,7 +1609,7 @@ Linux amd64 可以交叉编译
- [!] 当前 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` 手动启停和回环监听仍需实机验证。
- [!] systemd unit 注册、`daemon-reload`、核心服务启停、`Scert-admin` 手动启停、无网络监听限制和 `/reset` 租约激活仍需实机验证。
- [!] 本机防火墙初始化、云安全组放行、ACME DNS 在线验证、Let’s Encrypt 证书申请、HTTPS 切换和部署后校验不属于本轮安装器复审证据,不能标记为完成。
### 36.5 复审结论
@@ -1685,3 +1685,281 @@ Linux amd64 可以交叉编译
- [!] 本轮仅提供 CLI 导入入口,Web 上传接口和管理页面尚未接入。
- [!] 导入完成后自动推送远程服务器、重载 Nginx/Caddy/Apache 和 HTTPS 在线校验尚未实现。
## 三十九、多服务器部署核心开发记录(2026-08-27)
### 39.1 本轮需求清单
- [x] 定义服务器连接配置:地址、SSH 端口、用户、私钥引用和主机指纹。
- [x] 定义远程证书、完整证书链和私钥路径。
- [x] 支持 Nginx、Caddy、Apache 默认 reload 命令及自定义命令。
- [x] 支持证书文件远程临时上传、原子替换和私钥权限 `0600`。
- [x] 支持部署前备份、reload 失败回滚和无旧文件场景清理。
- [x] 汇总全部成功、部分成功和全部失败结果。
### 39.2 开发任务状态
- [x] 增加 `internal/deployment` 部署模型、客户端接口和部署事务服务。
- [x] 增加真实 SSH/SFTP 客户端适配层,仅允许 SSH 私钥认证。
- [x] 增加 SSH 连接超时和固定主机指纹校验。
- [x] 增加远程命令参数校验和 shell 参数安全转义。
- [x] 增加内存远程客户端测试,覆盖成功部署、备份保留、reload 失败回滚和部分成功。
### 39.3 当前验证状态
- [✓] 部署核心和 SSH/SFTP 适配层定向测试通过。
- [✓] 服务器删除使用事务清理域名关联,避免产生悬空关联,并通过仓储测试。
- [✓] `gofmt`、`go test ./...`、`go test -race ./...` 和 `go vet ./...` 通过。
- [✓] 前端 `npm.cmd run build` 通过。
- [✓] Windows amd64 和 Linux amd64(`CGO_ENABLED=0`)的 `scert`、`scert-admin` 构建通过。
- [✓] `git diff --check` 通过。
### 39.4 本轮新增联动任务
- [✓] 将服务器仓储和部署服务接入 `app.App`。
- [✓] 将证书申请、续期、导入统一接入“保存证书后部署到关联服务器”工作流。
- [✓] 增加 Web `POST /api/v1/domains/:id/issue` 手动申请/续期接口。
- [✓] 部署部分失败时保留部署报告,并将域名证书状态标记为 `error`。
- [✓] 为证书工作流增加关联服务器部署成功和失败状态测试。
### 39.5 当前边界
- [!] 服务器配置的 Web/CLI 增删改查入口尚未实现,本轮仅完成数据库仓储和核心联动。
- [!] 尚未在 Windows 10/11、Ubuntu 22.04/24.04、Debian、CentOS/Rocky Linux 和真实 Nginx/Caddy/Apache 环境连接验证。
- [!] 远程备份清理策略、部署后 HTTPS 在线校验、邮件通知和操作审计仍待后续任务实现。
## 四十、服务器管理入口与前端配置视图开发记录(2026-08-27)
### 40.1 本轮需求清单
- [x] 提供服务器 Web 管理接口:列表、详情、添加、修改和删除。
- [x] 提供域名服务器关联 Web 接口:查询关联和整体替换关联。
- [x] 提供服务器 CLI 管理命令及域名关联命令。
- [x] 前端增加部署服务器列表、添加、编辑和删除配置界面。
- [x] 前端域名表单增加关联部署服务器多选配置。
### 40.2 开发任务状态
- [x] 将服务器仓储接入 Web API,并统一校验服务器配置和默认 reload 命令。
- [x] 将服务器仓储接入 CLI:`server list/show/add/edit/delete`。
- [x] 增加域名关联 CLI:`domain servers list/set`。
- [x] 删除服务器和域名时事务清理 `domain_servers` 关联。
- [x] 增加 Web/仓储集成测试和 CLI 帮助回归测试。
- [x] 前端完成服务器管理和域名关联交互。
### 40.3 本轮验证状态
- [✓] `gofmt`、`go test ./...`、`go test -race ./...` 和 `go vet ./...` 通过。
- [✓] 前端 `npm.cmd run build` 通过。
- [✓] 服务器 API 集成测试通过,覆盖创建、关联、删除和关联清理。
- [✓] `git diff --check` 通过。
### 40.4 当前边界
- [!] 服务器 SSH 私钥内容仍需通过敏感信息存储单独录入,当前管理表单只配置 `private_key_ref`,不会上传明文私钥。
- [!] Web 管理后台认证、邮件通知、证书上传、部署后 HTTPS 校验和操作审计仍待后续接入。
- [!] 真实远程 Windows 10/11、Ubuntu、Debian、CentOS/Rocky Linux 及 Nginx/Caddy/Apache 环境仍需实机验收。
## 四十一、SSH 部署私钥安全管理开发记录(2026-08-27)
### 41.1 本轮需求清单
- [✓] SSH 部署私钥和可选口令必须进入本机加密敏感信息存储,不写入业务数据库。
- [✓] Web API、CLI 和前端只能返回私钥名称、安全引用、算法、公钥指纹和更新时间。
- [✓] 服务器新增和修改时只能选择真实存在的 SSH 私钥引用。
- [✓] 正在被部署服务器使用的 SSH 私钥禁止删除。
- [✓] SSH 部署客户端支持无口令私钥和带口令私钥。
- [✓] 提供 Web 和 CLI 的 SSH 私钥录入、列表及删除入口。
### 41.2 开发任务状态
- [✓] 扩展 `secretstore.Store`,增加按引用前缀列出元数据和删除敏感信息能力。
- [✓] 增加 `internal/sshkey` 服务,校验 RSA、ECDSA、Ed25519 和 OpenSSH 私钥并生成 SHA256 公钥指纹。
- [✓] 增加 `GET /api/v1/ssh-keys`、`POST /api/v1/ssh-keys` 和 `DELETE /api/v1/ssh-keys/:id`。
- [✓] 增加 `scert ssh-key list/add/delete`,私钥和口令均从文件读取,不作为命令行参数传入。
- [✓] 服务器 Web API 和 CLI 保存配置前校验 `private_key_ref`,删除私钥前检查服务器占用状态。
- [✓] 前端增加 SSH 私钥管理面板、加密录入弹窗和服务器私钥下拉选择,并在保存或取消后清空私钥表单内存。
### 41.3 本轮验证状态
- [✓] `go test ./...` 通过。
- [✓] `go test -race ./...` 通过。
- [✓] `go vet ./...` 通过。
- [✓] Windows amd64 和 Linux amd64、`CGO_ENABLED=0` 的 `scert`、`scert-admin` 构建通过。
- [✓] 前端 `npm.cmd run build` 通过。
- [✓] 浏览器模拟 API 联动检查通过:私钥保存后不显示明文或口令,再次打开录入弹窗字段为空。
- [✓] 浏览器模拟 API 联动检查通过:服务器可以选择私钥引用,使用中的私钥删除时显示 HTTP 409 中文错误。
- [✓] 移动端宽度检查未发现横向溢出,顶部操作按钮按两列换行。
- [✓] 带口令私钥创建、错误口令拒绝和部署客户端带口令私钥解析回归测试通过。
- [✓] SSH 私钥 1 MiB、口令 4096 字节及 HTTP 请求体 2 MiB 限制回归测试通过。
- [✓] `go mod verify` 和 `git diff --check` 通过。
### 41.4 当前边界
- [!] 浏览器检查使用模拟 API,没有向浏览器或仓库写入真实 SSH 私钥。
- [!] 尚未连接真实 SSH/SFTP 服务器验证无口令和加密私钥登录。
- [!] Windows 10/11、Ubuntu 22.04/24.04、Debian、CentOS/Rocky Linux 以及真实 Nginx/Caddy/Apache 环境仍需实机验收。
- [!] 管理后台登录认证与 API 访问保护尚未接入;在认证完成前,不应将当前管理接口直接暴露到公网。
- [!] CLI 与 Web 多进程并发修改 SSH 私钥和服务器引用时,检查与写入之间尚无跨进程原子性保证;后续需通过数据库外键、命名锁或统一事务协调服务增强。
## 四十二、远程证书目录模板优化开发记录(2026-08-27)
### 42.1 本轮需求清单
- [✓] 远程服务器证书目录统一采用 `/ssl/{域名}/{证书类型}/`。
- [✓] 单域名证书目录使用 `single`,泛域名证书目录使用 `wildcard`,SAN 多域名证书目录使用 `san`。
- [✓] 证书、完整证书链和私钥默认路径分别为 `cert.pem`、`fullchain.pem` 和 `key.pem`。
- [✓] 泛域名的目录名称去除 `*.`,例如 `*.example.com` 使用 `/ssl/example.com/wildcard/`。
- [✓] 同一服务器关联多个域名时,部署流程按当前域名生成实际路径,避免证书互相覆盖。
- [✓] 自定义远程路径继续保留,并支持 `{域名}`、`{证书类型}`、`{domain}` 和 `{certificate_type}` 占位符。
### 42.2 开发任务状态
- [✓] 在部署模型中增加统一的远程证书默认路径模板。
- [✓] 服务器路径为空时,由后端规范化逻辑自动补充默认模板。
- [✓] 证书部署工作流读取域名名称和证书类型,并在连接远程服务器前解析路径模板。
- [✓] Web 服务器配置表单直接显示真实默认模板,并说明占位符替换规则。
- [✓] API 允许省略三个远程证书路径字段,统一采用后端默认模板。
- [✓] CLI 为三个远程证书路径参数设置默认模板,不再强制用户填写。
- [✓] 未识别的路径占位符返回中文错误,不允许原样部署到远程服务器。
### 42.3 目录示例
```text
/ssl/
├── ssh/
└── example.com/
├── single/
│ ├── cert.pem
│ ├── fullchain.pem
│ └── key.pem
├── wildcard/
│ ├── cert.pem
│ ├── fullchain.pem
│ └── key.pem
└── san/
├── cert.pem
├── fullchain.pem
└── key.pem
```
### 42.4 本轮验证状态
- [✓] 单域名、泛域名和 SAN 路径解析测试通过。
- [✓] 同一服务器关联多个域名的目录隔离测试通过。
- [✓] 自定义路径保留、英文占位符兼容和未知占位符拒绝测试通过。
- [✓] API 省略路径字段后采用默认模板的集成测试通过。
- [✓] CLI 默认路径参数和非必填状态测试通过。
- [✓] `go test ./...` 通过。
- [✓] `go test -race ./...` 通过。
- [✓] `go vet ./...` 通过。
- [✓] 前端 `npm.cmd run build` 通过。
- [✓] Windows amd64 和 Linux amd64、`CGO_ENABLED=0` 的 `scert`、`scert-admin` 构建通过。
- [✓] `git diff --check` 通过。
### 42.5 当前边界
- [!] 本轮调整的是远程服务器证书部署路径,不修改本机证书版本化保存结构。
- [!] `/ssl/ssh` 仅作为 SSH 相关目录规划或用户文件来源目录;Scert 管理的 SSH 私钥和口令仍保存在本机加密敏感信息存储中,不写入普通明文目录。
- [!] Windows 远程服务器的实际证书路径仍需根据目标 SSH/SFTP 服务和 Web 服务配置由用户自定义,并在真实环境中验收。
## 四十三、Scert-admin 无独立端口与 `/reset` 临时入口开发记录(2026-08-27)
### 43.1 本轮需求清单
- [✓] 密码重置服务取消独立监听端口,初始化流程只配置 Scert 主服务端口。
- [✓] 根据 Web 管理域名或公网 IP 自动生成 `/reset` 地址。
- [✓] 主服务端口为 `443` 时省略端口号,其他端口继续使用主服务端口,不增加新的防火墙或云安全组端口。
- [✓] `Scert-admin` 默认不启动,不允许开机自启动,日常控制仍只支持 `systemctl start Scert-admin` 和 `systemctl stop Scert-admin`。
- [✓] `/reset` 只在 `Scert-admin` 显式启动并持有有效租约时临时开放,其他时间隐藏为 `404`。
### 43.2 开发任务状态
- [✓] 删除配置模型、初始化 API、CLI 和 Web 初始化向导中的独立重置主机与端口字段。
- [✓] 配置模型新增 `ResetURL()`,支持域名、IPv4、IPv6、`443` 省略端口和非 `443` 主端口。
- [✓] 将 `scert-admin` 从独立 HTTP 服务改为无网络监听的短时租约控制器。
- [✓] 启动时生成一次性校验码,状态文件只保存 SHA-256 摘要,不保存明文校验码。
- [✓] 租约有效期设置为 90 秒,每 30 秒刷新;正常停止立即失效,异常退出后自动过期。
- [✓] Scert 主服务注册固定 `/reset` 路由,未激活、状态读取失败、停止或租约过期时返回 `404`。
- [✓] 激活页面增加禁止缓存、禁止索引、禁止引用来源、内容安全策略和禁止被嵌入的响应限制。
- [✓] systemd 单元设置 `Restart=no`、`RuntimeMaxSec=30min` 和 `RestrictAddressFamilies=AF_UNIX`,阻止 `Scert-admin` 建立 IPv4/IPv6 网络监听。
- [✓] 前端初始化界面删除独立重置端口,增加根据域名/IP与主端口实时生成的 `/reset` 地址预览。
- [✓] 同步需求确认文档、Linux 部署说明和两个 systemd 服务管理说明;历史双端口与回环监听记录保留并标注已被本节替代。
### 43.3 自动化复审结果
- [✓] `gofmt -l .` 无待格式化文件。
- [✓] `go test ./...` 通过。
- [✓] `go test -race ./...` 通过。
- [✓] `go vet ./...` 通过。
- [✓] `go mod verify` 通过。
- [✓] 前端 `npm.cmd run build` 通过。
- [✓] Windows amd64、`CGO_ENABLED=0` 的 `scert` 和 `scert-admin` 构建通过。
- [✓] Linux amd64、`CGO_ENABLED=0` 的 `scert` 和 `scert-admin` 构建通过。
- [✓] 相关源文件保持 UTF-8 无 BOM。
- [✓] `git diff --check` 通过。
### 43.4 当前安全边界与未完成项
- [!] 当前 `/reset` 仅为中文占位页面,尚未实现密码提交接口,不能视为已经具备完整密码重置能力。
- [!] 后续必须实现一次性校验码验证与单次消费、新密码复杂度校验、bcrypt 摘要更新、请求频率限制、CSRF/重放防护和审计日志。
- [!] 当前基础实现会把一次性校验码写入标准输出;systemd 会接管服务标准输出。正式上线密码重置前必须实现不把明文校验码长期保留在持久日志中的受保护本地呈现机制。
- [!] Scert 核心服务的真实 HTTPS 终止、证书加载和高级反向代理模式尚未完成;在这些能力完成前,自动生成的 `https://.../reset` 地址属于目标配置地址,不代表当前开发服务已经完成生产级 HTTPS 暴露。
- [!] Windows 10/11 与 Ubuntu 22.04 的真实服务启停、异常退出租约过期、HTTPS 反向代理和防火墙行为仍需实机验收。
- [!] 主服务端口为非 `443` 时,生成地址包含该主服务端口;高级反向代理模式后续需要明确公开 HTTPS 端口与内部服务端口的独立配置,避免把内部端口写入公开重置地址。
## 四十四、超级管理员一次性密码重置闭环开发记录(2026-08-27)
### 44.1 本轮需求清单
- [x] 在临时 `/reset` 地址提供中文超级管理员密码重置表单。
- [x] 使用 `Scert-admin` 启动时生成的一次性校验码完成身份校验,并保证校验码只能成功消费一次。
- [x] 校验新密码长度、与超级管理员用户名的关系以及两次输入是否一致。
- [x] 使用 bcrypt 生成新密码摘要,并以原子配置保存方式更新磁盘配置和内存配置。
- [x] 增加 CSRF、同源请求校验、请求体限制和按客户端 IP 的失败频率限制。
- [x] 重置成功后立即关闭当前租约,阻止 `Scert-admin` 刷新已消费的旧租约,并记录数据库审计日志和安全日志。
- [x] 补充安全测试、配置持久化测试、部署说明和跨平台构建复审。
### 44.2 开发任务状态
- [x] 增加密码规则共享模块,保持首次初始化和密码重置使用同一套规则。
- [x] 增加校验码常量时间比较、会话校验、单次消费和租约刷新终止逻辑。
- [x] 增加密码重置表单渲染、CSRF Cookie、同源校验和请求频率限制。
- [x] 增加超级管理员密码摘要更新、失败回滚边界和一次性入口关闭逻辑。
- [x] 增加审计日志仓储并接入 SQLite、MySQL 5.7 兼容 SQL。
- [x] 补充自动化测试并执行完整复审。
### 44.3 当前约束
- [!] 当前核心服务仍未完成生产环境真实 HTTPS 终止;本节只完成 `/reset` 应用层安全闭环,不能替代后续 HTTPS 和反向代理实机验收。
- [!] 一次性校验码的受保护本地呈现机制仍需单独实现;在该机制完成前,不将标准输出呈现方式认定为生产可用。
## 四十五、初始化向导左右分栏视觉优化开发记录(2026-08-27)
### 45.1 本轮需求清单
- [x] 初始化页面保持左右两列主布局,左侧品牌区收窄,右侧配置区加宽。
- [x] 移除左侧品牌区域中的“Scert 证书管理与 Web 服务”和“Scert-admin 手动启动后临时启用 /reset”提示卡,避免在此处重复提示。
- [x] 超级管理员配置表单调整为两列排列,统一视觉节奏。
- [x] 保持初始化配置在前端内存中,只有第 4 步完成初始化时提交后端。
### 45.2 开发任务状态
- [x] 调整初始化面板最大宽度和左右列比例,避免大屏下界面过度拉伸。
- [x] 保留移动端单列布局,并对 390×844、320×667 视口进行无滚动条检查。
- [x] 保留第 1~4 步“下一步/上一步”流程和字段状态,不改变现有初始化接口。
- [x] 前端生产构建通过。
### 45.3 本轮验证状态
- [x] 1440×900 桌面视口:主面板宽 1120,左侧约 380,右侧约 738,无页面溢出。
- [x] 390×844 移动视口:页面无横向、纵向滚动条,第 1~4 步卡片均未发现内部溢出。
- [x] 320×667 移动视口:第 4 步页面无横向、纵向滚动条。
- [x] 通过浏览器实际点击验证第 1 步进入第 2 步、第 2 步进入第 3 步,以及返回上一步后已填写字段仍然保留。
- [x] `npm.cmd run build` 通过。
- [x] `git diff --check` 通过。
### 45.4 当前状态
- [!] 本轮视觉修改已完成,等待用户确认参考效果。
- [!] 当前仅完成初始化向导界面优化,不代表 Scert 完整产品的 ACME/lego 签发、自动续期、远程部署和正式 HTTPS 生产验收已完成。