您的位置首页 >人工智能 >

智能体沙箱核心功能系列 03存储与文件系统 —— 根文件系统、持久卷与分发回收怎么设计

智能体沙箱的存储与文件系统,核心要回答五件事:模板根文件系统怎么变成每个沙箱的可写副本、用户数据怎么跨生命周期保存、制品怎么跨节点分发、缓存满了怎么回收、客户端怎么上下传文件。原因在于沙箱是延迟敏感环境,冷启动容不下 GB 级整盘拷贝,所以 "复制" 必须变成 "引用",同时用户数据又必须活得比沙箱本身久。步骤上就是先用写时复制(CoW)解决根文件系统零成本克隆,再用独立持久卷承接长期数据,配合分层缓存回源和引用计数回收,最后通过文件 API 和挂载通道打通上下传。结论就是:存储篇的主线是 "延迟路径做引用不做搬运,用户数据与虚拟机制品分道、永远外置",这也是 E2B、CubeSandbox、OpenSandbox、agent-sandbox 四家方案的共同底色。

一、存储栈要解决的五层问题

层级问题典型答案方向
根文件系统(rootfs)模板镜像怎么变成每沙箱可写副本CoW:reflink / NBD+ext4 / overlayfs
持久卷跨沙箱生命周期的用户数据怎么存独立资源卷、外部对象存储、K8s PVC
制品分发模板 / 快照怎么跨节点到达本地缓存本地缓存 → peer → 对象存储源站,4MiB 分块
容量与回收缓存满了驱逐谁、绝不驱逐在用数据TTL、引用 pin、coldest-build-first
文件传输通道客户端上下传沙箱内文件Filesystem API、上传下载 URL、virtio-fs/NFS 通道

最关键的耦合在第一层:CoW 选型会绑死整个文件系统路线。

二、根文件系统:三条 CoW 路线对比

路线原理优点限制 / 代价代表方案
XFS reflink / FICLONE克隆只改 extent 映射,不拷字节,写入某段才分裂成私有副本创建毫秒级、内核直达、几乎与镜像大小无关源与目标必须在同一文件系统内CubeSandbox、OpenSandbox 快路径
用户态 NBD + ext4块 I/O 转给用户态进程,读先查可写差异层.cow,写只落.cow,base 永不改离线工具链白盒操作(journal 回放、resize2fs、debugfs),支持按 chunk 稀疏回源每次 I/O 多一跳用户态E2B
overlayfs只读下层 + 可写上层叠成一个视图容器默认、实现简单快照多为 commit,通常拿不到内存态OpenSandbox 容器路径、agent-sandbox

一句话:冷启动预算容不下 GB 级拷贝,所以 "复制" 必须变成 "引用"。

三、四家方案横向对比

维度E2BCubeSandboxOpenSandboxagent-sandbox
rootfs 方案用户态 NBD+ext4,空.cow 差异层起步XFS FICLONE reflink容器用 overlayfs;快路径强制 XFS state root+reflink,缺失回退全量拷贝委托容器镜像与节点缓存,不自研 CoW
持久卷形态独立 /volumes 资源 + 创建时 volumeMounts 引用Host Mount、Volume Plugin(CSI 式)、S3 Volume(s3fs/FUSE)创建请求体内联 volumes(host/pvc/ossfs);快路径显式拒绝动态挂卷volumeClaimTemplates→PVC,语义接近 StatefulSet
挂载通道用户态 NFS 借道 veth,openat2 圈禁路径virtio-fs+bind容器 / K8s 原生K8s 原生
分发回源本地 DiffStore→NFS chunk 缓存 (4MiB)→P2P peer→对象存储 origin节点 XFS 落地 + s3 后端上传内容寻址 + DART 块级分发(cache→peer→origin)交给 K8s/CSI
回收水位 + TTL (25h)+pin + 独立 cleaner 按 build 冷度驱逐refcount 守卫,引用未清零删卷返回 409,自动清理较弱不做自动回收;readiness 失败摘标签,旧制品人工退役镜像层与 PVC 生命周期交 K8s/CSI

四、持久卷:API 形态与挂载通道

  • 独立资源 + 创建时引用(事实标准):先建卷,创建沙箱时用 volumeMounts 引用,E2B、Cube 都采用这套形状。
  • 创建时内联:卷只出现在创建请求体,无单独卷 CRUD,代表是 OpenSandbox。
  • CRD 模板:用 K8s 声明式模板为每个沙箱自动配 PVC,代表 agent-sandbox;多沙箱共享一卷属于 K8s RWX 卷范畴,不是一等表达。
  • 挂载通道:virtio-fs+bind 性能最接近本地盘;用户态 NFS 零新块设备但语义≠本地盘;对象存储 FUSE 挂载宜先只读,硬链接、原子 rename 等 POSIX 语义常不完整。

五、分发与回收的关键机制

  • 4MiB chunk:E2B 与 OpenSandbox 的 DART 独立收敛到同一分块粒度,与 diff header 的 "逻辑块→物理位置" 映射对齐。
  • 三层回源:本地 DiffStore 命中直接读 → NFS/P2P 共享缓存 miss 再回源 → 对象存储 origin 为最终权威,每个 chunk 全集群大约只完整拉一次。
  • TTL 与 pin:模板缓存存活期 25h;运行中引用必须 pin(引用计数钉住),未 pin 就删是生产事故。
  • 驱逐策略:cleaner 按整个 build 的冷度(coldest-build-first)驱逐,而不是对单块用 LRU 瞎删。
  • 删除语义两级化:删记录≠删数据,元数据可先删,真删字节要显式操作,且先查引用计数。

