Buddy Sandboxes icon

Buddy Sandboxes

Buddy Sandboxes 提供隔離且持久的 Linux 機器,可執行 AI 生成的程式碼、應用程式、測試與開發環境,支援檔案保留、指令執行、應用程式端點及程式化控制。

Buddy Sandboxes

用於執行程式碼的持久雲端機器

Buddy Sandboxes 是 Buddy 雲端中的隔離 Linux 機器,可執行 AI 生成的程式碼、應用程式、測試與開發環境。每台機器都配置 CPU 與 RAM、持久的 50 GB 磁碟、已安裝的開發工具,以及可透過 HTTPS 公開應用程式的公開端點。

不同於用完即丟的執行容器,Sandbox 會在工作階段之間保留磁碟狀態。團隊和代理程式可以安裝套件、複製儲存庫、執行指令、監控應用程式、檢視記錄,並透過 SSH 連線。Sandbox 可透過 CLI 互動式建立及操作,也可透過 SDK、REST API、YAML、管線及 MCP 自動化。

主要功能

持久的 Linux 機器

每個 Sandbox 都會以隔離的 Linux 機器執行,並配備持久的 50 GB 磁碟。重新啟動後,檔案、已安裝的套件、設定及快取仍可使用。

根層級管理

buddy 使用者具備免密碼 sudo 權限,因此可以在 Sandbox 中安裝套件及系統使用者,並執行 Docker。

指令、檔案及應用程式

執行具備串流輸出及結束代碼的指令、傳輸檔案及目錄、複製儲存庫或擷取成品,並透過獨立的記錄檔管理長時間執行的應用程式。

公開應用程式端點

透過公開 HTTPS 端點公開應用程式連接埠,並可選擇使用 Buddy 登入及請求記錄,以檢查傳入流量。

快照及可重複的環境

使用快照從準備好的環境建立新的 Sandbox,其中包含系統套件、儲存庫、執行環境及相依性快取。

多種管理介面

可透過 CLI、TypeScript SDK、REST API、YAML、管線或 MCP 建立及操作 Sandbox,取決於工作是互動式、自動化或由代理程式驅動。

使用情境

  • AI 程式碼工作區

    為代理程式提供隔離的 Linux 環境,讓它可以安裝相依套件、編輯檔案、執行測試及進行變更,而不會修改開發者的筆記型電腦或正式環境系統。

  • 預覽環境

    為每個分支或提取要求建立一台機器,透過公開 URL 公開執行中的應用程式,讓團隊成員或客戶檢視結果。

  • 自動化測試

    執行完整的測試環境,執行指令及應用程式檢查、收集結束代碼與記錄,並在測試工作流程完成後銷毀 Sandbox。

  • 應用程式託管

    讓應用程式在未設定逾時的機器上持續執行,透過端點公開應用程式,並使用受支援的 Buddy 工作流程搭配自訂網域。

  • 遠端開發

    使用 SSH 及 VS Code Remote-SSH,在遠端 Linux 環境中工作,並在工作階段之間保留其檔案、套件及設定。

Pros and Cons

Pros

  • 持久的本機磁碟可在工作階段之間保留檔案、套件、資料庫及建置快取。
  • 免密碼 sudo、SSH 存取及 Docker-in-Sandbox 支援,可啟用傳統的 Linux 開發工作流程。
  • 指令、檔案傳輸、應用程式、端點、記錄、快照及生命週期操作,皆可透過有文件說明的介面使用。
  • 已設定的應用程式可在開機時重新啟動,而端點流量或指令可以喚醒已停止的 Sandbox。

Cons

  • 執行中的程序及記憶體中的狀態無法在停止後保留;只有持久磁碟上的資料會保留。
  • TypeScript SDK 需要 Node.js 20 或更新版本,目前發布版本尚未達到 1.0,且版本之間可能有所變更。
  • 官方 SDK 文件列出的支援 SDK 語言為 TypeScript;其他技術堆疊需使用 REST API。

FAQ

什麼是 Buddy Sandboxes?

Sandbox 是一台具備自身作業系統、CPU 與 RAM 配置、持久磁碟、應用程式及公開端點的隔離 Linux 機器。其設計更接近持久的虛擬機器,而非一次性容器。

Sandbox 重新啟動時會保留哪些內容?

持久磁碟中的資料,包括檔案、已安裝的套件、資料庫內容及建置快取,會在停止及重新啟動後保留。記憶體不會持久保存:執行中的程序會終止,而 Sandbox 設定中定義的應用程式會在機器啟動時再次啟動。

我需要 Dockerfile 嗎?

不需要。您可以設定機器,將其儲存為快照,然後從該準備好的狀態建立新的 Sandbox。對於這類工作流程,無需建置及推送 Docker 映像檔。

如何管理 Sandbox?

Sandbox 可透過 Web UI、CLI、TypeScript SDK、REST API、YAML、管線及 MCP 進行管理。SDK 支援生命週期操作、指令、檔案、應用程式、快照及設定變更;終端機存取、SSH 及自訂網域則可透過 UI 和 CLI 使用。

Sandbox 停止時會發生什麼事?

Sandbox 停止時,運算費用會停止,但保留的磁碟儲存空間仍會持續計費。對其端點發出請求或執行指令可以喚醒它,而設定好的應用程式會在機器啟動時重新啟動。

Quick Facts

類別
開發者工具/雲端程式碼執行
平台
Buddy 雲端;隔離的 Linux 機器
作業系統
Ubuntu 22.04 LTS 或 Ubuntu 24.04 LTS
儲存空間
每個 Sandbox 50 GB 持久磁碟
資源
從 1 CPU/2 GB RAM 到 12 CPU/24 GB RAM
管理方式
Web UI、CLI、TypeScript SDK、REST API、YAML、管線及 MCP