FC Extensions(云上扩展)用于将云沙箱(FC Agent Sandbox)接入函数计算和阿里云基础设施能力,包括 VPC 网络配置、自定义域名、存储挂载、日志采集和监控日志。
FC Extensions 不改变 E2B SDK / CLI 的基本使用方式。应用仍然使用 E2B SDK 创建 Sandbox、执行命令、读写文件;VPC、自定义域名、OSS、日志和监控等能力通过函数计算控制台、云沙箱控制面或阿里云相关服务配置生效。接入前应先确认目标能力的配置入口、生效范围和开通状态。
功能列表
VPC 网络配置:让 Sandbox 访问 VPC 内的数据库、内网 API、镜像仓库或其他云资源。
自定义域名:使用固定域名和自有证书访问云沙箱 API 及沙箱内服务。
动态挂载 OSS:通过 metadata 将 OSS 路径挂载到 Sandbox 内,按本地文件路径读取或写入对象。
监控与日志:查看 Sandbox 运行状态和资源指标,并将 Sandbox 内程序打印到 stdout / stderr 的日志采集到日志服务。
Team 配额管理:通过阿里云 POP SDK 为指定 Team 设置 CPU 和内存配额。创建 Team、资源组与订阅计划参见Team 与订阅计划。
创建 OSS Volume:为 OSS Bucket 或 Bucket 子目录创建可复用的 Volume 挂载配置。
创建 AgenticFS Volume:为 AgenticFS AgenticSpace Access Point 创建可复用的 Volume 挂载配置。
使用方式
确认扩展能力是否已开通,以及配置对账号、地域、模板、Sandbox 或会话的生效范围。
在函数计算、云沙箱控制面或相关云产品中完成扩展能力配置。
使用 E2B SDK / CLI 创建 Sandbox。
在 Sandbox 中访问对应网络、路径,或让 Sandbox 内程序输出结构化日志。
在控制台、日志服务或监控页面查看结果。
注意事项
FC Extensions 不是 E2B SDK 新增方法,不需要修改 SDK 导入方式。
VPC、自定义域名、OSS、日志和监控能力需要先完成云上配置,代码示例只展示应用侧如何使用和验证。
如果当前控制台未展示对应云沙箱配置入口,请以云沙箱控制面说明为准,或联系产品支持确认开通方式。
不要在模板、环境变量、日志或挂载路径中暴露长期凭证。
更多配置方式以官方文档为准: