Skip to content

沙箱 ​

策略判定的是经过 Guard 的调用。沙箱限制的是不经过 Guard 时,一个进程还能做什么:能读写哪些文件、能连哪些主机。Guard 可以在 srt(开源的 Sandbox Runtime,@anthropic-ai/sandbox-runtime)里启动一条命令或一个 stdio MCP 服务,支持 macOS 和 Linux。

先检查目标环境

依赖沙箱之前,先在 Agent 实际使用的镜像上跑一遍探针(见检查主机)。

安装 srt ​

  • 安装 npm 包 @anthropic-ai/sandbox-runtime,版本必须正好是 0.0.77。其他版本,以及不是来自这个包的 srt,Guard 一律拒绝。
  • Node.js 20.11 及以上。
  • macOS:sandbox-exec 和 rg(ripgrep)。
  • Linux:bwrap(bubblewrap)、socat 和 rg,并且非 root 用户要能创建带网络隔离的 user namespace。Ubuntu 24.04 及以上的 AppArmor user namespace 策略可能需要宿主机管理员授权。

检查主机 ​

sh
preworld-guard sandbox verify --executable tooling/node_modules/.bin/srt

--executable 指向锁定版本的 srt。检查只用临时文件和本机的 HTTP 服务。它确认在工作区内写文件、访问批准的端口可以成功,同时确认下面这些都会失败:在工作区外写文件、写显式禁写的路径、读受保护的文件、访问未批准的目标、直接开 socket,以及子进程做上面任何一件事。全部通过才以 0 退出。有任何一项没通过,就不要把这台主机当作沙箱边界。

保存报告(内核、架构、包版本、CLI 的哈希)。升级包、系统或镜像之后重新检查。

在沙箱里运行命令 ​

sh
preworld-guard sandbox run \
  --workspace ./workspace --deny-read ~/.ssh --deny-domain '*.untrusted.example' \
  -- python agent.py
选项含义
--workspace工作目录(默认当前目录)
--allow-read、--deny-read允许或禁止读取的路径(可重复)
--allow-write、--deny-write允许或禁止写入的路径(可重复)
--allow-domain、--deny-domain允许或禁止访问的网络目标(可重复)
--timeout多少秒后停止命令(默认 120)
--executablesrt 的路径(默认 srt)

Guard 写一个一次性的设置文件,然后执行 srt --settings <file> <command>,从不拼接 shell 字符串。设置里关掉了 srt 较弱的嵌套沙箱、较弱的网络隔离、Apple Events 和本地端口绑定。命令的退出码原样返回。

把 MCP 服务放进沙箱 ​

preworld-guard mcp-proxy --sandbox 在 srt 里启动 stdio MCP 服务,配合 --sandbox-allow-read、--sandbox-deny-write 等 --sandbox-* 选项。srt 不可用时,代理拒绝启动。见 MCP 代理。

它代替不了什么 ​

  • 它不是 Agent 容器和你们业务服务之间的网络隔离。网络规则照样要有,并用一次本应失败的连接实测。
  • 它不检查已放行的连接发了什么内容。
  • macOS 上的结果不能代表 Linux,也不能代表另一个镜像。每个目标环境都要单独验证。