Files
agent/app/server/routes/mcp-uploads.js
T
kicer f84afe4246 部署:合并为单网络 + 新增 /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)
2026-09-15 19:40:34 +08:00

86 lines
3.8 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 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 };