Files
agent/app/server/routes/public-files.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

39 lines
1.6 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.
// 公网临时文件的取用端点:GET /p/<id>(id 由内置工具 mint_public_link 在 core 进程内现签)。
//
// 这一跳的访问者是**外部服务**(如智谱服务器来拉参考图),它不带 cookie、不带 Authorization,
// 所以必须匿名可达。安全性完全来自:
// 1. id 是 22 字符随机串(crypto.randomBytes(16) base64url),不可枚举;
// 2. 服务端按时过期(public_link.ttl_ms),过期即 404;
// 3. 只吐"签发时已校验过、且落在该会话任务目录内"的文件,这里再用 resolveInTask 复核一次。
//
// 挂在 auth.middleware **之前**(server.js),所以登录与否都能访问;未命中一律 404,不吐内部信息。
'use strict';
const fs = require('fs');
const express = require('express');
const engine = require('../engine');
const publicFiles = require('../public-files');
const { resolveInTask } = require('../tools/executor');
const { sendDownload } = require('../download-send');
const log = require('../log');
const router = express.Router();
router.get('/:id', function (req, res) {
const entry = publicFiles.resolve(req.params.id);
if (!entry) return res.status(404).type('text/plain').send('not found or expired\n');
let abs;
try {
abs = resolveInTask(engine.taskDirOf(entry.sessionId), entry.rel);
if (!fs.statSync(abs).isFile()) throw new Error('not a file');
} catch (_) {
return res.status(404).type('text/plain').send('not found\n');
}
log.info('public-file', entry.sessionId + ' 外部取用:' + entry.rel);
sendDownload(res, abs);
});
module.exports = router;