feat: support gateway-only deployment without client releases

2026-10-28 03:44:04 +00:00
parent 267a65305e
commit 295310ab9a
3 changed files with 117 additions and 7 deletions
@@ -81,6 +81,12 @@ cd /path/to/dingMCP

 脚本自动测试、构建、用 Ed25519 私钥签署 schema v3 清单、重启服务、原子发布静态文件、安装 Nginx 配置并验证公网健康检查、OAuth 元数据和安装链接。首次签证书时，临时 HTTP 配置只开放 ACME challenge，其余请求返回 403；不会在明文 HTTP 上代理 OAuth、Token 或 MCP。证书通过 Certbot webroot 模式签发，正式配置启用 HTTPS 跳转与不带 `includeSubDomains` 的 HSTS。已有证书会自动复用；签名私钥缺失、权限不是 `0600` 或与固定公钥不匹配时发行会失败。

+仅修改服务端、无需发布新客户端时，执行 `./deploy/install.sh --gateway-only`。
+该模式同样要求无未提交改动且已同步到 Gitea 的 `main`，运行全量测试和配置检查后重启
+网关，再验证公网健康和 OAuth 元数据。它保留服务器凭证、OAuth 数据库、Nginx 配置和
+现有客户端发行物，不创建 Release 或标签，也不需要读取发布私钥。服务重启会断开
+现有 MCP 连接；客户端需重新建立连接，已有 OAuth 登录凭证保留。
+
 发行物先复制到独立 staging 目录，再通过符号链接原子切换；客户端不会看到新清单配旧 artifact 的中间状态。服务器保留当前版本和最近两个旧版本用于排障，较老版本自动清理。`install.md`、`compat-install.md`、清单、签名、安装器、Skill、校验文件和测试包均以 `no-cache` 提供；内容寻址的客户端 tgz 才使用 immutable 缓存。签名清单的 `createdAt` 超过 180 天时兼容客户端拒绝安装，避免旧签名版本冻结攻击。

 卸载：