- 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 同步文件树/时序图/约束
47 lines
1.8 KiB
JavaScript
47 lines
1.8 KiB
JavaScript
// 临时链接签名(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 };
|