Skip to content

fix: 大脑代理不再自开端口,改走宿主 webServer 并接准入判决 - #9

Merged
modusensus merged 2 commits into
mainfrom
fix/brain-proxy-auth
Nov 13, 2026
Merged

modusensus merged 2 commits into
mainfrom
fix/brain-proxy-auth

Conversation

@modusensus

Copy link
Copy Markdown
Member

为什么改

语音通话的「大脑代理」原先在自己开的端口上提供 OpenAI 兼容接口(127.0.0.1:8765/v1/chat/completions),唯一的防护是「绑了回环地址」。这挡得住外部主机,挡不住本机浏览器里任意一个网页:跨站 POST 打到 127.0.0.1 是能出网的,服务端既不查 Origin 也不要凭据,等于把用户的模型额度公开给每一个打开的标签页。

这是在 dshopen.org 收录审核 里被指出来的(维护者 polang233),本次按其建议的修法改。

怎么改的

以前是 http.createServer 加 server.listen(cfg.port, '127.0.0.1'),handler 只判「是不是 POST + 路径对不对」,然后就调模型。

现在这个 server 没了。改为向宿主 webServer 注册一条 exact 路由 /cura/v1/chat/completions,每个请求先过 brain.authorize:

顺序 判定 结果
1 sec-fetch-site: cross-site 403,先拦再说
2 Authorization: Bearer <token> 命中 放行(本机 Python 引擎走这条)
3 connection.requestRejection(request) 返回 undefined 放行(浏览器带会话凭据)
4 requestRejection 返回 401 / 403 原样透出
5 connection 服务缺失 / 没有这个方法 / 调用抛错 503 fail closed

token 是每次启动现生成的 32 字节随机数,只在进程内存里,不落盘(tests/test-brain.mjs 会 grep 源码确认没有 writeFileSync)。

准入在调模型之前完成:被拒的请求连 chatViaDsh 都不会进。测试用一个计数桩断言「无凭据请求到达时 chat 调用次数为 0」,而不是只看返回码。

连带的必要改动

改动 为什么
port 配置项默认值改 0、标记废弃 不再监听任何端口,留着这个字段只会让人以为还能改
引擎改读 CURA_BRAIN_URL / CURA_BRAIN_TOKEN 宿主 webServer 的端口由宿主决定,插件不能写死;token 也只能由插件交给引擎
引擎启动等宿主 webServer 绑定端口(最多 20 秒) getOrigin() 在 listener 绑定前会抛,早启动就成了连不上大脑的哑巴进程;等不到时明确记一条日志,不静默
面板的大脑代理信息改从 getOrigin() 取 原来读的是自己那个已废弃的 port,会显示一个根本没人监听的端口
出行探针 clientInfo.version 改读 package.json 手抄的 0.9.0 连着三个版本没跟上,顺带修掉

怎么验证的

真机(重启后的 DSH,不是模拟):

探测 结果
netstat 查 8765 无监听
POST /cura/v1/chat/completions 无凭据 401
同上 + sec-fetch-site: cross-site 403
老地址 127.0.0.1:8765 连不上

自动化:新增 tests/test-brain.mjs(312 行、六组),其中一组真起 http server 打请求——无凭据→503/401 且 chat 调用为 0、跨站带对 token 仍 403、GET→405、坏 JSON→400、超 1MB→413、上游 503 透传、connection 放行→200。

变异自证 8/8 全被抓住:跨站检查失效、服务缺失 fail open、先调模型再判准入、跨站只在没 token 时拦、任意 token 都算对、超大体不拦、错误一律 502、引擎不等地址就启动。

全套 9 套测试通过(Node 20 / 22 双档)。

发版

本分支带上版本号 0.9.2 与 release-notes/v0.9.2.md。合并后打 v0.9.2 标签即可自动发版——npm 上的 0.9.1 仍是带洞的旧代码。

已知影响

  • 单独跑 engine/engine.py 时不能再指向 /cura/v1(那条路由要插件进程内的 token,会 401);插件托管启动不受影响。
  • 顺带修了 tests/test-remote.mjs 在 Windows 上偶发「全绿但退出码 3221226505」的问题:探活读完 headers 后释放 body,不留 socket 给 GC。

原先插件自己 http.createServer 监听 127.0.0.1:8765 提供 OpenAI 兼容的
/v1/chat/completions,只有「绑定回环地址」这一层防护:本机任意网页都能
直接 POST 打进来消耗模型额度,服务端不查来源、不要凭据。

改成挂在宿主 webServer 上:
- 路由 /cura/v1/chat/completions 用 exact 注册,路径落在插件自己的命名
  空间,不和宿主 /api 抢。
- 每个请求先过 BRAIN.authorize:跨站一律 403;本机 Python 引擎用插件
  进程内现生成的 bearer token(不落盘);其余交给
  connection.requestRejection 判决。
- 服务缺失或判决抛错时 fail closed 返回 503,不放行。
- 准入在调模型之前完成,被拒的请求不会碰到 llm。

连带改动:
- port 配置项默认值改为 0 并标记废弃,不再监听任何端口。
- 引擎改由 CURA_BRAIN_URL / CURA_BRAIN_TOKEN 拿地址与凭据,config.json
  里填的 baseUrl 只用于用户自带端点。
- 引擎启动等宿主 webServer 就绪(最多 20 秒),拿不到地址就不启动,
  免得拉起来连不上大脑。
- 面板的大脑代理信息改从 webServer.getOrigin() 取,不再显示假端口。

测试:新增 tests/test-brain.mjs 五组,含真起 server 打请求的端到端用例;
全套 9 套通过。
带上这次安全修复:大脑代理不再自开 8765 端口,改走宿主 webServer。

发版前顺手清掉两处会误导人的旧事实:
- 出行探针的 clientInfo 版本从手抄的 0.9.0 改为读 package.json,
  之前三个版本都没跟上,高德收到的客户端版本一直是错的;补了断言。
- 面板探活读完响应后主动释放 body。原先只顾拿 headers,socket 留到
  GC 才关,Windows 上进程退出会撞 uv 的 closing 断言,退出码成了
  3221226505——测试全绿却显示「1 套失败」,本地偶发。

Release 正文写在 release-notes/v0.9.2.md,四段骨架由脚本生成。
@modusensus
modusensus merged commit 64dcd8b into main Nov 13, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant