Fast Https 发行版

2026-11-07 14:11 v1.6.1 5589f28

Fast-Https 1.6.1（2026-11-07）

这是一个修复版本，主要解决 1.6.0 在全新环境下编不动、Linux 桌面端
安装包装完跑不起来的问题，并把项目内的版本信息统一到 1.6.1。
1.6.0 已发布，本版本独立追加，不改写旧 tag。

与 1.6.0 的区别

1. 新克隆可以直接构建了
   1.6.0 依赖一个上游已经不存在的 guardianwaf v1.0.0 tag。全新环境执行
   go build ./... 会直接失败，只有本地缓存过该模块的老环境才碰巧能继续
   构建。本版本改用上游实际发布的 v0.6.0，用到的接口完全兼容，拉取源码
   后即可正常构建。

2. Linux 桌面端安装包现在开箱即用
   1.6.0 的 fast-https-desktop deb / rpm / apk 只装了桌面端程序，装完因为
   缺少主配置、站点片段、证书目录以及 systemd / logrotate 配置，服务无法
   启动。本版本的桌面端包同时带上完整的主程序与运行期资源，离线只装
   这一个包就能直接启动服务；它与独立主程序包互斥，系统里已装主程序包
   时会替换掉后者，不会出现同一文件被两个包各装一份。纯服务器部署仍
   只装主程序包，不会被强加 GTK / WebKitGTK 桌面依赖。

3. 保留 agent 控制面协议
   modules/safe 的控制面接口（运行时黑名单与限流调整、状态快照、审计
   计数）在开发过程中曾被误当作「2.0 预留脚手架」删除，本版本恢复，
   行为与 1.6.0 保持一致。它是后续 agent 控制工具的基础：模拟人执行
   CLI 的动作，为 deepseek harness、workbuddy 等外部工具提供可调用入口，
   并在控制面完成数据整理与计数，而不是把命令简单透传给 CLI。

4. 版本信息不再散落各处
   1.6.0 只打了 git tag，代码里的版本号没有跟着改：本地打包仍按旧的
   快照版本产包，二进制 version、README 版本徽章与手册页也显示旧版本。
   本版本把所有版本字段收敛到 build/bump-version.ps1 一处维护，AGENT.md
   明确要求打 tag 前先运行；源码注释与文档示例里不再写死具体版本号。
   现在 tag、产物文件名与二进制版本号三者一致。

升级说明

从 1.6.0 升级不需要修改配置，也没有数据格式变化，覆盖安装即可。已经
装了独立主程序包、又想使用桌面管理端时，安装桌面端包会替换主程序包，
/etc/fast-https 下现有的配置会保留。

最后提交信息为： chore(release): 版本信息同步为 1.6.1

Fast Https发行版v1.6.0

2026-11-06 23:28 v1.6.0 d7961fe

最后提交信息为： chore(release): 全文版本号同步为 1.6.0

Fast Https发行版v1.5.0

2026-11-06 15:54 v1.5.0 a7831c9

Fast-Https 1.5.0 
## 新增

- ACME 自动签发：不需要外部脚本即可申请并续期受信任证书，配套 CA 降级链（Let's Encrypt → ZeroSSL）、staging、自签兜底
- ACME 热重载：改 acme 段不再需要 stop + start，reload 按配置差异重建证书申请任务
- site 命令组：site init（对已存在的站点即原地更新，只覆盖显式传入的字段）、site list、site show、site remove
- acme 命令组：无子命令进入交互向导（以当前配置为默认值）、acme setup、acme show
- config path：输出运行期实际使用的配置文件与目录绝对路径
- version 命令；全部命令的帮助信息支持中英双语
- 随包安装 logrotate 配置（copytruncate），日志不再无限增长
- 打包：apt/yum/apk 仓库树生成脚本、deb/rpm/apk 容器实机验证脚本
- 文档：feature / develop / help 三套体系，新增 AGENT.md 与项目架构图

## 变更

- 配置解析去掉 viper，改为自带 JSONC 解析，原子写下沉到 infra
- 主配置拆为系统级配置 + conf.d 站点文件，config 包按职责拆分为五个文件
- 发行版包改为 FHS 分离布局（/etc、/usr/share、/var/log、/run）
- reload 发信号前先在本地校验配置，校验失败不动运行中的实例
- ACME 向导以当前配置为默认值，摘要延后到答完题再生成

## 修复

- 打包脚本 CRLF 行尾导致「能装不能卸、报 prerm ENOENT」
- 卸载后进程仍在跑、80/443 被占用：单元 cgroup 之外的残留进程按 pid 文件与 /proc 双路清理
- http-01 端口告警漏算 conf.d 里的站点
- ACME 配好却没有任何域名可申请时不给任何提示
- site 改写文件时吞掉未建模字段
- logrotate 配置 CRLF 行尾

## 移除

- install / uninstall / check / dev / completion 命令
- 顶层 shell/ 目录（vendored acme.sh）

## 破坏性变更

- 安装与卸载交给包管理器，不再提供对应子命令
- 包布局迁移到 /etc/fast-https；postinstall 会复制旧的 config/，不覆盖现场文件

## ACME 证书挑战

- http-01：走 early-request 钩子，在路由匹配之前应答 /.well-known/acme-challenge/，不受站点根目录与 location 规则影响
- tls-alpn-01：只在启用时把 acme-tls/1 放进 NextProtos，未使用 ACME 的部署握手表保持不变；reload 开关该方式时重建对应 ssl 端口的 tls.Config
- 申请期间继续使用自签证书，首次握手不阻塞；申请失败按 fallback_self_signed 回落
- 只有 listen 含 ssl 的站点进入申请列表，非公网域名跳过并在日志与 acme show 中说明原因
- reload 只在差异处重建管理器：enabled / email / staging / storage / challenge / cas / renew_before_days 与域名集合；配置未变时不打断 certmagic 的续期调度，新配置构造失败时保留旧管理器继续续期

最后提交信息为： chore(release): 快照版本号改为 1.5.0，产物不再带 next 后缀