Files
AgentLab/backend/app/tools/builtin/files.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

110 lines
3.4 KiB
Python

from __future__ import annotations
from pathlib import Path
from typing import Any
from pydantic import BaseModel, Field
from app.core.config import settings
from app.tools.registry import ToolContext, register
_MAX_READ = 200_000
def _resolve(rel: str, ctx: ToolContext) -> Path:
"""把相对路径锁死在这次运行自己的工作目录里。
两道关都要过:session_dir() 先净化 session_id 再定根目录,然后 rel
先 resolve 再比对根。少了第一道,`../../etc/passwd` 里的越界检查就是
在一个被挪到 /etc 的"根"下面做的,检查照样通过——这正是之前的漏洞。
"""
root = settings.session_dir(ctx.sandbox_session)
root.mkdir(parents=True, exist_ok=True)
target = (root / rel.lstrip("/")).resolve()
if target != root and root not in target.parents:
raise ValueError(f"路径越界:{rel}")
return target
class FileReadArgs(BaseModel):
path: str = Field(description="相对工作目录的文件路径")
@register(
name="file_read",
category="文件",
description="读取工作目录下的文件内容。",
args_schema=FileReadArgs,
)
async def file_read(ctx: ToolContext, **kwargs: Any) -> dict[str, Any]:
args = FileReadArgs(**kwargs)
try:
target = _resolve(args.path, ctx)
except ValueError as e:
return {"error": str(e)}
if not target.exists():
return {"error": f"文件不存在:{args.path}"}
if target.is_dir():
return {"error": f"{args.path} 是目录,用 file_list"}
data = target.read_bytes()[:_MAX_READ]
return {
"path": args.path,
"size": target.stat().st_size,
"content": data.decode("utf-8", errors="replace"),
"truncated": target.stat().st_size > _MAX_READ,
}
class FileWriteArgs(BaseModel):
path: str = Field(description="相对工作目录的文件路径")
content: str = Field(description="要写入的内容")
append: bool = Field(default=False, description="追加而不是覆盖")
@register(
name="file_write",
category="文件",
description="写入文件到工作目录。父目录会自动创建。",
args_schema=FileWriteArgs,
dangerous=True,
)
async def file_write(ctx: ToolContext, **kwargs: Any) -> dict[str, Any]:
args = FileWriteArgs(**kwargs)
try:
target = _resolve(args.path, ctx)
except ValueError as e:
return {"error": str(e)}
target.parent.mkdir(parents=True, exist_ok=True)
with target.open("a" if args.append else "w", encoding="utf-8") as f:
f.write(args.content)
return {"path": args.path, "bytes": target.stat().st_size, "ok": True}
class FileListArgs(BaseModel):
path: str = Field(default=".", description="要列出的目录")
@register(
name="file_list",
category="文件",
description="列出工作目录下的文件。",
args_schema=FileListArgs,
)
async def file_list(ctx: ToolContext, **kwargs: Any) -> dict[str, Any]:
args = FileListArgs(**kwargs)
try:
target = _resolve(args.path, ctx)
except ValueError as e:
return {"error": str(e)}
if not target.exists():
return {"path": args.path, "entries": []}
entries = [
{
"name": p.name,
"type": "dir" if p.is_dir() else "file",
"size": p.stat().st_size if p.is_file() else None,
}
for p in sorted(target.iterdir())[:500]
]
return {"path": args.path, "entries": entries}