文档中心

AI 原生 BaaS 平台 Supabase 版

沙箱服务

使用沙箱

沙箱（Sandbox）是 AI 原生 BaaS 平台 Supabase 版为使用 Supabase 引擎的 Workspace 提供的隔离运行环境，用于在受控、可回收的环境中运行命令、调用大模型或执行代码。您可以在控制台的「沙箱使用」页面选择模板、输入命令并快速创建沙箱执行。

背景信息

沙箱基于模板创建，平台预置了多种模板（如 opencode、claude、base、code-interpreter、codex 等），不同模板预装的运行时和工具不同。

前提条件

操作步骤

模板说明

模板列表中展示当前可用的沙箱模板。选中某一模板后，右侧展示其详细信息：

字段	说明
模板描述	模板的用途说明，例如 opencode 模板描述为 e2b sandbox opencode template。
模板大小	模板镜像大小，例如 800MB。
预装工具	模板中已预装的运行时和工具，例如 python、node、git、opencode。
最近更新时间	模板最近一次更新的时间。

说明

不同模板预装的工具链不同，请根据要执行的命令选择合适的模板。例如需要运行 Python 代码时选择预装 Python 的模板，需要调用 opencode 时选择 opencode 模板。

通过 SDK 调用沙箱

沙箱使用页面下方的使用示例区域提供了通过 SDK 创建并调用沙箱的代码示例。典型流程为：使用 Supabase 账号密码登录获取 access token，调用 initBytedSupabaseSandbox 完成初始化，再通过 Sandbox.create 创建沙箱并执行命令。示例代码如下：

执行状态说明

状态	说明
待执行	命令输入完成，尚未单击「创建沙箱并执行」。命令输入框可编辑，页面显示「创建沙箱并执行」按钮。
流式输出中	已创建沙箱并正在执行，页面提示「正在创建沙箱并等待输出...」，命令输入框只读，操作按钮变为「停止」。
执行完成	命令执行成功，「执行结果」区域展示输出内容，退出码为 0。
执行失败	命令执行异常，「执行结果」区域展示错误日志，并显示非 0 退出码。