Files
agent/app/server/download-token.js
T
kicer 70779e843e 公网链接改为内网现签:新增 /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 同步文件树/时序图/约束
2026-09-15 19:57:37 +08:00

47 lines
1.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.
// 临时链接签名(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 };