加固:executor 拒绝容器自身来源的 /exec;token 移出仓库
- 隔离只 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 同步。
This commit is contained in:
@@ -0,0 +1,3 @@
|
||||
# 复制为 .env 并填入真实值(.env 已在 .gitignore,不会被提交)。
|
||||
# 生成 token:openssl rand -hex 32
|
||||
EXECUTOR_TOKEN=change-me-openssl-rand-hex-32
|
||||
@@ -4,6 +4,7 @@ node_modules/
|
||||
app/test/tmp/
|
||||
app/config.yml
|
||||
/config.yml
|
||||
.env
|
||||
app/data/
|
||||
data/
|
||||
tasks/
|
||||
|
||||
@@ -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 侧模块
|
||||
|
||||
+5
-4
@@ -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
|
||||
|
||||
@@ -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。
|
||||
|
||||
|
||||
@@ -27,6 +27,10 @@
|
||||
//
|
||||
// 约束:
|
||||
// - 设置 EXECUTOR_TOKEN 后除 /health 外必须带 Authorization: Bearer <token>;
|
||||
// - 拒绝“来自容器自身”(回环/本机网卡)的 /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();
|
||||
});
|
||||
|
||||
|
||||
@@ -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');
|
||||
|
||||
Reference in New Issue
Block a user