Architecture - wongyiuming/FrontierCloud-Gin GitHub Wiki

架构

当前运维入口(2026-10-14)

当前 updater 清理交付见 PR #15,公开版本为 fc6adc75c7cdb9064163f938a31f176add843e0a。源码、Updater 镜像发布、fc 的 Updater 校验与旧 CD 入口已移除。保留证书 certificate-agent,它只负责 TLS 生命周期,不承担项目升级。

当前发布只编译、发布 Web/Nginx 两种镜像;证书 agent 使用 Web 镜像中的证书命令。升级由每台主机显式执行 fc upgrade plan/apply/open,无自动整群发布、后台 Docker socket 升级或现场源码编译。数据库代际为 7,本次没有 DDL 变化。

现行命令、备份和恢复边界见 fc 手动升级与边界,源码契约以 main 的 运维手册 和 升级契约 为准。RN 预生产和外部 CD 已退役,不能声称完成 live staging 验收。

本次生产执行状态见 fc 手动升级与边界;公开发布成功不等于生产更新完成。

2026-10-11 及此前的历史记录(旧命令及版本不用于当前部署)

跨模块权威文档在 ARCHITECTURE.md,贡献/晋升规则在 CONTRIBUTING.md。Wiki 提供运维导航,不复制另一套矛盾的完整架构。

核心是一个业务主节点 + only_stroge 存储节点,无计算工作节点,无整群版本同步。存储保留 Go 签名权限和事务恢复能力,因此不能退化成无状态 Nginx 文件服务器。

默认启动配置基线

自动 TLS 已由 PR #9 / #10 发布到 main/latest,当前版本 785af2d2c4595d210bf3bf2de8d39ef6f0b42983:业务节点只需 TLS_ENABLED 与 SERVER_NAME,Go 管理生命周期,Nginx 终止 HTTPS;存储节点 Go 原生 HTTPS。Business 和 Direct 使用 80/443(存储的 80 仅验证期间);Relay 默认高位通信端口,不常驻占用宿主 80/443。私钥/账户缓存持久隔离,控制台只读状态并提供受保护的下载。Python 应用与展示源码已删除,运维和测试脚本保留。

历史五参数修复实录(非本次自动 TLS 发布): PR #7,dev ba3c9ed25864df04217edc438dbd9fa7d0e0c935。开发机实际五参数 HTTPS、真实 Compose 默认值/空值/精确版本与 SQLite/MySQL 配置回归通过;源码 CI、正常镜像发布与事件 CD 均通过。RN 三份运行镜像及 current/target/updater runtime 已匹配该 dev 提交,就绪检查 200;生产存储容器保持原 ID 且健康。PR #7 现已合并为 main 3c998bc112db2a3ba3f69b360d8a02cf57a0ec37;main 发布及 publish-latest 全部成功,三个默认标签的独立匿名来源和 digest 检查通过。main/dev 已同步该合并提交。

⚠️ **GitHub.com Fallback** ⚠️