沙箱挂载NAS
更新时间 2026-10-21 09:59:59
最近更新时间: 2026-10-21 09:59:59
概述
智能体引擎中的沙箱提供了挂载天翼云NAS产品弹性文件服务SFS和海量文件服务OceanFS的能力。通过挂载功能,您可以将NAS实例的指定路径映射为沙箱内的本地文件目录,实现数据的持久化保存、多实例共享。 本章节主要介绍沙箱模板如何配置NAS挂载以及使用E2B SDK动态挂载NAS。
使用场景
跨沙箱实例文件共享场景
智能体引擎中的沙箱支持同一沙箱模板下的所有实例挂载相同的NAS路径,以满足数据与文件持久化存储和共享的需求。
沙箱模板配置中NAS挂载参数
NAS挂载参数说明如下:
| 参数名称 | 是否必填 | 参数说明 |
|---|---|---|
| 弹性文件服务 | 是 | 选择已创建的NAS实例。 |
| VPCE挂载地址 | 是 | 选择NAS实例下的VPCE挂载地址。 |
| 远端目录 | 是 | 远端NAS实例中的绝对路径,以/开头,例如:/sandbox。 |
| 沙箱本地目录 | 是 | 沙箱内的挂载目录,必须是绝对路径,例如:/home/user/nas。 |
注意: 开启NAS挂载的前提是网络配置中开启VPC访问,并且NAS挂载的VPC和网络配置中VPC相同。
E2B SDK动态挂载NAS
除了在沙箱模板中配置NAS挂载,您还可以通过E2B SDK动态挂载NAS。如果模板中已经配置了NAS挂载,SDK挂载的NAS会覆盖模板中的配置。
使用E2B SDK创建沙箱时,通过写入metadata age.sandbox.nas来配置NAS挂载, age.sandbox.nas值为JSON字符串,结构如下:
| 字段名称 | 是否必填 | 说明 |
|---|---|---|
| mountPoints | 是 | NAS挂载点列表。 最多支持5条。 |
| mountDir | 是 | 沙箱内的挂载目录,必须是绝对路径,例如:/home/user/nas。 |
| url | 是 | NAS实例下的VPCE挂载地址。 |
| subdir | 是 | 远端NAS实例中的绝对路径,以/开头,例如:/sandbox。 |
# nas动态挂载
nas_config = {
"mountPoints": [
{
"mountDir": "/home/user/nas",
"url": "192.168.0.1:/mnt/sfs_perf/01******1n",
"subdir": "/sandbox"
}
]
}
sandbox = Sandbox.create(
metadata={
"age.sandbox.nas": json.dumps(nas_config),
},
template='my-template', api_key=apikey, domain=domain, timeout=1800)