executor 遮蔽源码与 token:① 隔离 wrapper 追加 mount -t tmpfs 盖住 server.js 所在目录(镜像 WORKDIR /app),AI 命令读不到 executor 源码;任务根/cwd 与 WORKDIR 嵌套时(宿主机开发态、smoke 主套)自动跳过,防把任务树一起盖掉。② handleExec 组装子进程 env 时删 EXECUTOR_TOKEN(合并 args.env 之后删,防请求侧重注)——此前每条 AI 命令的 env 都带着鉴权 token,dump 一下即可从容器内回环 POST /exec 以任意他人会话目录起命令,比读源码严重一个量级,一并堵上;server 侧比对用内存常量不受影响。smoke:iso 实例任务根移入系统 tmp 使遮蔽分支真实生效,新增 WORKDIR 遮蔽与子进程 env 剥 token 两用例,25/25(宿主机+容器内)。生产探针实证:ls /app 为空、server.js hidden、EXECUTOR_TOKEN=whoami 在命令 env 中计数 0。ARCHITECTURE.md §6 同步。

This commit is contained in:
2026-09-06 11:16:28 +08:00
parent fba5515a57
commit 36c44a5f4e
3 changed files with 25 additions and 11 deletions
+12 -1
View File
@@ -25,6 +25,8 @@
// 的句柄,AI 用 nsenter --mount=/proc/1/ns/mnt 即可逃逸回未隔离视图(已实测复现);重挂后 /proc/1 即命令自身。
// 新 proc 可写会顶掉 docker 的防护,wrapper 逐项还原:/proc/sys 只读 bind(防 core_pattern 类宿主逃逸)、
// /dev/null 遮蔽 kcore/keys(docker maskPaths)与 sysrq-trigger(可写 proc 新暴露,echo b 可重启宿主机)。
// wrapper 还把 server.js 所在目录(镜像 WORKDIR,容器内 /app)用 tmpfs 盖掉,AI 读不到 executor 源码;
// 且下发命令的 env 剥掉 EXECUTOR_TOKEN——否则命令里 env 一 dump 就拿 token 回环 POST /exec 以任意会话目录起命令,绕过隔离。
// 副作用红利:pid ns 内 ps 只见自家进程树;double-fork 脱管的守护进程随命令退出被内核连带清理。
// 任务根以外的路径(/workspace/skills、/tmp、/usr、依赖包等)不受影响。mount 命名空间随进程退出自动销毁。
// 需 CAP_SYS_ADMIN,且 AppArmor 不能拦 mount(Docker 默认 docker-default profile 会拦):compose 里 agent-executor 配 cap_add SYS_ADMIN + apparmor=unconfined,不用 privileged(实测默认 seccomp 对持 CAP_SYS_ADMIN 的进程放行 mount/unshare)。
@@ -50,6 +52,8 @@ const ROOTS = (process.env.EXECUTOR_ROOTS || '/workspace').split(',').map(s => s
const DEFAULT_CWD = process.env.EXECUTOR_CWD || path.join(ROOTS[0], 'tasks');
// 任务根 realpath:/exec 一律拒绝 cwd 恰好等于它(见 handleExec)。拒绝后「任务根下的命令必进隔离 wrapper」成为硬不变式。
const REAL_TASK_ROOT = (() => { try { return fs.realpathSync(DEFAULT_CWD); } catch (_) { return null; } })();
// server.js 所在目录(镜像 WORKDIR /app):隔离 wrapper 用 tmpfs 盖住,不让 AI 读 executor 源码。
const APP_DIR = __dirname;
const MAX_TIMEOUT = parseInt(process.env.EXECUTOR_MAX_TIMEOUT_MS, 10) || 30 * 60 * 1000;
const DEFAULT_MAX_OUT = parseInt(process.env.EXECUTOR_MAX_OUTPUT_CHARS, 10) || 200000;
const PING_MS = 15000;
@@ -100,7 +104,7 @@ function shq(s) { return "'" + String(s).replace(/'/g, "'\\''") + "'"; }
// per-task 挂载隔离 wrapper:返回一个 sh -c 脚本,shell 启动时跑(与 unshare --mount --pid --fork 配合):
// 0) 重挂 proc 到新 pid ns(封掉 nsenter /proc/1/ns/mnt 逃逸),还原 /proc/sys 只读与 mask 遮蔽
// 1) 把 cwd 预先 bind 到 /tmp 下的 anchor(避开后面被覆盖的任务根)
// 2) 在新 mount ns 里把任务根覆盖为 tmpfs(其他会话从此不可见)
// 2) 在新 mount ns 里把任务根覆盖为 tmpfs(其他会话从此不可见);同法盖住 APP_DIR(源码遮蔽)
// 3) 在 tmpfs 下重建当前会话目录名,把 anchor bind 回原路径上
// 4) 拆掉 anchor,切到 cwd,exec 用户命令(此时已是新 pid ns 的 PID 1)
// cwd 不在任务根下时返回 null(不隔离;主要适用于 skill 入口直接跑在 /workspace/skills/<name> 的场景)。
@@ -112,6 +116,9 @@ function isolatedCommand(command, cwd) {
const rel = path.relative(DEFAULT_CWD, cwd);
const sessionName = rel.split(path.sep)[0];
const sessionRoot = path.join(DEFAULT_CWD, sessionName);
// 遮蔽 executor 自身代码目录(镜像 WORKDIR,容器内 /app):tmpfs 盖住,AI 命令读不到 server.js。
// 任务根/cwd 与 WORKDIR 相互嵌套时(宿主机开发态,smoke 即如此)跳过,避免把任务树一起盖掉。
const hideWorkdir = !DEFAULT_CWD.startsWith(APP_DIR + path.sep) && !APP_DIR.startsWith(DEFAULT_CWD + path.sep) && !cwd.startsWith(APP_DIR + path.sep);
return [
'set -e',
// pid/proc 侧:重挂 proc 绑定本 pid ns(flags 对齐 docker),/proc/1 自此即命令自身,无宿主 ns 句柄可指。
@@ -124,6 +131,7 @@ function isolatedCommand(command, cwd) {
'mount --bind /dev/null /proc/sysrq-trigger',
'mount --bind /proc/sys /proc/sys',
'mount -o remount,bind,ro /proc/sys',
...(hideWorkdir ? ['mount -t tmpfs tmpfs ' + shq(APP_DIR)] : []),
'anchor=$(mktemp -d /tmp/.exanchor.XXXXXXXXXX)',
'mount --bind ' + shq(sessionRoot) + ' "$anchor"',
'mount -t tmpfs tmpfs ' + shq(DEFAULT_CWD),
@@ -221,6 +229,9 @@ async function handleExec(req, res) {
if (args.env && typeof args.env === 'object') {
for (const [k, v] of Object.entries(args.env)) env[String(k)] = String(v);
}
// 剥掉鉴权 token(合并后再删,防 args.env 重注):AI 命令拿到 token 即可从容器内回环 POST /exec,
// 以任意(他人会话)cwd 起命令,绕过 per-task 隔离。server 侧比对用的是 TOKEN 常量,不受影响。
delete env.EXECUTOR_TOKEN;
const id = crypto.randomUUID();
let child;
+12 -9
View File
@@ -1,5 +1,5 @@
// agent-executor 冒烟测试:node smoke-test.js(在本目录执行)。
// 覆盖:/health、/exec 流式输出与退出事件、增量下发时序、cwd 白名单拒绝、任务根边界(缺省/恰为任务根 → 400)、DELETE 取消、EXECUTOR_TOKEN 鉴权、per-task 挂载隔离(含 nsenter /proc/1 逃逸回归)、客户端半路断连不击穿服务。
// 覆盖:/health、/exec 流式输出与退出事件、增量下发时序、cwd 白名单拒绝、任务根边界(缺省/恰为任务根 → 400)、DELETE 取消、EXECUTOR_TOKEN 鉴权与子进程 env 剥除、per-task 挂载隔离(含 nsenter /proc/1 逃逸回归、WORKDIR 源码遮蔽)、客户端半路断连不击穿服务。
// 注意:隔离用例需 root/CAP_SYS_ADMIN(unshare+mount),无权限时自动 SKIP 不计失败;其余用例 cwd 故意取任务根外目录,保持非隔离路径可在无权限环境跑。
process.env.PORT = process.env.PORT || '19000';
const SELF = process.env.__SELF_DIR__ || __dirname; // 宿主机测试:白名单取本目录
@@ -99,11 +99,11 @@ async function main() {
await new Promise(r => setTimeout(r, 800)); // 留给服务端 close→杀进程→finish 走完
check('客户端半路断连不击穿服务(/health 仍 200)', (await fetch(BASE + '/health')).status === 200);
// 7.5 per-task 挂载隔离:另起一个实例(端口 19002),EXECUTOR_CWD=.iso-tasks(任务根),
// 下放 iso-a / iso-b 两个「会话」目录;cwd 取 iso-a 的深层子目录(模拟 terminal 的 cd),验证:
// 任务根下只看到 iso-a、cd 兄弟会话被拒、自己文件可读;另验 nsenter /proc/1 逃逸封堵与 /proc/sys 只读;
// 及 wrapper 内(新 pid ns、命令即 PID 1)超时杀进程语义;无 mount 权限时整组 SKIP。
const isoRoot = path.join(__dirname, '.iso-tasks');
// 7.5 per-task 挂载隔离:另起一个实例(端口 19002),任务根放系统 tmp(与 server 代码目录分离,
// 使 WORKDIR 遮蔽分支真实生效),下放 iso-a / iso-b 两个「会话」目录;cwd 取 iso-a 的深层子目录(模拟 terminal 的 cd),验证:
// 任务根下只看到 iso-a、cd 兄弟会话被拒、自己文件可读;另验 nsenter /proc/1 逃逸封堵、/proc/sys 只读、
// WORKDIR 内 server.js 不可读;及 wrapper 内(新 pid ns、命令即 PID 1)超时杀进程语义;无 mount 权限时整组 SKIP。
const isoRoot = path.join(require('os').tmpdir(), '.ex-smoke-iso');
fs.rmSync(isoRoot, { recursive: true, force: true });
fs.mkdirSync(path.join(isoRoot, 'iso-a', 'deep'), { recursive: true });
fs.mkdirSync(path.join(isoRoot, 'iso-b'), { recursive: true });
@@ -115,7 +115,7 @@ async function main() {
// 分隔符切段便于精确断言;cd 失败信息不走 stderr 上送(含 iso-b 字样会污染 ls 段断言),改用 leaked/blocked 标记区分。
const evsI = await collect(await fetch('http://127.0.0.1:19002/exec', {
method: 'POST', headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ command: 'pwd; echo @LS@; ls ../../; echo @CD@; cd ../../iso-b 2>/dev/null && echo leaked || echo blocked; echo @CAT@; cat ../../iso-a/a.txt; echo; echo @NS@; nsenter --mount=/proc/1/ns/mnt ls ' + isoRoot + ' 2>&1; echo @SYS@; echo 1 > /proc/sys/kernel/panic 2>/dev/null && echo sysctl_writable || echo sysctl_ro', cwd: isoCwd, timeout_ms: 5000 }),
body: JSON.stringify({ command: 'pwd; echo @LS@; ls ../../; echo @CD@; cd ../../iso-b 2>/dev/null && echo leaked || echo blocked; echo @CAT@; cat ../../iso-a/a.txt; echo; echo @NS@; nsenter --mount=/proc/1/ns/mnt ls ' + isoRoot + ' 2>&1; echo @SYS@; echo 1 > /proc/sys/kernel/panic 2>/dev/null && echo sysctl_writable || echo sysctl_ro; echo @APP@; test -f ' + __dirname + '/server.js && echo server_visible || echo server_hidden', cwd: isoCwd, timeout_ms: 5000 }),
}));
const outI = evsI.filter(e => e.type === 'out' || e.type === 'err').map(e => e.chunk).join('');
const exitI = evsI[evsI.length - 1];
@@ -133,6 +133,8 @@ async function main() {
check('逃逸: nsenter /proc/1 后仍只见 iso-a', /iso-a/.test(nsRegion) && !/iso-b/.test(nsRegion), 'ns=' + JSON.stringify(nsRegion));
// 重挂的 proc 必须还原 docker 的 /proc/sys 只读防护(否则 kernel.core_pattern 可写 → 宿主逃逸面)。
check('逃逸: 新 proc 下 /proc/sys 仍只读', /sysctl_ro/.test(outI) && !/sysctl_writable/.test(outI), 'out=' + JSON.stringify(outI));
// WORKDIR 遮蔽:iso 实例任务根在系统 tmp,与 server 代码目录不嵌套 → tmpfs 遮蔽分支生效,server.js 不可读。
check('遮蔽: WORKDIR 内 server.js 不可读', /server_hidden/.test(outI) && !/server_visible/.test(outI), 'out=' + JSON.stringify(outI));
// wrapper 内超时杀进程:命令已是新 pid ns 的 PID 1,验证杀进程组/超时对 PID 1 同样有效。
const evsTK = await collect(await fetch('http://127.0.0.1:19002/exec', {
method: 'POST', headers: { 'Content-Type': 'application/json' },
@@ -153,9 +155,10 @@ async function main() {
check('无 token 401', noTok.status === 401, 'status=' + noTok.status);
const healthNoTok = await fetch('http://127.0.0.1:19001/health');
check('带 token 时 /health 仍免鉴权', healthNoTok.status === 200);
const withTok = await fetch('http://127.0.0.1:19001/exec', { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: 'Bearer t9' }, body: JSON.stringify({ command: 'echo hi', cwd: SELF }) });
const withTok = await fetch('http://127.0.0.1:19001/exec', { method: 'POST', headers: { 'Content-Type': 'application/json', Authorization: 'Bearer t9' }, body: JSON.stringify({ command: "env | grep -q 'EXECUTOR_TOKEN=' && echo token_leak || echo token_absent", cwd: SELF }) });
const evs8 = await collect(withTok);
check('带 token 正常执行', evs8.some(e => e.type === 'out' && e.chunk.trim() === 'hi'), JSON.stringify(evs8));
// 带 token 请求本身正常,且子进程 env 已剥除 EXECUTOR_TOKEN(否则命令里 dump env 就能拿 token 回环绕隔离)。
check('带 token 正常执行且子进程 env 已剥 EXECUTOR_TOKEN', evs8.some(e => e.type === 'out' && e.chunk.includes('token_absent')) && !evs8.some(e => (e.chunk || '').includes('token_leak')), JSON.stringify(evs8));
child.kill('SIGKILL');
fs.rmSync(TASK_ROOT, { recursive: true, force: true });