公网链接改为内网现签:新增 /public-link 签发入口,删掉 /mcp-uploads 中转
- download-token.js(新): 从 files.js 抽出临时链接签名(密钥/报文形状/验签),浏览器下载与公网链接共用一份
- routes/public-link.js(新): GET /public-link?path=<绝对路径> 现签一条签名下载链接,
返回纯文本 URL(AI 直接 curl 取用,免解析 JSON)
边界:只收绝对路径 + workspace_root 前缀 + 会话表存在性 + realpath 复核(挡 ln -s 外泄)
- server.js: 该路由只挂在【不映射宿主机】的内网端口(PUBLIC_LINK_PORT,默认 8081),
因此不需要任何凭据 —— 鉴权靠网络边界而不是密钥,密钥也不会漏进会话记录
- server.js/routes: 删掉 mcp-uploads.js 及其挂载(上传中转整套作废)
- config.js/config.example.yml: 新增 public_link.{base_url,ttl_ms}(默认 30 分钟,夹 1min~24h)
- docker-compose.yml: 去掉 MCP_UPLOADS_URL
- 文档: DEPLOY.md 4.1 改写为「公网临时链接」;ARCHITECTURE.md 同步文件树/时序图/约束
This commit is contained in:
@@ -0,0 +1,46 @@
|
||||
// 临时链接签名(files.js 的浏览器下载链接、routes/public-link.js 的公网链接共用同一套)。
|
||||
//
|
||||
// 设计要点:
|
||||
// - 密钥进程内随机:重启后所有旧链接自动失效。公网链接本来就该短命,这是免费拿到的性质。
|
||||
// - 签名覆盖「会话 + 路径 + 过期时间」三项,任何一项被改都会验签失败;
|
||||
// 验签用 timingSafeEqual,不做按字节比较的旁路。
|
||||
// - 这里只提供"怎么签";"给谁签、能签什么"由调用方决定(见 routes/public-link.js 的边界校验)。
|
||||
'use strict';
|
||||
|
||||
const crypto = require('crypto');
|
||||
|
||||
const SECRET = crypto.randomBytes(32).toString('hex');
|
||||
|
||||
// 浏览器原生下载用:前端拿到后立刻 window.location.href 导航,5 分钟足够
|
||||
const BROWSER_TTL_MS = 5 * 60 * 1000;
|
||||
|
||||
function signPayload(payload) {
|
||||
return crypto.createHmac('sha256', SECRET).update(payload).digest('hex');
|
||||
}
|
||||
|
||||
function sameHex(a, b) {
|
||||
try {
|
||||
return crypto.timingSafeEqual(Buffer.from(String(a), 'utf8'), Buffer.from(String(b), 'utf8'));
|
||||
} catch (_) { return false; }
|
||||
}
|
||||
|
||||
function validPayload(payload, expires, t) {
|
||||
const exp = Number(expires);
|
||||
if (!t || !Number.isFinite(exp) || exp < Date.now()) return false;
|
||||
return sameHex(signPayload(payload), t);
|
||||
}
|
||||
|
||||
// 下载链接的报文形状(唯一一份;files.js 验签、public-link.js 签发都走它,避免两边写歪)
|
||||
function downloadPayload(sessionId, rel, expires) {
|
||||
return sessionId + '\n' + rel + '\n' + expires;
|
||||
}
|
||||
|
||||
function signDownload(sessionId, rel, expires) {
|
||||
return signPayload(downloadPayload(sessionId, rel, expires));
|
||||
}
|
||||
|
||||
function validDownload(sessionId, rel, expires, t) {
|
||||
return validPayload(downloadPayload(sessionId, rel, expires), expires, t);
|
||||
}
|
||||
|
||||
module.exports = { BROWSER_TTL_MS, signPayload, sameHex, validPayload, signDownload, validDownload };
|
||||
Reference in New Issue
Block a user