Repository navigation
fix: 大脑代理不再自开端口,改走宿主 webServer 并接准入判决 - #9
Merged
Merged
Conversation
原先插件自己 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,四段骨架由脚本生成。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
为什么改
语音通话的「大脑代理」原先在自己开的端口上提供 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:sec-fetch-site: cross-siteAuthorization: Bearer <token>命中connection.requestRejection(request)返回 undefinedrequestRejection返回 401 / 403token 是每次启动现生成的 32 字节随机数,只在进程内存里,不落盘(
tests/test-brain.mjs会 grep 源码确认没有writeFileSync)。准入在调模型之前完成:被拒的请求连
chatViaDsh都不会进。测试用一个计数桩断言「无凭据请求到达时 chat 调用次数为 0」,而不是只看返回码。连带的必要改动
port配置项默认值改 0、标记废弃CURA_BRAIN_URL/CURA_BRAIN_TOKENgetOrigin()在 listener 绑定前会抛,早启动就成了连不上大脑的哑巴进程;等不到时明确记一条日志,不静默getOrigin()取port,会显示一个根本没人监听的端口clientInfo.version改读package.json0.9.0连着三个版本没跟上,顺带修掉怎么验证的
真机(重启后的 DSH,不是模拟):
netstat查 8765POST /cura/v1/chat/completions无凭据sec-fetch-site: cross-site127.0.0.1:8765自动化:新增
tests/test-brain.mjs(312 行、六组),其中一组真起httpserver 打请求——无凭据→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。