Buddy Sandboxes icon

Buddy Sandboxes

Buddy Sandboxes 提供隔离且持久的 Linux 机器,可运行 AI 生成的代码、应用、测试和开发环境,支持文件保留、命令执行、应用端点及 API 控制。

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 访问以及 Sandbox 内运行 Docker 的支持,可实现常规 Linux 开发工作流。
  • 命令、文件传输、应用、端点、日志、快照和生命周期操作均可通过有文档说明的接口使用。
  • 已配置的应用可在启动时自动重启,而端点流量或命令可以唤醒已停止的 Sandbox。

Cons

  • 停止后,正在运行的进程和内存中的状态不会保留;只有持久化磁盘数据会保留。
  • TypeScript SDK 需要 Node.js 20 或更高版本,目前发布版本低于 1.0,不同版本之间可能会发生变化。
  • 官方 SDK 文档列出的支持 SDK 语言为 TypeScript;其他技术栈需使用 REST API。

FAQ

什么是 Buddy Sandboxes?

Sandbox 是一台隔离的 Linux 机器,拥有独立的操作系统、CPU 和 RAM 配额、持久化磁盘、应用及公共端点。它的设计更接近持久化虚拟机,而不是一次性容器。

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