From 2f96414c4965918c4620c14fb28b94bb927bd990 Mon Sep 17 00:00:00 2001 From: kicer Date: Fri, 11 Sep 2026 21:17:02 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8A=A0=E5=9B=BA=EF=BC=9Aexecutor=20=E6=8B=92?= =?UTF-8?q?=E7=BB=9D=E5=AE=B9=E5=99=A8=E8=87=AA=E8=BA=AB=E6=9D=A5=E6=BA=90?= =?UTF-8?q?=E7=9A=84=20/exec=EF=BC=9Btoken=20=E7=A7=BB=E5=87=BA=E4=BB=93?= =?UTF-8?q?=E5=BA=93?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 隔离只 unshare mount+pid,命令与 executor 同 net ns,能打到 127.0.0.1:9000;此前全局 token 一经泄漏,会话内即可借 /exec 以任意会话 cwd 起命令、绕过隔离读他人数据。现 /exec 先于鉴权拒绝源地址为回环/本机网卡的请求(403),/health 不设限;core 在另一容器、源地址非本机,不受影响。 - 实测:容器内带合法 token 调用 403、容器内 /health 200、core 侧新 token 200 且 session 隔离与技能执行正常。 - token 不再硬编码:compose 改用 ${EXECUTOR_TOKEN:?...} 从 .env 读取(.env 已 gitignore,附 .env.example 模板;未设置直接报错,杜绝静默无鉴权)。旧值已轮换(旧 token 401,新 token 200)。 - 本机集成测试用 EXECUTOR_ALLOW_LOCAL_ORIGIN=1 放行回环来源(executor/smoke-test.js、app/test/remote-exec.test.js),生产不得设置;ARCHITECTURE §2/§6 同步。 --- .env.example | 3 +++ .gitignore | 1 + app/test/remote-exec.test.js | 2 ++ docker-compose.yml | 9 +++++---- docs/ARCHITECTURE.md | 7 +++++-- executor/server.js | 30 ++++++++++++++++++++++++++++++ executor/smoke-test.js | 1 + 7 files changed, 47 insertions(+), 6 deletions(-) create mode 100644 .env.example diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..8c5c97d --- /dev/null +++ b/.env.example @@ -0,0 +1,3 @@ +# 复制为 .env 并填入真实值(.env 已在 .gitignore,不会被提交)。 +# 生成 token:openssl rand -hex 32 +EXECUTOR_TOKEN=change-me-openssl-rand-hex-32 diff --git a/.gitignore b/.gitignore index bc78f7b..3e4f231 100644 --- a/.gitignore +++ b/.gitignore @@ -4,6 +4,7 @@ node_modules/ app/test/tmp/ app/config.yml /config.yml +.env app/data/ data/ tasks/ diff --git a/app/test/remote-exec.test.js b/app/test/remote-exec.test.js index 308e32e..b957936 100644 --- a/app/test/remote-exec.test.js +++ b/app/test/remote-exec.test.js @@ -42,6 +42,8 @@ process.env.EXECUTOR_ISOLATION_BASE = ISO; process.env.EXECUTOR_SKILLS_DIR = SKILLS; delete process.env.EXECUTOR_URL; delete process.env.EXECUTOR_TOKEN; delete process.env.EXECUTOR_LOG_LEVEL; +// 本机集成测试:core 与 executor 同机,连接必为回环,需放行容器自身来源(生产不设)。 +process.env.EXECUTOR_ALLOW_LOCAL_ORIGIN = '1'; require(path.join(ROOT, 'executor/server.js')); // 2) core 侧模块 diff --git a/docker-compose.yml b/docker-compose.yml index 69af45c..bc1f6a3 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -19,8 +19,9 @@ services: - CERT_NAME=default # 加入executor独立服务 - EXECUTOR_URL=http://agent-executor:9000 - # 两侧设成同一个值即启用调用鉴权(内网互访,可选): - - EXECUTOR_TOKEN=b2676884778e373dcd7244c29aadcb82 + # 调用鉴权 token:两侧同一值。从 .env 读取(已 gitignore),不再硬编码进仓库; + # 未设置则 compose 直接报错,避免静默无鉴权。生成:openssl rand -hex 32 + - EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example} networks: - my-app-network - agent-internal @@ -38,8 +39,8 @@ services: - ./skills:/workspace/skills:ro # 技能目录:所有任务/会话共享同一份技能 environment: - PORT=9000 - # 与 agent-core 侧设成同一个值即启用调用鉴权(可选): - - EXECUTOR_TOKEN=b2676884778e373dcd7244c29aadcb82 + # 与 agent-core 侧同一值,从 .env 读取(见 .env.example): + - EXECUTOR_TOKEN=${EXECUTOR_TOKEN:?EXECUTOR_TOKEN not set - see .env.example} # 日志等级:debug|info|warn|error|none(默认 info); # debug 会把与 core 的完整交互打印出来(请求、/exec 请求体、每条 SSE 帧、JSON 响应): - EXECUTOR_LOG_LEVEL=info diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 7b5fe80..d7fe4c5 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -109,7 +109,8 @@ graph LR - `agent-core` 与 `agent-executor` 须把**同一份宿主机 `./tasks`、`./skills`**挂到相同的容器路径(默认 `/workspace/tasks`、`/workspace/skills`)。这是文件工具在 Core 本地直接读、命令在远端写,二者能"看到"彼此产物的根本约定。 - nginx-proxy 前置时**必须 `proxy_buffering off`**,否则 SSE 流被缓冲。详见 `docs/DEPLOY.md`。 -- Core 通过环境变量 `EXECUTOR_URL` / `EXECUTOR_TOKEN` 注入 executor 端点(compose 已配;也可用 `config.yml` 的 `executor` 段覆盖)。 +- 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` 放行,生产不得设置。 - Executor 在 compose 里加了 cgroup/ulimit 护栏(`cpus 2.0` / `mem_limit 2g` / `pids_limit 512` / `ulimits.fsize 2G`)——详见 `executor/server.js` 头注释。 --- @@ -337,7 +338,8 @@ stateDiagram-v2 **安全约束**(改 executor 时务必保持): -- `EXECUTOR_TOKEN` 非空时,除 `/health` 外必须 `Authorization: Bearer`(常时间比较)。 +- `EXECUTOR_TOKEN` 非空时,除 `/health` 外必须 `Authorization: Bearer`(常时间比较)。token 存 `.env`(gitignore),不硬编码进仓库。 +- 拒绝**来自容器自身**(回环/本机网卡)的 `/exec`:隔离未 unshare net ns,命令能打到 `127.0.0.1:9000`;据此即使 token 泄漏,会话内也无法回环调 `/exec` 以他人会话 cwd 起命令(core 在另一容器,源地址非本机,不受影响)。`EXECUTOR_ALLOW_LOCAL_ORIGIN=1` 仅供本机集成测试,生产不得设置。 - `cwd` 必须落在 `EXECUTOR_ROOTS`(逗号分隔白名单,默认 `/workspace`)realpath 之下,防穿越。 - `cwd` 不得是任务根本身(realpath 相等即拒):它是全部会话目录的父目录,在其下执行会暴露所有会话,且隔离 wrapper 在此层无从生效;缺省 cwd 落任务根同样被拒 → 等效必填。 - `timeout_ms` 夹在 `[1000, EXECUTOR_MAX_TIMEOUT_MS=1800000]`。 @@ -354,6 +356,7 @@ stateDiagram-v2 | `EXECUTOR_MAX_OUTPUT_CHARS` | 200000 | stdout/stderr 单向截断阈值 | | `EXECUTOR_TOKEN` | 空 | 可选 Bearer 鉴权 | | `EXECUTOR_LOG_LEVEL` | `info` | 分级日志(debug 打满请求/响应交互) | +| `EXECUTOR_ALLOW_LOCAL_ORIGIN` | 空 | 仅本机集成测试:`1` 放行回环/本机来源的 /exec(生产勿设) | **per-task 挂载隔离**(`server.js` 的 `isolatedCommand`):cwd 在任务根(`EXECUTOR_CWD`)严格之下的命令,spawn 时包一层 wrapper,在新的 mount namespace 里把任务根覆盖为 tmpfs、只把当前会话根(第一层子目录)bind 回原路径——AI 只能看到/改自己的项目,看不到别的会话;cwd 恰为任务根被 /exec 边界直接拒 400(见上);cwd 在任务根外(如技能依赖安装跑在技能目录)不隔离直接 spawn(/mnt 仍被遮,看不到任何会话数据)。wrapper 同时 `unshare --pid --fork` 进新 pid ns 并重挂 /proc(flags 对齐 docker):否则 /proc 仍是宿主视图,`nsenter --mount=/proc/1/ns/mnt` 可借 executor 主进程的 ns 句柄逃逸回原始 mount ns(已实测复现过);重挂后 /proc/1 即命令自身。新 proc 可写会顶掉 docker 防护,wrapper 逐项还原:/proc/sys 只读 bind(防 core_pattern 宿主逃逸)、/dev/null 遮蔽 kcore/keys/sysrq-trigger(echo b 可重启宿主机)。wrapper 还把 server.js 所在目录(镜像 WORKDIR,容器内 `/app`)tmpfs 盖掉(任务根与之嵌套的开发态跳过);且下发命令的 env 剥掉 `EXECUTOR_TOKEN`——否则 `env` 一 dump 即得 token,可从容器内回环调 `/exec` 以任意会话目录起命令,绕过隔离。需 compose 配 `cap_add: SYS_ADMIN` + `security_opt: apparmor=unconfined`(不用 privileged:实测 Docker 29,默认 AppArmor profile 拦 `mount(2)`,单加 SYS_ADMIN 不够;默认 seccomp 对持 CAP_SYS_ADMIN 的进程放行 `unshare(2)`/`mount(2)`,无需改动);`unshare`/`mount`/`mktemp` 来自 debian 基础包 util-linux。 diff --git a/executor/server.js b/executor/server.js index b73c811..eb7aaab 100644 --- a/executor/server.js +++ b/executor/server.js @@ -27,6 +27,10 @@ // // 约束: // - 设置 EXECUTOR_TOKEN 后除 /health 外必须带 Authorization: Bearer ; +// - 拒绝“来自容器自身”(回环/本机网卡)的 /exec:隔离只 unshare mount+pid,**没有** unshare +// net ns,命令与 executor 同处一个 net ns,能打到 127.0.0.1:9000;只要 token 泄漏,就能 +// 借 /exec 以任意会话 cwd 起命令、绕过隔离。core 在另一个容器(源地址是其 bridge IP),不受影响。 +// EXECUTOR_ALLOW_LOCAL_ORIGIN=1 仅供本机集成测试,生产不得设置。 // - cwd 必须落在 EXECUTOR_ROOTS(逗号分隔白名单)内,且不得是任务根本身; // - session 目录及其链上不得含符号链接(防解析后逃逸); // - timeout_ms 夹在 [1s, EXECUTOR_MAX_TIMEOUT_MS];stdout/stderr 各自按 max_output_chars 截断。 @@ -35,6 +39,7 @@ 'use strict'; const http = require('http'); +const os = require('os'); const fs = require('fs'); const path = require('path'); const crypto = require('crypto'); @@ -44,6 +49,19 @@ const { spawn } = require('child_process'); const PORT = parseInt(process.env.PORT, 10) || 9000; const TOKEN = process.env.EXECUTOR_TOKEN || ''; +// 本容器自身的地址集合(含回环):用于拒绝“来自容器内部”的 /exec 调用。 +// 测试用 EXECUTOR_ALLOW_LOCAL_ORIGIN=1 可放行;生产必须保持关闭。 +const ALLOW_LOCAL_ORIGIN = process.env.EXECUTOR_ALLOW_LOCAL_ORIGIN === '1'; +function normIp(s) { s = String(s || ''); return s.startsWith('::ffff:') ? s.slice(7) : s; } +const SELF_IPS = (() => { + const set = new Set(['127.0.0.1', '::1']); + const ifaces = os.networkInterfaces(); + for (const name of Object.keys(ifaces)) { + for (const a of ifaces[name] || []) set.add(normIp(a.address)); + } + return set; +})(); + const ROOTS = (process.env.EXECUTOR_ROOTS || '/workspace') .split(',').map(s => s.trim()).filter(Boolean).map(p => path.resolve(p)); @@ -455,6 +473,11 @@ function resolveCwd(raw) { } // ---------- HTTP ---------- +// 请求是否源自本容器(回环/本机网卡):是则拒绝,防止隔离内的命令回环调 /exec 越权。 +function isSelfOrigin(req) { + return SELF_IPS.has(normIp(req.socket && req.socket.remoteAddress)); +} + function tokenOk(req) { if (!TOKEN) return true; const auth = String(req.headers.authorization || ''); @@ -628,6 +651,12 @@ const server = http.createServer(async (req, res) => { if (url.pathname === '/health') return send(res, 200, { ok: true, time: Date.now() }); + // 先于鉴权拒绝“容器自身来源”:即使 token 泄漏,隔离内的命令也无法借回环调用 /exec。 + if (!ALLOW_LOCAL_ORIGIN && isSelfOrigin(req)) { + log.warn('auth', '拒绝容器自身来源', req.method, url.pathname, req.socket.remoteAddress); + return send(res, 403, { error: '拒绝来自容器自身的请求' }); + } + if (!tokenOk(req)) { log.warn('auth', '拒绝', req.method, url.pathname); return send(res, 401, { error: '鉴权失败' }); @@ -651,6 +680,7 @@ server.listen(PORT, () => { ' isolation_base=' + ISOLATION_BASE + ' scratch=' + SCRATCH_ROOT + ' auth=' + (TOKEN ? 'on' : 'off')); + if (ALLOW_LOCAL_ORIGIN) log.warn('EXECUTOR_ALLOW_LOCAL_ORIGIN=1:放行回环/本机来源,仅供本机集成测试,生产不得设置'); selfCheck(); }); diff --git a/executor/smoke-test.js b/executor/smoke-test.js index 2405b71..622abbd 100644 --- a/executor/smoke-test.js +++ b/executor/smoke-test.js @@ -10,6 +10,7 @@ const TASK_ROOT = SELF + '/.taskroot'; require('fs').mkdirSync(TASK_ROOT, { recursive: true }); process.env.EXECUTOR_CWD = TASK_ROOT; delete process.env.EXECUTOR_TOKEN; // 主实例不带 token,鉴权单独测 +process.env.EXECUTOR_ALLOW_LOCAL_ORIGIN = '1'; // 本机集成测试:连接必为回环,放行自身来源(生产不设) const { spawn } = require('child_process'); const path = require('path');