From 4c5437e78adfa1a0826fb78b0160286382f26910 Mon Sep 17 00:00:00 2001 From: kicer Date: Sun, 6 Sep 2026 10:35:35 +0800 Subject: [PATCH] =?UTF-8?q?agent-executor=20=E9=99=8D=E6=9D=83=EF=BC=9Apri?= =?UTF-8?q?vileged:=20true=20=E6=94=B9=E6=9C=80=E5=B0=8F=E6=9D=83=E9=99=90?= =?UTF-8?q?=20cap=5Fadd=20SYS=5FADMIN=20+=20security=5Fopt=20apparmor=3Dun?= =?UTF-8?q?confined=EF=BC=88=E8=AF=84=E5=AE=A1=E6=84=8F=E8=A7=81=EF=BC=8C?= =?UTF-8?q?=E6=96=B9=E5=90=91=E6=88=90=E7=AB=8B=E4=BD=86=E9=9C=80=E8=A1=A5?= =?UTF-8?q?=20apparmor=20=E4=B8=80=E9=A1=B9=EF=BC=89=E3=80=82=E5=AE=9E?= =?UTF-8?q?=E6=B5=8B=20Docker=2029=EF=BC=88Ubuntu=EF=BC=8CAppArmor=20?= =?UTF-8?q?=E5=90=AF=E7=94=A8=EF=BC=89=EF=BC=9A=E9=BB=98=E8=AE=A4=20AppArm?= =?UTF-8?q?or=20profile=EF=BC=88docker-default=EF=BC=89=E6=8B=A6=20mount(2?= =?UTF-8?q?)=EF=BC=8C=E5=8D=95=E5=8A=A0=20SYS=5FADMIN=20=E8=BF=9E=20mount?= =?UTF-8?q?=20--bind=20=E9=83=BD=20Permission=20denied=EF=BC=9Bseccomp=20?= =?UTF-8?q?=E5=8D=95=E7=8B=AC=E6=94=BE=E5=BC=80=E6=97=A0=E7=94=A8=E3=80=81?= =?UTF-8?q?apparmor=20unconfined=20=E5=8D=B3=E5=85=A8=E9=80=9A=EF=BC=9B?= =?UTF-8?q?=E9=BB=98=E8=AE=A4=20seccomp=20profile=20=E5=AF=B9=E6=8C=81=20C?= =?UTF-8?q?AP=5FSYS=5FADMIN=20=E8=BF=9B=E7=A8=8B=E6=9C=AC=E5=B0=B1?= =?UTF-8?q?=E6=94=BE=E8=A1=8C=20unshare(2)/mount(2)=EF=BC=8C=E6=97=A0?= =?UTF-8?q?=E9=9C=80=E6=94=B9=E5=8A=A8=E3=80=82=E7=9B=B8=E6=AF=94=20privil?= =?UTF-8?q?eged=20=E6=94=B6=E5=9B=9E=EF=BC=9A=E5=AE=BF=E4=B8=BB=E6=9C=BA?= =?UTF-8?q?=E8=AE=BE=E5=A4=87=E9=80=8F=E4=BC=A0=EF=BC=88/dev=20=E8=A3=B8?= =?UTF-8?q?=E7=9B=98=EF=BC=89=E3=80=81=E5=85=A8=E5=A5=97=20capability?= =?UTF-8?q?=E3=80=81seccomp=20=E5=B0=81=E9=94=81=E3=80=82=E5=AE=B9?= =?UTF-8?q?=E5=99=A8=E5=B7=B2=E9=87=8D=E5=BB=BA=EF=BC=88privileged=3Dfalse?= =?UTF-8?q?=20cap=5Fadd=3D[CAP=5FSYS=5FADMIN]=EF=BC=89=EF=BC=8C=E5=AE=B9?= =?UTF-8?q?=E5=99=A8=E5=86=85=20smoke=2016/16=20=E5=85=A8=E8=BF=87?= =?UTF-8?q?=EF=BC=88=E9=9A=94=E7=A6=BB=E7=94=A8=E4=BE=8B=E7=9C=9F=E5=AE=9E?= =?UTF-8?q?=E6=89=A7=E8=A1=8C=E9=9D=9E=20SKIP=EF=BC=89=E3=80=82compose=20?= =?UTF-8?q?=E5=8E=9F=E6=B3=A8=E9=87=8A=E9=87=8C=20apt-get=20install=20?= =?UTF-8?q?=E9=9C=80=20privileged=20=E7=9A=84=E8=AF=B4=E6=B3=95=E6=9C=89?= =?UTF-8?q?=E8=AF=AF=E4=B8=80=E5=B9=B6=E6=B8=85=E7=90=86=EF=BC=88=E8=AF=A5?= =?UTF-8?q?=E9=95=9C=E5=83=8F=E5=B0=B1=E6=98=AF=E5=9C=A8=E9=BB=98=E8=AE=A4?= =?UTF-8?q?=20seccomp=20=E4=B8=8B=E6=9E=84=E5=BB=BA=E7=9A=84=EF=BC=89?= =?UTF-8?q?=E3=80=82server.js/ARCHITECTURE.md=20=E5=A4=B4=E6=B3=A8?= =?UTF-8?q?=E5=90=8C=E6=AD=A5=E3=80=82=E6=B3=A8=EF=BC=9Aprivileged=20?= =?UTF-8?q?=E9=A1=BA=E5=B8=A6=E6=8F=90=E4=BE=9B=E7=9A=84=20SYS=5FPTRACE/NE?= =?UTF-8?q?T=5FADMIN/=E8=AE=BE=E5=A4=87=E8=AE=BF=E9=97=AE=E9=9A=8F?= =?UTF-8?q?=E4=B9=8B=E6=94=B6=E5=9B=9E=EF=BC=8CAI=20=E5=A6=82=E9=9C=80?= =?UTF-8?q?=E8=B0=83=E8=AF=95=E7=B1=BB=E5=B7=A5=E5=85=B7=E5=86=8D=E6=8C=89?= =?UTF-8?q?=E9=9C=80=E6=98=BE=E5=BC=8F=20cap=5Fadd?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docker-compose.yml | 15 ++++++++++----- docs/ARCHITECTURE.md | 2 +- executor/server.js | 2 +- 3 files changed, 12 insertions(+), 7 deletions(-) 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 的完整交互: