FC Extensions(雲上擴充)用於將雲沙箱(FC Agent Sandbox)接入Function Compute和阿里雲基礎設施能力,包括 VPC 網路設定、自訂網域名、儲存掛載、日誌採集和監控日誌。
FC Extensions 不改變 E2B SDK / CLI 的基本使用方式。應用仍然使用 E2B SDK 建立 Sandbox、執行命令、讀寫檔案;VPC、自訂網域名、OSS、日誌和監控等能力通過Function Compute控制台、雲沙箱控制面或阿里雲相關服務配置生效。接入前應先確認目標能力的配置入口、生效範圍和開通狀態。
功能列表
VPC 網路設定:讓 Sandbox 訪問 VPC 內的資料庫、內網 API、鏡像倉庫或其他雲資源。
自訂網域名:使用固定網域名稱和自有認證訪問雲沙箱 API 及沙箱內服務。
動態掛載 OSS:通過 metadata 將 OSS 路徑掛載到 Sandbox 內,按本地檔案路徑讀取或寫入對象。
監控與日誌:查看 Sandbox 運行狀態和資源指標,並將 Sandbox 內程式列印到 stdout / stderr 的日誌採集到Log Service。
Team 配額管理:通過阿里雲 POP SDK 為指定 Team 設定 CPU 和記憶體配額。建立 Team、資源群組與訂用計畫參見Team 與訂用計畫。
建立 OSS Volume:為 OSS Bucket 或 Bucket 子目錄建立可複用的 Volume 掛載配置。
建立 AgenticFS Volume:為 AgenticFS AgenticSpace Access Point 建立可複用的 Volume 掛載配置。
使用方式
確認擴充能力是否已開通,以及配置對帳號、地區、模板、Sandbox 或會話的生效範圍。
在Function Compute、雲沙箱控制面或相關雲產品中完成擴充能力配置。
使用 E2B SDK / CLI 建立 Sandbox。
在 Sandbox 中訪問對應網路、路徑,或讓 Sandbox 內程式輸出結構化日誌。
在控制台、Log Service或監控頁面查看結果。
注意事項
FC Extensions 不是 E2B SDK 新增方法,不需要修改 SDK 匯入方式。
VPC、自訂網域名、OSS、日誌和監控能力需要先完成雲上配置,程式碼範例只展示應用側如何使用和驗證。
如果當前控制台未展示對應雲沙箱配置入口,請以雲沙箱控制面說明為準,或聯絡產品支援確認開通方式。
不要在模板、環境變數、日誌或掛載路徑中暴露長期憑證。
更多配置方式以官方文檔為準: