部署:合并为单网络 + 新增 /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:
2026-09-15 19:40:34 +08:00
parent 0fe621a0f4
commit f84afe4246
6 changed files with 137 additions and 11 deletions
+85
View File
@@ -0,0 +1,85 @@
// MCP 上传文件的公网只读中转(agent-core 侧)。
//
// 为什么需要这一层:
// 无域名部署时对外只开 agent-core 一个端口(AGENT_PORT,默认 8090)。但 video_gen 的
// /uploads/<file> 那一跳是【智谱的服务器】去拉的 —— 它不带 cookie、不带 Authorization,
// 必须是公网匿名可达。而 video_gen 自己不该占一个公网端口(那样它的 POST /upload 也会一起
// 暴露,写入口就跑到公网上了)。所以由 core 代拉:智谱拿到的地址是
// http://<服务器IP>:<AGENT_PORT>/mcp-uploads/uploads/<file>
// 这一跳只读、只走 video_gen 的【只读监听】(容器内 3001),写路径永远不经公网。
//
// 安全边界(改这里务必保持):
// 1. 只转发 GET/HEAD,其余方法一律 405:POST /upload 不可能从这个路由穿过去。
// 2. 上游固定为 video_gen 的只读监听(PUBLIC_PORT),那边压根没有 /upload 路由(纵深防御)。
// 3. 文件名只放行 video_gen 生成的形态(randomUUID + 可选后缀),挡住目录穿越与探测。
// 4. 本路由挂在 auth.middleware 之前(智谱不带凭据),因此是【匿名可读】的。
// 它等同于"随机文件名 + 有 TTL"的能力链接:不要在这里挂任何敏感或可枚举的东西。
'use strict';
const http = require('http');
const https = require('https');
const express = require('express');
const log = require('../log');
// video_gen 的文件名:randomUUID() + 可选扩展名(见 mcp/video_gen/src/mcp-server.js 的 multer storage)
const FILE_RE = /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/;
// 只透传与"取文件"有关的响应头,避免把上游的协商/凭据类头部带出去
const PASS_HEADERS = ['content-type', 'content-length', 'last-modified', 'etag', 'accept-ranges', 'content-range'];
// target 形如 http://mcp_video_gen:3001(环境变量 MCP_UPLOADS_URL)
function createRouter(target, options) {
const timeoutMs = (options && options.timeout_ms) || 30000;
const router = express.Router();
const base = new URL(target);
const client = base.protocol === 'https:' ? https : http;
const basePath = base.pathname.replace(/\/+$/, '');
function relay(req, res) {
const file = req.params.file;
if (!FILE_RE.test(file) || file.includes('..')) {
return res.status(400).json({ error: 'bad file name' });
}
const headers = {};
if (req.headers.range) headers.Range = req.headers.range; // 大图/视频拖动时支持分片
const up = client.request({
protocol: base.protocol,
hostname: base.hostname,
port: base.port,
method: req.method,
path: basePath + '/uploads/' + encodeURIComponent(file),
headers,
}, (upRes) => {
for (const h of PASS_HEADERS) {
if (upRes.headers[h] !== undefined) res.setHeader(h, upRes.headers[h]);
}
res.status(upRes.statusCode || 502);
upRes.pipe(res);
});
up.setTimeout(timeoutMs, () => up.destroy(new Error('upstream timeout')));
up.on('error', (err) => {
if (res.headersSent) return res.destroy();
// 只说地址不通,不把上游内部细节吐给公网
log.warn('mcp-uploads', '中转失败 ' + file + ': ' + err.message);
res.status(502).json({ error: 'upstream unavailable' });
});
req.pipe(up);
}
router.get('/uploads/:file', relay);
router.head('/uploads/:file', relay);
// 其余方法/路径一律就地回掉,别落到后面的登录中间件上(那样智谱会拿到 401 页面而不是 404)
router.use((req, res) => {
if (/^\/uploads\/[^/]+$/.test(req.path)) {
res.set('Allow', 'GET, HEAD');
return res.status(405).json({ error: 'method not allowed' });
}
res.status(404).json({ error: 'not found' });
});
return router;
}
module.exports = { createRouter };