通過 CLI 使用雲沙箱 - Function Compute

前置條件

已擁有阿里雲帳號，並具備Function Compute相關操作許可權。
已在Function Compute控制台建立 API Key。
已確認目標地區支援雲沙箱，並且本機網路可訪問該地區的雲沙箱服務。
已安裝滿足版本要求的 E2B CLI。版本要求參見使用約束。

1. 安裝 CLI

macOS 可以使用 Homebrew：

brew install e2b

也可以使用 npm：

npm i -g @e2b/cli@2.20.0

安裝後檢查版本：

e2b --version

2. 配置環境變數

配置 API Key、API URL 和網域名稱。API Key 的建立和管理方式參見建立 API Key。

export E2B_API_KEY="<your-api-key>"
export E2B_API_URL="https://api.<region>.e2b.fc.aliyuncs.com"
export E2B_DOMAIN="<region>.e2b.fc.aliyuncs.com"

其中 <region> 為雲沙箱服務所在地區。支援地區和 Endpoint 規則參見使用約束。

E2B_ACCESS_TOKEN 是 E2B 已廢棄的舊認證變數。新版本 E2B CLI 應使用 E2B_API_KEY。如果舊版 CLI 仍要求 E2B_ACCESS_TOKEN，請先升級 CLI 後重試。

可以先列出 Sandbox 驗證配置是否生效：

e2b sandbox list

3. 查看模板

e2b template list

輸出中可以看到當前帳號可用的模板。以下只展示輸出格式，模板 ID、規格、建立時間和狀態會隨帳號、地區和模板配置變化：

Access  Template ID    Template Name         vCPUs  RAM MiB  Created at    Disk size MiB  names                buildStatus
Public  <template-id>  code-interpreter-v1       2     2048  <created-at>          15360  code-interpreter-v1  ready

4. 建立並串連 Sandbox

e2b sandbox create code-interpreter-v1

進入 Sandbox 終端後，可以執行：

python3 -c 'print("hello from sandbox")'
exit

5. 串連已有 Sandbox

如果已有運行中的 Sandbox，可以通過 Sandbox ID 重新串連互動式終端：

e2b sandbox connect <sandbox-id>

退出終端只會關閉本地終端會話，不會自動終止該 Sandbox。

6. 在 Sandbox 中執行命令

也可以不進入互動式終端，直接在已有 Sandbox 中執行命令：

e2b sandbox exec <sandbox-id> ls

命令輸出會返回到本地終端。

7. 查看 Sandbox 指標

查看運行中 Sandbox 的 CPU、記憶體指標：

e2b sandbox metrics <sandbox-id>

當前指標按 1 分鐘粒度返回，適合調試和觀察資源使用趨勢。

8. 查看和終止 Sandbox

查看 Sandbox 列表：

e2b sandbox list

終止不再使用的 Sandbox：

e2b sandbox kill <sandbox-id>

任務完成後建議主動終止 Sandbox，避免資源持續佔用。

下一步

使用 SDK 在應用中建立和管理 Sandbox，參見通過 SDK 使用雲沙箱。