新增内置工具 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 改动
This commit is contained in:
@@ -90,8 +90,8 @@ router.get('/:id/files', function (req, res) {
|
||||
// 移动端浏览器 fetch+blob 下载会丢失文件名(uuid.bin);改为短时效签名链接,
|
||||
// 前端拿到后 window.location.href 导航下载,走原生下载流程。
|
||||
// 密钥随进程启动随机生成,重启后旧 token 自动失效。
|
||||
// 签名实现(密钥、报文形状、验签)统一在 ../download-token.js:
|
||||
// routes/public-link.js 给外部服务签的是同一种链接,两边共用一份形状,避免“签得出、验不过”。
|
||||
// 签名实现(密钥、报文形状、验签)统一在 ../download-token.js。
|
||||
// (外部服务取文件的 GET /p/<id> 是另一套机制:短 ID + 内存表,见 ../public-files.js。)
|
||||
const DOWNLOAD_TOKEN_TTL_MS = downloadToken.BROWSER_TTL_MS;
|
||||
const signDownloadToken = downloadToken.signDownload;
|
||||
const validDownloadToken = downloadToken.validDownload;
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
// 公网临时文件的取用端点:GET /p/<id>(id 由 routes/public-link.js 在内网现签)。
|
||||
// 公网临时文件的取用端点:GET /p/<id>(id 由内置工具 mint_public_link 在 core 进程内现签)。
|
||||
//
|
||||
// 这一跳的访问者是**外部服务**(如智谱服务器来拉参考图),它不带 cookie、不带 Authorization,
|
||||
// 所以必须匿名可达。安全性完全来自:
|
||||
|
||||
@@ -1,73 +0,0 @@
|
||||
// 公网临时链接签发(只在【内网监听】的端口上,见 server.js 里 PUBLIC_LINK_PORT 那段)。
|
||||
//
|
||||
// 用途:把任务目录里的文件变成一条短命的公网 URL,交给外部服务去取。第一个消费者是
|
||||
// MCP video_gen:智谱服务器生成视频前要自己来拉参考图,它不带 cookie、不带 Authorization,
|
||||
// 所以必须给它一条「不可猜 + 会过期」的链接。
|
||||
// 产出的形态是一个不透明短 ID(见 public-files.js 为什么不用签名 URL):
|
||||
// http://<IP>:8090/p/9fQ2mZ7xK4tR1vBn
|
||||
// 这解决的是:**沙箱里的 AI 怎么拿到一条公网链接**(签发接口要登录,executor 里没有凭据)。
|
||||
//
|
||||
// 为什么单独一个端口、且不映射到宿主机:
|
||||
// 这条接口没法用凭据保护(AI 的命令带不了凭据),那就干脆让外部**连都连不上**。
|
||||
// 鉴权靠网络边界(不 publish),不靠密钥 —— 比任何 token 都可靠,也不会把密钥漏到会话记录里。
|
||||
//
|
||||
// 边界(改这里务必保持):
|
||||
// 1. 只接受绝对路径,且必须落在 workspace_root 内;再反查会话表确认会话真实存在。
|
||||
// 2. 取 realpath 复核仍在任务根内:挡住“先 ln -s 一个外泄目标,再签它的链接”。
|
||||
// 3. 只签“已存在且是文件”的路径;取用侧(routes/public-files.js)会再复核一次目录边界。
|
||||
// 4. 返回 text/plain 而不是 JSON:AI 用 `curl -s` 拿到的 stdout 就是现成 URL,免解析。
|
||||
'use strict';
|
||||
|
||||
const path = require('path');
|
||||
const fs = require('fs');
|
||||
const express = require('express');
|
||||
const engine = require('../engine');
|
||||
const publicFiles = require('../public-files');
|
||||
const log = require('../log');
|
||||
|
||||
const router = express.Router();
|
||||
|
||||
function bad(res, status, msg) {
|
||||
return res.status(status).type('text/plain').send('ERROR: ' + msg + '\n');
|
||||
}
|
||||
|
||||
router.get('/public-link', function (req, res) {
|
||||
const cfg = engine.getConfig();
|
||||
const pl = cfg.public_link || {};
|
||||
if (!pl.base_url) return bad(res, 503, 'public_link.base_url 未配置,无法签发公网链接');
|
||||
|
||||
const raw = String(req.query.path || '').trim();
|
||||
if (!raw) return bad(res, 400, '缺少 path 参数(要文件的绝对路径,如 /workspace/tasks/<会话>/foo.png)');
|
||||
if (!path.isAbsolute(raw)) return bad(res, 400, 'path 必须是绝对路径(与你在命令里看到的路径一致)');
|
||||
|
||||
const root = path.resolve(cfg.workspace_root);
|
||||
const abs = path.normalize(raw);
|
||||
if (abs !== root && abs.indexOf(root + path.sep) !== 0) {
|
||||
return bad(res, 400, 'path 必须位于任务根目录内:' + root);
|
||||
}
|
||||
|
||||
const rel = path.relative(root, abs);
|
||||
const sid = rel.split(path.sep)[0];
|
||||
const fileRel = rel.slice(sid.length + 1);
|
||||
if (!sid || !fileRel) return bad(res, 400, 'path 要指向会话目录下的某个文件,不能是目录本身');
|
||||
if (!engine.getSession(sid)) return bad(res, 404, '会话不存在:' + sid);
|
||||
|
||||
let real;
|
||||
try {
|
||||
if (!fs.statSync(abs).isFile()) return bad(res, 400, '不是文件:' + raw);
|
||||
real = fs.realpathSync(abs);
|
||||
} catch (_) {
|
||||
return bad(res, 404, '文件不存在:' + raw);
|
||||
}
|
||||
if (real !== abs && real.indexOf(fs.realpathSync(root) + path.sep) !== 0) {
|
||||
return bad(res, 400, 'path 经符号链接指向了任务根之外,拒绝签发');
|
||||
}
|
||||
|
||||
const id = publicFiles.mint({ sessionId: sid, rel: fileRel, ttlMs: pl.ttl_ms });
|
||||
const url = pl.base_url + '/p/' + id;
|
||||
|
||||
log.info('public-link', sid + ' 签发公网链接(' + Math.round(pl.ttl_ms / 60000) + ' 分钟):' + fileRel + ' → /p/' + id);
|
||||
res.type('text/plain').send(url + '\n');
|
||||
});
|
||||
|
||||
module.exports = router;
|
||||
Reference in New Issue
Block a user