diff --git a/docker-compose.yml b/docker-compose.yml index c4ccf56..443da1c 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -42,7 +42,7 @@ services: # debug 会把与 core 的完整交互打印出来(请求、/exec 请求体、每条 SSE 帧、JSON 响应): - EXECUTOR_LOG_LEVEL=info # 资源限制:兜住 AI 失控命令(烧 CPU / 吃内存 / fork 炸弹 / 写盘撞满宿主机磁盘)。cgroup/ulimit 随 fork 继承。 - # 这些是性能/容量护栏,不限制可调用的 syscall:apt-get install、fuse 装载等仍需 privileged: true 放开。 + # 这些是性能/容量护栏,不限制可调用的 syscall;执行能力由下方 cap_add/security_opt 控制。 cpus: "2.0" # 容器整体最多用 2 核(超出限流不杀进程),按宿主机核数调整 mem_limit: 2g # 内存失控 → 容器被 OOM kill(restart 策略自动拉起,代价是该容器内所有在执行命令随容器重启丢失) pids_limit: 512 # 进程+线程总数上限,防 fork 炸弹耗尽宿主机进程表 @@ -53,11 +53,16 @@ services: fsize: soft: 2147483648 hard: 2147483648 - # privileged: true 拿最大执行权限(默认能力集 + seccomp/apparmor unconfined)。 - # 原因:executor 需在每条命令前 unshare(2) + mount(2) 临时覆盖 /workspace/tasks 为 tmpfs, - # 只回挂当前会话目录,让 AI 看不到别人的项目。默认 cap_drop + 默认 seccomp/apparmor 会拦下这两个调用。 + # per-task 隔离需 unshare(2)/mount(2):只需 CAP_SYS_ADMIN(cap_add),不必 privileged。 + # 实测 Docker 29(Ubuntu,AppArmor 启用):默认 AppArmor profile(docker-default)会拦 mount 系统调用, + # 单加 SYS_ADMIN 仍报 Permission denied,需本容器 apparmor unconfined;默认 seccomp profile 对持 CAP_SYS_ADMIN + # 的进程本就放行 mount/unshare,无需改动。相比 privileged: true 去掉的是:宿主机设备透传(/dev 裸盘)、 + # 全套能力集、seccomp 封锁——保留的这三道仍是隔离层。 # 安全网:容器仅 expose 9000 + agent-internal 外网不可见;cpus/mem/pids/fsize cgroup 仍受控。 - privileged: true + cap_add: + - SYS_ADMIN + security_opt: + - apparmor=unconfined networks: - agent-internal diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 7cedea5..a6ab733 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -353,7 +353,7 @@ stateDiagram-v2 | `EXECUTOR_TOKEN` | 空 | 可选 Bearer 鉴权 | | `EXECUTOR_LOG_LEVEL` | `info` | 分级日志(debug 打满请求/响应交互) | -**per-task 挂载隔离**(`server.js` 的 `isolatedCommand`):cwd 在任务根(`EXECUTOR_CWD`)严格之下的命令,spawn 时包一层 wrapper,在新的 mount namespace 里把任务根覆盖为 tmpfs、只把当前会话根(第一层子目录)bind 回原路径——AI 只能看到/改自己的项目,看不到别的会话;cwd 在任务根本身或其外(如 skill 入口跑在技能目录)不隔离直接 spawn。需 compose 配 `privileged: true`(默认 cap_drop + seccomp/apparmor 会拦 `unshare(2)`/`mount(2)`);`unshare`/`mount`/`mktemp` 来自 debian 基础包 util-linux。 +**per-task 挂载隔离**(`server.js` 的 `isolatedCommand`):cwd 在任务根(`EXECUTOR_CWD`)严格之下的命令,spawn 时包一层 wrapper,在新的 mount namespace 里把任务根覆盖为 tmpfs、只把当前会话根(第一层子目录)bind 回原路径——AI 只能看到/改自己的项目,看不到别的会话;cwd 在任务根本身或其外(如 skill 入口跑在技能目录)不隔离直接 spawn。需 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。 **资源护栏**(compose 层,**不在 server.js**): `cpus 2.0` / `mem_limit 2g` / `pids_limit 512` / `ulimits.fsize 2G` —— 防 AI 失控命令。残余缺口(只限单文件不限总量)在 compose 注释里已标。 diff --git a/executor/server.js b/executor/server.js index 376c3c4..5938873 100644 --- a/executor/server.js +++ b/executor/server.js @@ -20,7 +20,7 @@ // per-task 隔离:每条命令默认在新的 mount 命名空间里跑。启动 wrapper 把 EXECUTOR_CWD(任务根,/workspace/tasks) // 覆盖为 tmpfs,只把当前会话的子目录 bind 回原路径上——结果:AI 命令能读写自己的项目,看不到别人的 task 目录。 // 任务根以外的路径(/workspace/skills、/tmp、/usr、依赖包等)不受影响。mount 命名空间随进程退出自动销毁。 -// 需 CAP_SYS_ADMIN + 默认 seccomp/apparmor unconfined:compose 里 agent-executor 配了 privileged: true。 +// 需 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)。 // // 日志:EXECUTOR_LOG_LEVEL=debug|info|warn|error|none(默认 info,none/off 全静默),分级语义与 core 的 log.js 一致。 // info = 关键动作(启动/进程 start/exit/取消/关闭);debug = 额外打印与 core 的完整交互: