函数计算 CFC

沙箱实例

更新时间：2025-11-06

前提条件

请按照文档配置环境变量。
目前仅支持官方代码沙箱，即template名为 code-interpreter-v1。

创建代码沙箱

创建默认代码沙箱实例：

            Python
        
            JavaScript
        
            from e2b_code_interpreter import Sandbox 
sandbox = Sandbox.create(）
        
            import { Sandbox } from '@e2b/code-interpreter'
const sandbox = await Sandbox.create()

创建指定模板和超时时间的代码沙箱实例

            Python
        
            JavaScript
        

            from e2b_code_interpreter import Sandbox 
# 创建一个代码沙箱,指定模板为code-interpreter-v1
# 您可以在创建时指定超时时间，不指定时默认为300s
# 当沙箱的运行时间超过超时时间时，沙箱将会被自动删除
sandbox = Sandbox.create(
    template="code-interpreter-v1",
    timeout=60 # 单位为秒
)
        

            import { Sandbox } from '@e2b/code-interpreter'

// 创建一个沙箱，其超时设置为60s,注意单位是毫秒
const sandbox = await Sandbox.create({
  timeoutMs: 60_000,
})
        

获取沙箱信息

            Python
        
            JavaScript
        

            from e2b_code_interpreter import Sandbox

# 创建一个沙箱，其超时设置为60s
sandbox = Sandbox.create(timeout=60)

# 获取沙箱信息
info = sandbox.get_info()

print(info)

# SandboxInfo(sandbox_id='abcddxxxxxxx',
#   template_id='code-interpreter-v1',
#   metadata={},
#   started_at=datetime.datetime(2025, 10, 24, 15, 42, 59, 255612, tzinfo=tzutc()),
#   end_at=datetime.datetime(2025, 10, 24, 15, 47, 59, 255612, tzinfo=tzutc())
# )
        

            import { Sandbox } from '@e2b/code-interpreter'

// 创建一个沙箱，其超时设置为60s
const sandbox = await Sandbox.create({ timeoutMs: 60_000 })

// 获取沙箱信息
const info = await sandbox.getInfo()

console.log(info)

// {
//   "sandboxId": "xxxxxxxxxxxx",
//   "templateId": "xxxxx",
//   "name": "xxx",
//   "metadata": {},
//   "startedAt": "2025-10-24T15:37:58.076Z",
//   "endAt": "2025-10-24T15:42:58.076Z"
// }
        

删除沙箱

然后在您的代码中使用 dotenv 库来引入，通过该种方式引入的环境变量在当前代码范围内生效。

            Python
        
            JavaScript
        

            from e2b_code_interpreter import Sandbox
# 创建沙箱
sandbox = Sandbox.create()
# 删除沙箱
sandbox.kill()
        

            import { Sandbox } from '@e2b/code-interpreter'
// 创建沙箱
const sandbox = await Sandbox.create({ timeoutMs: 60_000 })

// 立即删除沙箱
await sandbox.kill()
        

更新沙箱生存时间

您可以更新已在运行中的沙箱的生存超时时间。

            Python
        
            JavaScript
        
            from e2b_code_interpreter import Sandbox

# 创建一个60s超时的沙箱
sandbox = Sandbox.create(timeout=60)

# 更新沙箱的超时时间为 30s
sandbox.set_timeout(30)
        
            import { Sandbox } from '@e2b/code-interpreter'

//  创建一个60s超时的沙箱
const sandbox = await Sandbox.create({ timeoutMs: 60_000 })

// 更新沙箱的超时时间为 30s
await sandbox.setTimeout(30_000)

获取沙箱列表

            Python
        
            JavaScript
        

            from e2b_code_interpreter import Sandbox
# 调用list方法获取分页器
paginator = Sandbox.list()
# 若分页器还有下一页，则取出下一页
while paginator.has_next:
    page = paginator.next_items()
    # 打印当前取出页的沙箱实例信息
    for sandbox_info in page:
        print(sandbox_info)
# 也可以指定一页中有多少实例
paginator_limit_5 = Sandbox.list(limit=5)
# 也可以获取当前分页器的偏移值
print(paginator_limit_5.next_token) # None
if paginator_limit_5.has_next:
    paginator_limit_5.next_items()
print(paginator_limit_5.next_token) # offset_5
        

            import { Sandbox } from '@e2b/code-interpreter'

// 创建沙箱
const sandbox = await Sandbox.create({ timeoutMs: 60_000 })
// 获取沙箱列表
const paginator = Sandbox.list()

// 获取沙箱列表的第一页
const firstPage = await paginator.nextItems()

const runningSandbox = firstPage[0]

console.log('Running sandbox metadata:', runningSandbox.metadata)
console.log('Running sandbox id:', runningSandbox.sandboxId)
console.log('Running sandbox started at:', runningSandbox.startedAt)
console.log('Running sandbox template id:', runningSandbox.templateId)

// 获取沙箱列表下一页
const nextPage = await paginator.nextItems()
        

连接到已running沙箱

获取沙箱ID

            Python
        
            JavaScript
        

            from e2b_code_interpreter import Sandbox

# 获取运行中沙箱列表
paginator = Sandbox.list()

# 获取一个你想连接的沙箱id
running_sandboxes = paginator.next_items()
if len(running_sandboxes) == 0:
    raise Exception("No running sandboxes found")

# 获取一个你想连接的沙箱id
sandbox_id = running_sandboxes[0].sandbox_id
        

            import { Sandbox } from '@e2b/code-interpreter'
const sbx = await Sandbox.create()

// 获取运行中沙箱列表
const paginator = await Sandbox.list({
  query: { state: ['running'] },
})
// 获取一个你想连接的沙箱id
const runningSandboxes = await paginator.nextItems()
if (runningSandboxes.length === 0) {
  throw new Error('No running sandboxes found')
}

// 获取一个你想连接的沙箱id
const sandboxId = runningSandboxes[0].sandboxId
        

连接沙箱

            Python
        
            JavaScript
        

            from e2b_code_interpreter import Sandbox

# 获取运行中沙箱列表
running_sandboxes = Sandbox.list()

# 获取一个你想连接的沙箱id
if len(running_sandboxes) == 0:
  raise Exception("No running sandboxes found")

sandbox_id = running_sandboxes[0].sandbox_id

# 连接沙箱
sandbox = Sandbox.connect(sandbox_id)
# 现在您可以直接使用沙箱了
# ...
        

            import { Sandbox } from "@e2b/code-interpreter"

//  获取运行中沙箱列表
const runningSandboxes = await Sandbox.list()

if (runningSandboxes.length === 0) {
  throw new Error("No running sandboxes found")
}

// 获取一个你想连接的沙箱id
const sandboxId = runningSandboxes[0].sandboxId

//  连接沙箱
const sandbox = await Sandbox.connect(sandboxId)
// 现在您可以直接使用沙箱了
// ...
        

环境准备及环境变量配置

文件系统