六、厂商落地的目录与 API 实践

  • 阿里云 Agent Sandbox Filesystem:提供files.read/write/list/exists/getInfo/makeDir/remove/rename等 API,小文件和流式内容走 API,浏览器等无鉴权环境用 uploadUrl/downloadUrl 并设过期时间;跨沙箱保存的数据必须写外部持久化存储。
  • 火山方舟云沙箱目录布局:文件系统分工作区(/workspace读写)、挂载目录(/mnt下 memory、skills 只读,uploads 只读,outputs、storage 读写)、临时目录(/tmp)三类,权限由平台强制约束,Agent 只能在授权路径读写。
  • 持久化挂载:阿里云支持存储卷 Volume 与动态挂载,数据不随沙箱释放删除;腾讯云 AgentCFS 提供可共享、安全隔离、休眠态可达的文件存储底座。

七、四个行业收敛共识 + 自研建议

共识:

  1. 卷 = 外部引用,永不进快照;卷要活得比沙箱久、可共享,进快照会毁掉这两点。
  2. 4MiB chunk 是分发粒度的共同选择。
  3. 删记录≠删数据,引用计数未清零拒绝删除。
  4. 凭据永不进沙箱:沙箱只见文件系统,不见后端 AK/SK。

自研建议清单:

  1. rootfs 第一天定 XFS reflink,启动实测cp --reflink=always,缺失告警并回退全量拷贝。
  2. 卷 API 用独立资源 + e2b 协议形状(/volumes+volumeMounts),read-only 从第一天进协议。
  3. 挂载通道优先 virtio-fs;对象存储卷第一版只承诺只读。
  4. 引用计数 + 删除守卫必做,挂载状态用声明式对账,别只靠 API 响应回传计数。
  5. 卷与快照关系写进协议:快照只记卷 ID / 挂载点,恢复改挂载点应返回 400。
  6. 分发第一版:内容寻址对象存储 + 本地缓存,chunk=4MiB,P2P 后置。
  7. 驱逐与 pin 同时设计:缓存可丢,卷是承诺。
  8. 删除语义两级化,路径 allowlist+realpath/openat2 圈禁,防 symlink 逃逸。

【常见问题】

问题 1:智能体沙箱的存储与文件系统为什么不直接整盘复制模板镜像?

回答 1:沙箱是延迟敏感环境,冷启动预算容不下 GB 级整盘拷贝,所以采用写时复制(CoW):创建时先共享底层数据,谁先写某一段才复制成私有副本,未写部分继续共享,把 "复制" 变成 "引用"。

问题 2:智能体沙箱的根文件系统 CoW 有哪几条主流路线?

回答 2:三条:XFS reflink/FICLONE(Cube、OpenSandbox 快路径,内核直达、毫秒级创建)、用户态 NBD+ext4(E2B,换离线镜像工具链与稀疏回源)、overlayfs(容器路径默认,内存态快照弱)。

问题 3:智能体沙箱的持久卷为什么不能打进快照?

回答 3:持久卷要活得比沙箱久、还要支持多沙箱共享;卷一旦进快照,生命周期就和沙箱绑死,既无法跨生命周期保留,也破坏了共享能力,因此行业共识是 "卷 = 外部引用,永不进快照"。

问题 4:智能体沙箱的文件分发为什么统一采用 4MiB chunk?

回答 4:4MiB 分块能与差异头里 "逻辑块→物理位置" 的映射对齐,支持 miss 时按需回源整块、原子写回共享缓存;E2B 和 OpenSandbox 的 DART 独立收敛到这一粒度,是多层缓存回源的共同选择。

问题 5:用户在智能体沙箱里上传的文件和最终产物存在哪、怎么取?

回答 5:按平台约定,上传文件挂在只读输入目录(如火山方舟/mnt/session/uploads),最终产物写入产出目录(如/mnt/session/outputs)并由 Files API 注册下载;需要跨沙箱复用的数据走外部持久化存储或对象存储挂载,不随沙箱释放删除。

【参考资料】

  • [2026-11-13](云沙箱参考:关键目录及 Agent 权限)火山方舟文档
  • [2026-11-03](沙箱核心功能系列 03:存储与文件系统,调研 E2B、CubeSandbox、OpenSandbox、agent-sandbox)稀土掘金
  • [2026-10-16](创建 Sandbox 时挂载 AgenticBucket Volume)阿里云帮助中心
  • [2026-10-13](Agent Sandbox 持久化存储)阿里云帮助中心
  • [2026-09-30](文件存储:在 AgentSandbox 沙箱中使用 AgentCFS)腾讯云文档
  • [2026-09-15](Filesystem 概览)阿里云帮助中心

【免责声明】

本文为技术方案调研整理,涉及的 E2B、CubeSandbox、OpenSandbox、agent-sandbox 及各云厂商能力均以官方最新文档为准;文中方案对比仅作架构学习参考,不构成采购或选型承诺,落地前请核对官方 API 与版本。

今日大家都在搜的词: