Files
AgentLab/backend/app/sandbox/interpreter.py
T
ThearchyHelios a16cdf3ab1 修两条 critical:文件工具可读任意路径、并发代码节点互相覆盖
## 文件工具可读任意文件(含加密主密钥)

sandbox_session 从请求体直接拼进工作区路径,没有任何净化。传 ".." 就能把
根目录挪出工作区,之后 _resolve 的越界检查是在这个被挪走的根下做的,等于失效:

  curl -X POST /api/tools/file_read/run -d '{"sandbox_session":"..","args":{"path":".secret_key"}}'
  → {"ok":true,"content":"8UygDbx9..."}    # 加密所有 provider Key 的 Fernet 主密钥

根因是同一段净化逻辑被抄了五遍:四个沙箱后端各一份,文件工具那份漏抄了。
所以提到 config.sanitize_session 统一一份,五处共用;RunToolIn.sandbox_session
再加 pattern 做纵深防御——畸形 session 直接 422,而不是悄悄净化成 default。

## 并发代码节点互相覆盖入口脚本

同一 run 的节点共用一个沙箱会话,而入口脚本写死 main.py。README 主打的
"连线即并行"会让并排的代码节点在同一 superstep 并发执行,都写 main.py 就
互相覆盖——后写的赢,每个节点却都拿到 ok=True 和"自己的"返回值。

  8 路并发同 session:7/8 执行了别人的代码,error 全为 None

改成每次执行生成唯一入口脚本(__entry_<uuid>.py),跑完即删。共享工作区语义
保留,跨节点传文件照常。四个后端同构改造,实测 8/16 路并发均 0 串味。

## 顺带修掉两个自己埋的坑

- conda 迁移把沙箱解释器隔离弄丢了:conda 环境 sys.prefix == sys.base_prefix,
  于是"干净解释器"挑出来的就是项目环境自己,沙箱代码能 import cryptography
  直接解密落库的 Key。改成实际探测候选解释器是否看得见敏感包,都不干净就
  退回 -S 关掉 site-packages。README 那句承诺现在重新成立了。
- -I 在 3.11+ 隐含 -P,脚本目录不进 sys.path,代码节点的 files 参数(多文件)
  在 seatbelt/bubblewrap 下一直是坏的,import helper 直接 ModuleNotFoundError。
  换成 -s -E,隔离意图不变,同目录 import 恢复。
- microvm 的 files_written 取 FsEntry.name(不存在),塞进去的是对象 repr。
  改取 path 的尾段。

沙箱回归 16 项通过(两档各 8 项)。
2026-09-14 15:22:58 +08:00

107 lines
3.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""给沙箱挑一个看不见后端依赖的 Python 解释器。
原先的做法是「用 `sys.base_prefix` 下的那个」,理由是 venv 会把 FastAPI、
SQLAlchemy、凭据处理那一套挂进 sys.path,而 base_prefix 是干净的标准库环境。
这个假设在 venv 下成立,在 conda 下不成立:conda 环境没有 venv 那层分离,
`sys.prefix == sys.base_prefix`,于是"干净解释器"挑出来的就是项目环境本身,
沙箱代码能直接 `import cryptography` 去解密落库的 API Key。
所以这里不再假设,而是**实际验证**:挨个候选跑一下,看敏感包是否可见。
都不干净时退回当前解释器并加 `-S` 关掉 site-packages —— 标准库照常可用,
第三方包一个也看不见。
"""
from __future__ import annotations
import subprocess
import sys
from functools import lru_cache
from pathlib import Path
# 沙箱里绝不该出现的包。看得见任何一个,这个解释器就不算干净。
# anthropic/openai 带着 provider 客户端,cryptography 能解密落库的 Key,
# sqlalchemy 能直接连库,fastapi 则说明整个后端环境都在。
_SENSITIVE = ("fastapi", "sqlalchemy", "cryptography", "anthropic", "openai")
_PROBE = (
"import importlib.util as u;"
f"print(int(any(u.find_spec(m) for m in {_SENSITIVE!r})))"
)
def _is_clean(exe: str) -> bool:
"""跑一下这个解释器,看敏感包是否可见。探测失败就当它不干净。"""
try:
out = subprocess.run(
[exe, "-c", _PROBE],
capture_output=True, text=True, timeout=10,
)
return out.returncode == 0 and out.stdout.strip() == "0"
except (OSError, subprocess.SubprocessError):
return False
def _candidates() -> list[str]:
"""按优先级列出候选,重复的去掉。
先试 base_prefix(venv 下这就是对的),再试系统自带的 python3
(macOS/Linux 都有,且不会装项目依赖),最后是 Homebrew 的。
"""
base = Path(sys.base_prefix) / "bin"
major, minor = sys.version_info.major, sys.version_info.minor
raw = [
base / f"python{major}.{minor}",
base / f"python{major}",
base / "python",
Path("/usr/bin/python3"),
Path("/usr/local/bin/python3"),
Path("/opt/homebrew/bin/python3"),
]
seen, out = set(), []
for p in raw:
try:
real = str(p.resolve())
except OSError:
continue
if real in seen or not p.exists():
continue
seen.add(real)
out.append(real)
return out
@lru_cache(maxsize=1)
def resolve() -> tuple[str, bool]:
"""返回 (解释器路径, 是否干净)。探测有子进程开销,所以缓存。"""
for exe in _candidates():
if _is_clean(exe):
return exe, True
return str(Path(sys.executable).resolve()), False
def python_argv() -> list[str]:
"""沙箱执行 Python 时的命令前缀(不含脚本名)。
刻意**不用** `-I`:它在 3.11+ 隐含 `-P`,脚本所在目录不会进 sys.path,
于是代码节点的 files 参数(多文件)整个失效 —— `import helper` 报
ModuleNotFoundError。用 `-s -E` 拿到同样的隔离意图(不加 user site、
忽略 PYTHONPATH 之类的环境变量),又不影响同目录 import。
"""
exe, clean = resolve()
flags = ["-s", "-E", "-u"] if clean else ["-S", "-s", "-E", "-u"]
return [exe, *flags]
def describe() -> dict[str, object]:
"""给 health 用:说清楚沙箱到底在用哪个解释器、干不干净。"""
exe, clean = resolve()
return {
"python": exe,
"clean": clean,
"note": (
"解释器本身看不到后端依赖"
if clean else
"没找到干净的解释器,改用 -S 关掉 site-packages(标准库仍可用,第三方包不可见)"
),
}