全部產品
Search
文件中心

Function Compute:建立 API Key

更新時間:Sep 22, 2026

訪問雲沙箱資料面介面時,需要使用 API Key 完成身份認證。通過 E2B SDK、E2B CLI 或直接調用雲沙箱資料面介面前,建議先在Function Compute控制台建立 API Key,並通過環境變數傳入到本地或運行環境中。

前提條件

建立 API Key 前,請確認:

  • 已開通Function Compute服務。

  • 已開通雲沙箱功能。

  • 當前帳號或 RAM 使用者具備管理雲沙箱 API Key 的許可權。

建立 API Key

  1. 進入雲沙箱 API Keys 管理頁面。

  2. 在 API Key 管理頁面,單擊创建 API Key。

  3. 在建立面板中填寫描述,並設定到期時間。

    • 描述:用於標識 API Key 的用途,例如開發環境、生產環境、某個應用或某個團隊。建議使用可追溯的命名,不要唯寫“test”或“default”。

    • 过期时间:可選擇永不到期或自訂到期時間。生產環境建議設定明確的到期時間,並建立輪換機制。

  4. 單擊确定。

  5. 建立成功後,複製完整 API Key 並妥善儲存。

重要:不要把 API Key 寫入代碼倉庫、鏡像、模板、日誌、截圖、工單或前端頁面。API Key 泄露後,應立即禁用或重設。

在 SDK 和 CLI 中使用

E2B SDK 接入雲沙箱時,通常通過環境變數傳入 API Key、API URL 和網域名稱:

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"

新版本 E2B CLI 使用 E2B_API_KEY 認證。E2B_ACCESS_TOKEN 是 E2B 已廢棄的舊認證變數,不建議在新接入流程中使用。如果舊版 CLI 仍要求該變數,請先升級 CLI 後重試。

其中 <region> 需要與雲沙箱所在地區一致。API Key、API URL、網域名稱、模板和 Sandbox 不在同一帳號或同一地區時,可能出現認證失敗、模板不可見、建立失敗或串連失敗。

查看和管理 API Key

在 API Keys 管理頁面,可以查看 API Key 的脫敏值、描述、帳號 ID、狀態、建立時間和到期時間,並按狀態或描述關鍵詞篩選。

API Key 支援以下管理操作:

  • 编辑:修改描述、到期時間,或啟用 / 禁用 API Key。

  • 重置:產生新的 API Key 值。重設後舊值失效,使用舊值的應用會認證失敗。

  • 删除:刪除前需要先禁用 API Key。建議禁用後觀察一段時間,確認沒有業務繼續使用,再執行刪除。

安全建議

  • 按應用、環境、團隊或租戶拆分 API Key,不要多人、多系統共用一個長期 Key。

  • 生產環境優先使用自訂到期時間,並定期輪換。

  • 重設或刪除前,先確認業務側已切換到新 Key。

  • 發現泄露風險時,先禁用或重設 API Key,再排查泄露來源。

  • 需要配置 SDK 參數時,可繼續閱讀通過 SDK 使用雲沙箱。完整接入參數說明參見E2B SDK 接入參數說明。