部署:合并为单网络 + 新增 /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` 放行,生产不得设置。
|
||||
|
||||
+22
-1
@@ -80,7 +80,28 @@ docker compose logs -f agent-core # 看到 "Agent server listening on 8080"
|
||||
浏览器打开 **`http://<服务器IP>:8090`**(端口可用 `.env` 里的 `AGENT_PORT` 改)。
|
||||
登录用第 2 步 `auth.users` 里配的账号。
|
||||
|
||||
对外只需放行这一个端口:`agent-executor`(9000)只在 `agent-internal` 内网,没有映射到宿主机。
|
||||
**对外只需要放行这一个端口**:`agent-executor`(9000)和 mcp 的三个服务都只在 `my-app-network`
|
||||
内网,没有映射到宿主机(需要从宿主机 curl 调试时,去 mcp 仓库的 `docker-compose.yml` 里临时
|
||||
把对应服务的 `ports` 两行取消注释)。
|
||||
|
||||
### 4.1 图片中转(只有图生视频会用到)
|
||||
|
||||
智谱服务器生成视频前要回来拉参考图,它不带 cookie、不带 `Authorization`,必须公网匿名可达。
|
||||
而 video_gen 不该为此占一个公网端口(那样它的 `POST /upload` 也会一起暴露),所以由 core 代拉:
|
||||
|
||||
```
|
||||
智谱 ──匿名 GET──► http://<服务器IP>:8090/mcp-uploads/uploads/<随机文件名>
|
||||
│ core 只转发 GET/HEAD
|
||||
▼
|
||||
mcp_video_gen:3001 ← video_gen 的只读监听(那边压根没有 /upload)
|
||||
```
|
||||
|
||||
- AI 上传图片走的是**内网** `http://mcp_video_gen:3000/upload`,写路径从不经过公网。
|
||||
- core 侧由 `MCP_UPLOADS_URL=http://mcp_video_gen:3001` 开启这条中转(compose 已配好);
|
||||
留空则 `/mcp-uploads/*` 这条路由不存在。
|
||||
- mcp 侧必须把 `PUBLIC_BASE_URL` 设成 `http://<服务器IP>:<AGENT_PORT>/mcp-uploads`,
|
||||
否则返回给智谱的地址不对,图生视频会失败(video_gen 启动日志会打印两个实际生效的地址,便于核对)。
|
||||
- 这条路径**匿名可读**:内容不可枚举(文件名是 randomUUID)、24h 后自动删除、只读不能写。
|
||||
|
||||
## 5. 没有 HTTPS 的影响(可忽略,仅记录)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user