video_gen: 丢掉上传/落盘整套,本地图片改由 agent 内网现签公网链接
- 删除 POST /upload、GET /uploads/*、multer、上传目录与 TTL 清理、公网只读监听(PUBLIC_PORT/3001) - 删除 UPLOAD_BASE_URL / PUBLIC_BASE_URL / UPLOAD_DIR,改为单一个 PUBLIC_LINK_URL: 工具描述里给的命令变成 curl -s "<PUBLIC_LINK_URL>?path=<绝对路径>",stdout 即现成 URL - package.json: 去掉 multer 依赖;Dockerfile: EXPOSE 3000,去掉 3001 与上传说明 - docker-compose.yml: 去掉 ./uploads 挂载与相关 env,只留 PUBLIC_LINK_URL - .gitignore: 去掉 uploads/ - 文档: 根 README 与 video_gen README 改写「图片怎么到智谱手上」(零拷贝 + 签名链接)
This commit is contained in:
+23
-26
@@ -6,10 +6,11 @@
|
||||
|---|---|---|---|---|
|
||||
| `web_search/` | `mcp_web_search` | 免费网页搜索(Parallel / Exa,无需 key) | `3000` | `POST /` |
|
||||
| `image_gen/` | `mcp_image_gen` | 智谱 CogView 图片生成 | `3000` | `POST /mcp` |
|
||||
| `video_gen/` | `mcp_video_gen` | 智谱 CogVideo 视频生成(异步)+ 图片上传 | `3000` 全量 / `3001` 只读 | `POST /mcp` |
|
||||
| `video_gen/` | `mcp_video_gen` | 智谱 CogVideo 视频生成(异步) | `3000` | `POST /mcp` |
|
||||
|
||||
**这些服务默认不占宿主机端口**——它们只挂在 `my-app-network` 上,由 `agent-core` / `agent-executor`
|
||||
**这些服务一个宿主机端口都不占**——它们只挂在 `my-app-network` 上,由 `agent-core` / `agent-executor`
|
||||
按容器名访问。所以整台服务器对外只需要开 agent-core 那一个端口(`AGENT_PORT`,默认 8090)。
|
||||
(要从宿主机 curl 调试时,把 `docker-compose.yml` 里对应服务注释掉的 `ports` 两行打开。)
|
||||
|
||||
## 部署(无 nginx-proxy)
|
||||
|
||||
@@ -35,33 +36,32 @@ cd /root/workspace/tools/mcp && docker compose up -d --build
|
||||
|
||||
| 变量 | 默认 | 说明 |
|
||||
|---|---|---|
|
||||
| `PUBLIC_BASE_URL` | `http://localhost:8090/mcp-uploads` | **必须改**。video_gen `/upload` 返回给智谱的 URL 前缀,指向 agent-core 的只读中转;无域名时填 `http://<服务器IP>:<AGENT_PORT>/mcp-uploads` |
|
||||
| `PUBLIC_LINK_URL` | `http://agent-core:8081/public-link` | video_gen 用:告诉 AI「本地图片怎么换成公网 URL」的 agent 内网签发入口 |
|
||||
| `WEB_SEARCH_PORT` | `8081` | 只在临时打开 web_search 调试端口时用 |
|
||||
| `IMAGE_GEN_PORT` | `8082` | 只在临时打开 image_gen 调试端口时用 |
|
||||
| `VIDEO_GEN_PORT` | `8083` | 只在临时打开 video_gen 调试端口(只读监听)时用 |
|
||||
| `VIDEO_GEN_PORT` | `8083` | 只在临时打开 video_gen 调试端口(MCP 口,仅本机短时调试)时用 |
|
||||
|
||||
## 图片是怎么到智谱手上的(video_gen 特有)
|
||||
## 图片是怎么到智谱手上的(只有 video_gen 关心)
|
||||
|
||||
只有 `video_gen` 需要一个"公网可达的地址",因为智谱服务器生成视频前要**自己来拉这张参考图**,
|
||||
它不带 cookie、不带 `Authorization`。链路是:
|
||||
智谱服务器生成视频前要**自己来拉参考图**,它不带 cookie、不带 `Authorization`。这套链路里**没有任何人上传文件**:
|
||||
|
||||
```
|
||||
AI(agent-executor 内执行 curl)
|
||||
│ POST /upload(走 docker 内网,不经过公网)
|
||||
▼
|
||||
mcp_video_gen:3000 ──存储──► ./uploads/<randomUUID>.png
|
||||
│ 返回 url = PUBLIC_BASE_URL + /uploads/<name>
|
||||
▼
|
||||
视频任务提交给智谱,image_url 就是上面那个 url
|
||||
│
|
||||
▼
|
||||
智谱 ──匿名 GET──► http://<服务器IP>:8090/mcp-uploads/uploads/<name>
|
||||
│ agent-core 只转发 GET/HEAD
|
||||
▼
|
||||
mcp_video_gen:3001(只读监听,那边没有任何写路由)
|
||||
AI(agent 的 executor 沙箱里)
|
||||
│ curl -s "http://agent-core:8081/public-link?path=/workspace/tasks/<会话>/foo.png"
|
||||
▼
|
||||
agent-core :8081(内网、不映射宿主机 -> 无需凭据)
|
||||
│ 现签一条签名下载链接(HMAC,含会话/路径/过期时间)
|
||||
▼
|
||||
AI 把拿到的 URL 当 image_url 交给 video_gen:3000/mcp
|
||||
│
|
||||
▼
|
||||
智谱 ──匿名 GET──► http://<服务器IP>:8090/api/sessions/<会话>/files/download-name/…&t=…
|
||||
那个文件始终躺在 agent 的任务目录里,零拷贝
|
||||
```
|
||||
|
||||
所以:**写路径(`POST /upload`)永远不出公网**,公网只暴露一个只读、不可枚举、24h 过期的下载路径。
|
||||
- 链接:不可猜(HMAC)、会过期(默认 30 分钟)、绑会话、agent 重启即全部失效。
|
||||
- 前提:agent 侧 `config.yml` 配了 `public_link.base_url`(就是那个对外地址),否则签发端口不启动。
|
||||
- 唯一公网可达的东西是 agent 的 8090,以及那条**签名**下载路径;mcp 这三家一个端口都不露。
|
||||
|
||||
## 端口与安全
|
||||
|
||||
@@ -69,16 +69,13 @@ mcp_video_gen:3000 ──存储──► ./uploads/<randomUUID>.png
|
||||
|---|---|---|
|
||||
| `mcp_web_search` | 无 | 服务端无鉴权,**永远不要映射出去**(会被白嫖搜索额度);agent 走内网访问 |
|
||||
| `mcp_image_gen` | 无 | token 由调用方自带,暴露后可被拿去消耗你的智谱额度 |
|
||||
| `mcp_video_gen` | 无 | 只读路径已经由 agent-core 的 `/mcp-uploads` 代拉,无需自己占端口 |
|
||||
|
||||
需要从宿主机直接 curl 调试时,去 `docker-compose.yml` 把对应服务注释掉的 `ports` 两行打开
|
||||
(video_gen 那个映的是只读监听 3001,不会暴露 `POST /upload`),调试完记得再注释回去。
|
||||
`video_gen` 的用户上传文件落在宿主 `./uploads/`(已 gitignore,24h 自动清理)。
|
||||
| `mcp_video_gen` | 无 | 它需要的公网下载路径由 agent 的签名链接提供,自己不占端口 |
|
||||
|
||||
## 单独调试
|
||||
|
||||
```bash
|
||||
docker compose up -d --build mcp_web_search
|
||||
# 不占端口的健康检查
|
||||
docker exec mcp_web_search node -e "fetch('http://localhost:3000/health').then(r=>r.text()).then(console.log)"
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user