云沙箱提供 base 和 code-interpreter-v1 两个内置模板。首次使用时系统自动为您的账号创建对应模板，无需手动操作。
base 模板
base 模板提供轻量级基础 Linux 运行环境，适合需要自定义安装依赖或作为其他模板基础的场景。
预装环境
组件 | 版本 |
Python | 3.13（含 pip3） |
Node.js | 20.20（含 npm、corepack、yarn 1.22.19） |
系统工具 | git、sudo、curl、wget、openssh-client、build-essential、netcat、iputils-ping、xz-utils、patch、pkg-config |
包镜像源：已配置阿里云 PyPI 镜像（mirrors.aliyun.com）和 npmmirror.com，国内网络可直接安装依赖。
用户与权限：默认用户 user（uid=1000），拥有 sudo NOPASSWD:ALL 权限，工作目录为 /home/user。
适用场景
需要自定义安装特定依赖的项目。
作为自定义模板的基础环境。
轻量级脚本执行。
code-interpreter-v1 模板
code-interpreter-v1 模板在 base 模板基础上预装了核心数据科学 Python 包，适合 AI Agent 代码执行、数据分析和机器学习推理场景。
预装的 Python 包
包名 | 用途 |
pandas | 数据分析 |
numpy | 数值计算 |
matplotlib | 数据可视化 |
scipy | 科学计算 |
scikit-learn | 机器学习 |
seaborn | 统计可视化 |
plotly | 交互式可视化 |
bokeh | 交互式可视化 |
pillow | 图像处理 |
opencv-python | 计算机视觉 |
nltk | 自然语言处理 |
spacy | NLP 框架 |
librosa | 音频处理 |
ipykernel | Jupyter 内核 |
jupyter_client | Jupyter 客户端 |
额外预装的系统依赖：libgl1、libglib2.0-0（opencv-python 运行时依赖）、libsndfile1（librosa 音频读取）、ffmpeg（音视频处理）。
适用场景
AI Agent 代码执行。
数据分析和可视化。
机器学习模型推理。
自然语言处理和音频处理任务。
模板对比
对比维度 | base | code-interpreter-v1 |
定位 | 轻量级基础环境 | 数据科学环境 |
Python 数据科学包 | 不包含 | 预装 15 个核心包 |
镜像体积 | 较小 | 较大（含数据科学工具链和系统依赖） |
典型用户 | 需要自定义环境的开发者 | AI Agent 开发者、数据分析师 |
两个模板都包含完整的 Python 3.13 和 Node.js 20.20 运行环境。
通过 SDK 使用内置模板
指定模板名称即可创建沙箱实例。
from e2b import Sandbox
# 使用 base 模板
sandbox = Sandbox(template="base")
# 使用 code-interpreter-v1 模板
sandbox = Sandbox(template="code-interpreter-v1")
print(f"沙箱 ID: {sandbox.sandbox_id}")首次使用时，系统自动执行以下流程：
检查当前账号下是否已有该模板。
若不存在，自动创建对应模板。模板默认资源规格为 2 vCPU、2048 MB 内存。
等待模板构建完成，进入就绪状态。
使用就绪的模板创建沙箱实例。
若模板已存在且为就绪状态，直接复用，不会重复创建。您也可以在创建时指定 CPU 和内存参数覆盖默认值。
在控制台查看内置模板
登录函数计算控制台。
在左侧导航栏，选择 。
在内置模板页签下，查看当前账号的内置模板列表。
首次访问内置模板页签时，系统自动为您的账号创建尚未存在的内置模板。
模板列表展示以下信息：
列 | 说明 |
模板名称 | 模板的显示名称。若模板存在多个别名版本，名称旁会显示版本数量。 |
模板 ID | 模板的唯一标识符。 |
资源配置 | 模板的 vCPU 和内存规格。 |
创建时间 | 模板的创建时间。 |
更新时间 | 模板的最近更新时间。 |
构建状态 | 模板当前的构建状态：等待构建、构建中、就绪或失败。仅就绪状态的模板可用于创建沙箱实例。 |
如果您是主账号登录，可以打开展示子账号模板开关，查看子账号下该模板的使用情况。
配置日志
您可以为内置模板配置 SLS 日志服务，用于采集沙箱实例的运行日志。
在模板列表中，单击目标模板名称旁的日志配置状态指示器。
在弹出的对话框中，选择配置方式：
自动配置：系统自动创建日志项目和日志库。
手动配置：手动选择已有的 SLS 日志项目（Project）和日志库（Logstore）。如果还没有日志项目或日志库，可以单击对话框中的链接前往 SLS 控制台创建。
单击确认完成配置。