diff --git a/app/config.example.yml b/app/config.example.yml index 7ec707c..ef8802d 100644 --- a/app/config.example.yml +++ b/app/config.example.yml @@ -62,6 +62,8 @@ data_root: "./data" # 短命的公网下载链接(复用登录下载那套签名:不可猜 / 会过期 / 绑会话 / 重启即全部失效)。 # base_url 填本服务的对外地址(就是浏览器访问的 http://<服务器IP>:),只用于拼绝对地址; # 留空 = 该功能整体关闭(对应 MCP 服务里需要公网 URL 的那部分就用不了)。 +# 容器 env 里配了 VIRTUAL_HOST(nginx-proxy 域名 + HTTPS 那套)时,本项会被它盖住:链接前缀直接用 +# https://<第一个域名>,不需要改这里(也避开了“重跑 init 脚本又把它写回 ip:port”的麻烦)。 public_link: base_url: "" # 例:"http://1.2.3.4:8090" ttl_ms: 1800000 # 选填:链接有效期,默认 30 分钟(代码里夹在 1 分钟 ~ 24 小时) diff --git a/app/server/config.js b/app/server/config.js index 0bab7bb..59287ec 100644 --- a/app/server/config.js +++ b/app/server/config.js @@ -248,10 +248,20 @@ function parseAndValidate(rawText, configPath) { // 公网临时链接(public_link)规范化:base_url 去尾斜杠;ttl_ms 夹在 [1min, 24h]—— // 公网链接宁可短不可长(“永久公开”正是这套机制要避免的东西)。 +// +// 对外前缀的取值优先级: +// 1) 容器 env 的 VIRTUAL_HOST 非空 → https://<第一个域名> +// (nginx-proxy 的写法,逗号分隔多域名时取第一个)。只要配了域名 + HTTPS 这一层, +// 返回给外部服务(video_gen 取参考图)的链接就必须走域名,所以 env 优先; +// 反之 config.yml 里那个 init 脚本生成的 http://:8090 会把这个开关盖住。 +// 协议写死 https:前置了 nginx-proxy 一定是 HTTPS(证书由 acme-companion 签)。 +// 2) 否则用 config.yml 的 public_link.base_url(纯 IP:端口部署,init 脚本写 http://:8090)。 function normalizePublicLink(cfg) { const pl = cfg.public_link || {}; + const vhost = String(process.env.VIRTUAL_HOST || '').split(',')[0].trim(); + const baseUrl = vhost ? 'https://' + vhost : pl.base_url; cfg.public_link = { - base_url: String(pl.base_url || '').trim().replace(/\/+$/, ''), + base_url: String(baseUrl || '').trim().replace(/\/+$/, ''), ttl_ms: Math.min(Math.max(Number(pl.ttl_ms) || 1800000, 60 * 1000), 24 * 3600 * 1000), }; if (cfg.public_link.base_url && !/^https?:\/\//i.test(cfg.public_link.base_url)) { diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 555cfb4..f27fc1b 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -125,7 +125,7 @@ graph LR - `agent-core` 与 `agent-executor` 须把**同一份宿主机 `./tasks`、`./skills`**挂到相同的容器路径(默认 `/workspace/tasks`、`/workspace/skills`)。这是文件工具在 Core 本地直接读、命令在远端写,二者能"看到"彼此产物的根本约定。 - **两条公网文件路径分工别搞混**:浏览器原生下载走 `download-token.js` 的签名链接(前端用 `download-token` 接口换 URL,`auth.js` 的 `isSignedDownload` 放行 `?t=`);外部服务取文件走 `GET /p/` 短 ID。前者需要在 URL 末段带文件名(给安卓下载器猜名),后者刻意不带文件名/会话名。 - **`routes/public-link.js` 只挂在【不映射宿主机】的内网端口上**(`PUBLIC_LINK_PORT`,默认 8081):它不需要凭据(沙箱里的 AI 带不了凭据),所以安全性完全依赖“外部连不上这个端口”。**绝不要**把它挂到对外的 8090 上,也不要 publish 该端口。 -- `GET /p/` 是 Core 上唯一的匿名读取入口:安全性 = 22 字符随机 ID + 服务端过期(`public-files.js` 的内存表)。它**必须挂在 `auth.middleware` 之前**,未命中/过期一律 404。签发侧仍要做路径校验(`workspace_root` 前缀 + 会话表 + realpath 复核,挡 `ln -s` 外泄);未配 `public_link.base_url` 则不启动签发端口。 +- `GET /p/` 是 Core 上唯一的匿名读取入口:安全性 = 22 字符随机 ID + 服务端过期(`public-files.js` 的内存表)。它**必须挂在 `auth.middleware` 之前**,未命中/过期一律 404。签发侧仍要做路径校验(`workspace_root` 前缀 + 会话表 + realpath 复核,挡 `ln -s` 外泄);未配 `public_link.base_url`(且容器 env 没给 `VIRTUAL_HOST`)则不启动签发端口:配了 `VIRTUAL_HOST`(nginx-proxy 域名 + HTTPS)时,前缀自动用 `https://<第一个域名>`,env 优先于 config.yml。 - nginx-proxy 前置时**必须 `proxy_buffering off`**,否则 SSE 流被缓冲。详见 `docs/DEPLOY.md`。 - Core 通过环境变量 `EXECUTOR_URL` / `EXECUTOR_TOKEN` 注入 executor 端点(也可用 `config.yml` 的 `executor` 段覆盖)。**token 从 `.env` 读取**(compose 变量替换 `${EXECUTOR_TOKEN:?...}`,未设置直接报错,杜绝静默无鉴权);`.env` 已 gitignore,模板见 `.env.example`,生成:`openssl rand -hex 32`。 - Executor **拒绝来自容器自身(回环/本机网卡)的 `/exec`**:隔离只 unshare mount+pid,命令与 executor 同 net ns,能打到 `127.0.0.1:9000`;据此即使 token 泄漏也无法在会话内调用 `/exec` 越权读他人会话(core 在另一容器,不受影响)。本机集成测试用 `EXECUTOR_ALLOW_LOCAL_ORIGIN=1` 放行,生产不得设置。 diff --git a/docs/DEPLOY.md b/docs/DEPLOY.md index 176102d..04d809c 100644 --- a/docs/DEPLOY.md +++ b/docs/DEPLOY.md @@ -156,6 +156,8 @@ curl -s "http://agent-core:8081/public-link?path=/workspace/tasks/<会话>/_cgi- - 必须在 `config.yml` 配 `public_link.base_url = "http://<服务器IP>:8090"`;不配则不启动签发端口, video_gen 的工具描述里也不会出现那条命令(它会退化成“请运维配 PUBLIC_LINK_URL”)。 + 例外:容器 env 里配了 `VIRTUAL_HOST`(nginx-proxy 域名 + HTTPS 那套)时,前缀自动用 `https://<域名>`, + 不用改 `config.yml`(改也盖不住它)。 - 链接有效期 `public_link.ttl_ms`,默认 30 分钟;签完尽快用掉。 - 沙箱外的人要用上这条链接,得拿到那个 22 字符随机 ID(猜不出来,也不可能枚举),且过期即废。 - 这条路不搬字节:文件始终在它原本的位置,也不需要 video_gen 参与上传/落盘。