worker: 修掉两个会让 Worker 部署直接失败的配置错误

- wrangler.toml 用 JSDoc 的 /** */ 注释,TOML 解析器把 '*' 当未知字符
  (wrangler 报 Unknown character 47),deploy/secret put/dev 在读取配置阶段
  就失败,根本走不到你的 secret。全部展开成 '#' 行。
- npm test 写成 node --test test/,Node 22.23 会把 test/ 当模块路径去
  require,报 MODULE_NOT_FOUND。改成 node --test(无参数自动发现 test/),
  仍为 32 个用例全通过(backends 6 / health 4 / index 12 / lb 10)。

wrangler deploy --dry-run 现通过(wrangler 3.114.17,上传 31.48 KiB)。
This commit is contained in:
anonsaber 2026-09-30 16:24:32 +08:00
parent baff2dde8d
commit 826b41e781
2 changed files with 26 additions and 20 deletions

View File

@ -5,7 +5,7 @@
"type": "module", "type": "module",
"description": "MessageWeave Cloudflare Worker: 统一 HTTPS 入口 + 多后端 origin 故障转移(透传模型,SAF-LB-PASSTHRU)。零运行时依赖(仅 ES2022 + Fetch API),可直接 node --test。", "description": "MessageWeave Cloudflare Worker: 统一 HTTPS 入口 + 多后端 origin 故障转移(透传模型,SAF-LB-PASSTHRU)。零运行时依赖(仅 ES2022 + Fetch API),可直接 node --test。",
"scripts": { "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", "check": "node --check src/*.js && node --check test/*.test.js && wrangler deploy --dry-run --outdir=.build-check",
"deploy": "wrangler deploy", "deploy": "wrangler deploy",
"dev": "wrangler dev --local" "dev": "wrangler dev --local"

View File

@ -1,28 +1,34 @@
/** # Wrangler 配置 — MessageWeave 多实例 LB/HA(ARCH-LB-WORKER / deployment.md §10)。
* Wrangler 示例配置 — MessageWeave 多实例 LB/HA(ARCH-LB-WORKER / deployment.md §10)。 #
* # 注意:TOML 只支持 '#' 注释。这里曾经用 JSDoc 的 /** */ 块,Cloudflare 的 TOML
* 安全约束(docs/charter.md §3/§5,稳定 ID 注册表 §8): # 解析器会把 '*' 当成未知字符(wrangler 报 Unknown character "47"),deploy /
* - 后端 origin 仅允许 https(C-HTTPS-INBOUND / C-HTTPS-URL);env 校验时拒绝 # secret put / dev 在读取配置文件时就失败——所以全部展开成 '#' 行。
* http/非 https/内嵌凭据。 #
* - 不代理 Redis/JMAP(C-NO-DB / C-REDIS-ONLY-STATE):Worker 只做请求转发,后端连自己的 Redis。 # 安全约束(docs/charter.md §3/§5,稳定 ID 注册表 §8):
* - 不使用 WebSocket/SSE/长轮询(C-NO-LONG-CONN):纯请求-响应转发。 # - 后端 origin 仅允许 https(C-HTTPS-INBOUND / C-HTTPS-URL);env 校验时拒绝
* - 后端 secret 走 `wrangler secret`(见 README),不进代码/日志(SAF-LOG-PURITY / C-NO-SECRET-IN-IMAGE; # http/非 https/内嵌凭据。
* C-LB-SHARED-SECRETS:所有后端实例共享同一组 secret)。 # - 不代理 Redis/JMAP(C-NO-DB / C-REDIS-ONLY-STATE):Worker 只做请求转发,后端连自己的 Redis。
* - 日志无密钥(SAF-LOG-PURITY):只打「方法/路径/origin/失败类别」,origin 清单走 secret。 # - 不使用 WebSocket/SSE/长轮询(C-NO-LONG-CONN):纯请求-响应转发。
* - 仅允许转发 safelist 路由(C-LB-SINGLE-REG-URL);未知路径 404。 # - 后端 secret 走 `wrangler secret`(见 README),不进代码/日志(SAF-LOG-PURITY / C-NO-SECRET-IN-IMAGE;
* # C-LB-SHARED-SECRETS:所有后端实例共享同一组 secret)。
* 部署: # - 日志无密钥(SAF-LOG-PURITY):只打「方法/路径/origin/失败类别」,origin 清单走 secret。
* cd cloudflare-worker # - 仅允许转发 safelist 路由(C-LB-SINGLE-REG-URL);未知路径 404。
* npx wrangler secret put BACKEND_ORIGINS_JSON # 见下方示例格式 #
* npx wrangler deploy # 部署:
*/ # cd cloudflare-worker
# npx wrangler secret put BACKEND_ORIGINS_JSON # 见下方示例格式
# npx wrangler deploy
name = "messageweave-lb" name = "messageweave-lb"
main = "src/index.js" main = "src/index.js"
compatibility_date = "2025-01-01" compatibility_date = "2025-01-01"
compatibility_flags = ["nodejs_compat_v2"] compatibility_flags = ["nodejs_compat_v2"]
# 统一 HTTPS 入站(C-HTTPS-URL;平台代 TLS,Worker 内为短请求模型)。 # 统一 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"] # BACKEND_ORIGINS_JSON 形如 ["https://a.platform1.example","https://b.platform2.example"]
# LB_HEALTH_TTL_MS 可选,健康缓存 TTL(默认 30000) # LB_HEALTH_TTL_MS 可选,健康缓存 TTL(默认 30000)
# LB_REQUEST_TIMEOUT_MS 可选,单 origin 超时(默认 10000,建议 > 最坏 cold start) # LB_REQUEST_TIMEOUT_MS 可选,单 origin 超时(默认 10000,建议 > 最坏 cold start)