部署:合并为单网络 + 新增 /mcp-uploads 公网只读中转(对外只开一个端口)
- docker-compose: 删掉 agent-internal,core/executor/init 全部只挂 my-app-network (executor 需要按容器名访问 mcp,两个网络已无隔离意义) - docker-compose: 新增 MCP_UPLOADS_URL=http://mcp_video_gen:3001 开关中转路由 - routes/mcp-uploads.js(新): GET/HEAD /mcp-uploads/uploads/<file> → video_gen 只读监听 挂在 auth.middleware 之前(智谱拉图不带凭据);只转 GET/HEAD,写路径不经公网; 文件名白名单挡目录穿越;上游不可用回 502 - server.js: 装配上述路由 - 文档: DEPLOY.md 新增 4.1「图片中转」、ARCHITECTURE.md 补反向入站链路与单网络约束 - 已用一次性 harness 验证 15 项(含 POST/PUT/DELETE 一律 405、/mcp-uploads/upload 404、 穿越文件名 400、上游只收到 GET/HEAD)
This commit is contained in:
+10
-1
@@ -48,6 +48,7 @@ agent/
|
||||
│ │ │ ├── config.js /api/config 读写(含 api_key/password 脱敏)
|
||||
│ │ │ ├── platforms.js /api/platforms/balance 余额查询
|
||||
│ │ │ ├── skills.js /api/skills 技能文件管理
|
||||
│ │ │ ├── mcp-uploads.js /mcp-uploads/uploads/* 公网只读中转(智能服务器拉图用)
|
||||
│ │ │ └── system.js /api/system/status + /restart 优雅重启
|
||||
│ │ ├── templates/
|
||||
│ │ │ └── system-prompt.txt system prompt 静态模板(每次请求复用,利于上游前缀缓存)
|
||||
@@ -87,6 +88,7 @@ graph LR
|
||||
Core[agent-core<br/>宿主机 8090]
|
||||
Exec[agent-executor<br/>:9000 内网]
|
||||
MCP[MCP 服务<br/>my-app-network]
|
||||
Zhipu[智谱服务器]
|
||||
LLM[LLM 池<br/>OpenAI 兼容]
|
||||
Tasks[./tasks<br/>任务目录 bind mount]
|
||||
Skills[./skills<br/>技能目录 bind mount]
|
||||
@@ -96,6 +98,9 @@ graph LR
|
||||
Core -->|SSE /exec| Exec
|
||||
Core -->|POST /chat/completions| LLM
|
||||
Core -->|tools/call| MCP
|
||||
MCP -->|提交任务| Zhipu
|
||||
Zhipu -->|匿名 GET 拉参考图| Core
|
||||
Core -->|只读转发 GET /uploads/*| MCP
|
||||
Core <-->|读写| Tasks
|
||||
Exec <-->|读写| Tasks
|
||||
Core <-->|技能 + deps| Skills
|
||||
@@ -103,11 +108,15 @@ graph LR
|
||||
Core --> DB
|
||||
```
|
||||
|
||||
两个容器通过 `agent-internal` 内网 bridge 通信;外网只暴露 Core(宿主机端口映射)。
|
||||
所有容器都在同一个 `my-app-network` 上(core 与 executor 同时靠它访问 MCP);外网只暴露 Core
|
||||
(宿主机端口映射)。注意其中一条**反向**的入站链路:智谱服务器来拉参考图时,走的是 Core 的
|
||||
`/mcp-uploads/uploads/*` 只读中转(详见下面约束)。
|
||||
|
||||
**关键约束**(改 compose 时务必保持):
|
||||
|
||||
- 全部容器同一个网络 `my-app-network`(由本仓库 compose 创建,mcp 侧 external 加入)——core 靠它访问 MCP 服务,executor 靠它把本地图片上传给 video_gen。
|
||||
- `agent-core` 与 `agent-executor` 须把**同一份宿主机 `./tasks`、`./skills`**挂到相同的容器路径(默认 `/workspace/tasks`、`/workspace/skills`)。这是文件工具在 Core 本地直接读、命令在远端写,二者能"看到"彼此产物的根本约定。
|
||||
- **`/mcp-uploads/*` 是 Core 上唯一匿名可读的路由**(`routes/mcp-uploads.js`),只为让智谱服务器拉到参考图而存在:必须挂在 `auth.middleware` **之前**,且只转发 GET/HEAD 到 video_gen 的**只读监听**(不转写路径)。该路由本身就是“随机文件名 + TTL”的能力链接,往里加任何敏感/可枚举的东西都是错。未配 `MCP_UPLOADS_URL` 则不挂该路由。
|
||||
- nginx-proxy 前置时**必须 `proxy_buffering off`**,否则 SSE 流被缓冲。详见 `docs/DEPLOY.md`。
|
||||
- Core 通过环境变量 `EXECUTOR_URL` / `EXECUTOR_TOKEN` 注入 executor 端点(也可用 `config.yml` 的 `executor` 段覆盖)。**token 从 `.env` 读取**(compose 变量替换 `${EXECUTOR_TOKEN:?...}`,未设置直接报错,杜绝静默无鉴权);`.env` 已 gitignore,模板见 `.env.example`,生成:`openssl rand -hex 32`。
|
||||
- Executor **拒绝来自容器自身(回环/本机网卡)的 `/exec`**:隔离只 unshare mount+pid,命令与 executor 同 net ns,能打到 `127.0.0.1:9000`;据此即使 token 泄漏也无法在会话内调用 `/exec` 越权读他人会话(core 在另一容器,不受影响)。本机集成测试用 `EXECUTOR_ALLOW_LOCAL_ORIGIN=1` 放行,生产不得设置。
|
||||
|
||||
Reference in New Issue
Block a user