Files
agent/app/server/download-token.js
T
kicer b65485b7e5 新增内置工具 mint_public_link,退役内网签发端口 8081
- mint_public_link:AI 只传文件名,core 在进程内直接 publicFiles.mint() 签出短命公网链接,返回单行 URL;校验 = base_url 已配 + resolveInTask 沙箱 + 确认是文件 + realpath 未跳出任务
目录

    - 删除 routes/public-link.js 与 server.js 里的签发端口(PUBLIC_LINK_PORT/8081):该接口对 AI 已冗余(进程内签发不绕 HTTP,也不存在带不了凭据的问题);public_link 配置项收窄为 mint_public_link 的开关,不再监听额外端口

    - 跟进:definitions.json/HANDLERS 注册;config.example.yml、config.js、public-files.js、download-token.js、routes/files.js 注释;ARCHITECTURE(目录树/部署图/关键约束/5.4 工具表)、DEPLOY 4.1、init.sh 自检改探 /p/<id>、两个 README(工具数 16、公网链接说明)

    - 注:docker-compose.yml 一并带上此前工作区的 VIRTUAL_HOST/my-app-network 改动
2026-09-17 20:12:56 +08:00

47 lines
1.7 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 的浏览器下载链接用)。
//
// 设计要点:
// - 密钥进程内随机:重启后所有旧链接自动失效。公网链接本来就该短命,这是免费拿到的性质。
// - 签名覆盖「会话 + 路径 + 过期时间」三项,任何一项被改都会验签失败;
// 验签用 timingSafeEqual,不做按字节比较的旁路。
// - 这里只提供"怎么签";"给谁签、能签什么"由调用方决定(见 routes/files.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 签发与验签都走它,避免两边写歪)
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 };