阿里云 AgentRun 沙箱与文件系统：你需要知道的真相
最近不少开发者在尝试阿里云 AgentRun 平台时，对两个概念感到困惑：
- 沙箱 vs 沙箱实例，到底有什么区别？
- 新建沙箱实例时，是不是必须先建一个文件系统（NAS/OSS）才能跑？
本文一次性讲透这两个问题，帮你避开常见的认知陷阱。
一、沙箱是“配方”，实例是“现做的菜”
1. 沙箱（Sandbox Template）
沙箱是一个配置模板，定义了 Agent 运行环境的规格：
- 资源规格（CPU、内存）
- 镜像（内置 Python、Node.js、Chromium 等）
- 挂载策略（是否挂载 NAS/OSS）
- 闲置超时时间（多久不活动自动回收）
你可以把它理解成一份“虚拟机镜像 + 启动参数”的描述文件。
2. 沙箱实例（Sandbox Instance）
沙箱实例是从模板真正拉起的一个隔离运行环境。它是一个轻量级安全容器（基于 RunD MicroVM），具备：
- 独立的
/tmp、/home目录 - 完整的文件系统（临时性）
- 可执行代码、操控无头浏览器的能力
实例的生命周期默认最长 6 小时，闲置超过阈值会被自动回收。
一句话记忆：沙箱是“配方”，沙箱实例是“按配方现做的一道菜”。每道菜吃完就撤，配方留着下次再用。
二、新建沙箱实例，必须建文件系统吗？
答案：不必须。
很多新手看到控制台里有“挂载 NAS / OSS”的选项，以为这是必填项。实际上，沙箱实例自带一块临时的本地文件系统，开箱即用，无需任何外部存储。
两种文件系统对比
| 特性 | 实例本地 FS（内置） | NAS / OSS 挂载（可选） |
|---|---|---|
| 是否需要提前创建 | ❌ 不用，实例启动即有 | ✅ 需要提前在阿里云创建 NAS 或 OSS Bucket |
| 数据持久性 | 实例回收后数据丢失 | 长期保留，跨实例共享 |
| 适用场景 | 单次任务、临时数据 | 跨会话、多 Agent 共享、审计留存 |
| 配置复杂度 | 零配置 | 需配置 VPC、RAM 角色、挂载点等 |
什么时候可以裸跑（不挂载文件系统）？
绝大多数单次 Agent 任务都不需要外部存储：
- 让 Agent 刷一个网页 → 提取数据 → 返回结果
- 用代码解释器跑一段 Python 脚本（算数、绘图、解析上传的文件）
- 调试 / 快速原型验证
在这些场景下，实例自带的 /tmp和 /home完全够用，用完即焚，干净利落。
什么时候才需要挂载 NAS/OSS？
只有以下需求出现时，才值得引入外部文件系统：
- 跨实例续跑：Agent 今天算了一半，明天新实例需要继续读取中间结果
- 多 Agent 共享：多个实例同时读取同一个知识库 / 数据集
- 突破本地盘大小：代码解释器里下载大模型权重，本地空间不够
- 合规留存：操作日志、生成的文件需要长期保存用于审计
⚠️ 挂载 NAS 的前提条件较多：沙箱模板必须配置 VPC、executionRole 要有 NAS 访问权限、NAS 挂载点与模板同 VPC。如果你只是跑一个临时任务，完全没必要趟这趟水。
三、最佳实践：先裸跑，再考虑持久化
对于初次接触 AgentRun 的开发者，建议遵循以下步骤：
- 创建一个最简单的沙箱模板（不挂载任何外部存储）
- 调用 API 或控制台启动一个沙箱实例
- 验证 Agent 能否正常执行任务（代码执行、浏览器操控）
- 如果确实需要数据持久化或共享，再逐步添加 NAS/OSS 挂载
这样既能快速上手，又不会因为配置外部存储而卡住进度。
总结
- 沙箱 ≠ 沙箱实例：前者是配置模板，后者是运行时容器。
- 新建实例不需要文件系统：自带临时本地 FS，足够应付大部分单次任务。
- NAS/OSS 是可选项：只有在跨会话、共享、大容量或合规需求时才需要配置。
记住这两点，你就能轻松驾驭 AgentRun 的沙箱体系，把精力集中在 Agent 逻辑本身，而不是基础设施上。