diff --git a/cloudflare-worker/package.json b/cloudflare-worker/package.json index 1745518..862f939 100644 --- a/cloudflare-worker/package.json +++ b/cloudflare-worker/package.json @@ -5,7 +5,7 @@ "type": "module", "description": "MessageWeave Cloudflare Worker: 统一 HTTPS 入口 + 多后端 origin 故障转移(透传模型,SAF-LB-PASSTHRU)。零运行时依赖(仅 ES2022 + Fetch API),可直接 node --test。", "scripts": { - "test": "node --test test/", + "test": "node --test", "check": "node --check src/*.js && node --check test/*.test.js && wrangler deploy --dry-run --outdir=.build-check", "deploy": "wrangler deploy", "dev": "wrangler dev --local" diff --git a/cloudflare-worker/wrangler.toml b/cloudflare-worker/wrangler.toml index 9f754aa..cd4c804 100644 --- a/cloudflare-worker/wrangler.toml +++ b/cloudflare-worker/wrangler.toml @@ -1,28 +1,34 @@ -/** - * Wrangler 示例配置 — MessageWeave 多实例 LB/HA(ARCH-LB-WORKER / deployment.md §10)。 - * - * 安全约束(docs/charter.md §3/§5,稳定 ID 注册表 §8): - * - 后端 origin 仅允许 https(C-HTTPS-INBOUND / C-HTTPS-URL);env 校验时拒绝 - * http/非 https/内嵌凭据。 - * - 不代理 Redis/JMAP(C-NO-DB / C-REDIS-ONLY-STATE):Worker 只做请求转发,后端连自己的 Redis。 - * - 不使用 WebSocket/SSE/长轮询(C-NO-LONG-CONN):纯请求-响应转发。 - * - 后端 secret 走 `wrangler secret`(见 README),不进代码/日志(SAF-LOG-PURITY / C-NO-SECRET-IN-IMAGE; - * C-LB-SHARED-SECRETS:所有后端实例共享同一组 secret)。 - * - 日志无密钥(SAF-LOG-PURITY):只打「方法/路径/origin/失败类别」,origin 清单走 secret。 - * - 仅允许转发 safelist 路由(C-LB-SINGLE-REG-URL);未知路径 404。 - * - * 部署: - * cd cloudflare-worker - * npx wrangler secret put BACKEND_ORIGINS_JSON # 见下方示例格式 - * npx wrangler deploy - */ +# Wrangler 配置 — MessageWeave 多实例 LB/HA(ARCH-LB-WORKER / deployment.md §10)。 +# +# 注意:TOML 只支持 '#' 注释。这里曾经用 JSDoc 的 /** */ 块,Cloudflare 的 TOML +# 解析器会把 '*' 当成未知字符(wrangler 报 Unknown character "47"),deploy / +# secret put / dev 在读取配置文件时就失败——所以全部展开成 '#' 行。 +# +# 安全约束(docs/charter.md §3/§5,稳定 ID 注册表 §8): +# - 后端 origin 仅允许 https(C-HTTPS-INBOUND / C-HTTPS-URL);env 校验时拒绝 +# http/非 https/内嵌凭据。 +# - 不代理 Redis/JMAP(C-NO-DB / C-REDIS-ONLY-STATE):Worker 只做请求转发,后端连自己的 Redis。 +# - 不使用 WebSocket/SSE/长轮询(C-NO-LONG-CONN):纯请求-响应转发。 +# - 后端 secret 走 `wrangler secret`(见 README),不进代码/日志(SAF-LOG-PURITY / C-NO-SECRET-IN-IMAGE; +# C-LB-SHARED-SECRETS:所有后端实例共享同一组 secret)。 +# - 日志无密钥(SAF-LOG-PURITY):只打「方法/路径/origin/失败类别」,origin 清单走 secret。 +# - 仅允许转发 safelist 路由(C-LB-SINGLE-REG-URL);未知路径 404。 +# +# 部署: +# cd cloudflare-worker +# npx wrangler secret put BACKEND_ORIGINS_JSON # 见下方示例格式 +# npx wrangler deploy + name = "messageweave-lb" main = "src/index.js" compatibility_date = "2025-01-01" compatibility_flags = ["nodejs_compat_v2"] # 统一 HTTPS 入站(C-HTTPS-URL;平台代 TLS,Worker 内为短请求模型)。 -# 后端 origin 为 secret(不经明文 env 流转): +# 后端 origin 为 secret(不经明文 env 流转)。BACKEND_ORIGINS_JSON 只接受 +# 「字符串数组」——每项是一个 https origin;不支持 {"url":…, "weight":…} 这种 +# 对象形式(parseBackendOrigin 只认字符串,对象项会让整份配置解析失败, +# 而配置是**每个请求**重新解析的,所以会表现为**每个请求都 503**,不是启动即失败): # BACKEND_ORIGINS_JSON 形如 ["https://a.platform1.example","https://b.platform2.example"] # LB_HEALTH_TTL_MS 可选,健康缓存 TTL(默认 30000) # LB_REQUEST_TIMEOUT_MS 可选,单 origin 超时(默认 10000,建议 > 最坏 cold start)