README

CubeSandbox


  一个极速启动、高并发、安全且轻量化的 AI Agent 沙箱服务




  



  
  
  
  
  



  
  
  
  




  English ·
  快速开始 ·
  文档 ·
  变更日志 ·
  微信交流群 ·
  X(Twitter) ·
  成为星级贡献者 ·
  用户案例提报


---

Cube Sandbox 是一款基于 RustVMM 与 KVM 构建的高性能、开箱即用的安全沙箱服务。它既支持单机部署，也能方便地扩展到多机集群。对外兼容 E2B SDK，可在 60ms 内创建具备完整服务能力的硬件隔离沙箱，并将内存开销控制在 5MB 以内。



  
  


 📰 动态


  
    
      
        
      
    
    
      v0.7：跨节点暂停恢复、控制面与运维分离、沙箱网络提速
      跨节点暂停恢复 — 配合 S3 后端，沙箱支持跨节点暂停/恢复，并可从快照创建沙箱（preview）
      控制面与运维分离 — 节点管理能力拆分至 CubeOps，支持多副本部署，新增 cubeopscli 运维工具
      更新日志 →
    
  
  
    
      
        
      
    
    
      v0.6：K8s 部署、Volume 框架、模板别名支持
      K8s 部署 — 支持在K8s中部署Cube的控制面组件及计算节点
      Volume框架 — 在兼容e2b标准的前提下允许用户以插件的形式自定义后端存储方案
      模板别名 — 支持在创建模板时，为模板设置别名，并通过指定别名来创建沙箱。
      更新日志 → ·
      K8s 部署 → ·
      Volume 插件 →
    
  
  
    
      
        
      
    
    
      v0.5：自动暂停恢复、Terraform 一键集群、ARM64 全栈支持、沙箱网络策略增强
      自动暂停恢复 — 闲置沙箱自动暂停，新请求到达时毫秒级唤醒。Terraform 一键集群部署 ARM64 全栈原生支持 沙箱网络策略增强 — 流量令牌鉴权、出向策略路由。
      更新日志 → ·
      Terraform 部署 →
    
  
  
    
      
        
      
    
    
      v0.4：出站更安全，运维更省心
      凭证托管 — Agent 照常调外部 API，Key 不进沙箱。控制台 — 版本矩阵、模板健康检查，升级后该不该重建一眼可见。
      更新日志 → ·
      安全代理指南 → ·
      WebUI 指南 →
    
  
  
    
      
        
      
    
    
      百毫秒级快照、克隆与回滚能力
      CubeSandbox 0.3.0 引入 CubeCoW Copy-on-Write 快照引擎，支持沙箱状态的事件级快照、即时克隆以及回滚到任意历史状态。
      更新日志 →
    
  
  
    
      
        
      
    
    
      🎉 正式开源首发
      Cube Sandbox 正式开源！毫秒级启动、硬件级隔离、E2B 兼容的 AI Agent 安全沙箱服务。
      更新日志 →
    
  


 产品能力一览


  
    
      ⚡ 极速启动
      资源池化预置 + 快照克隆，跳过所有冷启动开销。平均 <60ms 冷启动，创建沙箱比一次眨眼都快。
      快速开始 →
    
    
      🔒 硬件级隔离
      每个沙箱配备独立操作系统内核，运行在专属 MicroVM 中。
      架构概览 →
    
    
      🔌 E2B 生态兼容
      兼容 E2B SDK 接口，替换一个环境变量即可从 E2B 云无缝切换，零业务代码改动。
      示例项目 →
    
  
  
    
      📦 高密度部署
      单沙箱额外开销 <5MB，通过内核共享与写时复制（CoW），单机可运行数千个实例。支持沙箱的自动暂停及恢复，进一步提升部署密度，实现成本优化。
      快速开始 →
    
    
      🛡️ 网络安全
      基于 eBPF 的内核态沙箱间网络隔离与出站过滤；内置 L7 安全代理支持按域名/路径/方法的精细策略及自动凭证注入，密钥对沙箱内代码不可见。
      安全代理指南 →
    
    
      📸 灵活的状态管理
      百毫秒级的高频快照与回滚。支持对运行中沙箱创建检查点，随时回滚到任意快照状态，或从指定状态快速创建分叉探索环境。
      v0.3 更新日志 →
    
  
  
    
      💾 Volume 框架
      兼容 E2B 标准的 Volume 框架，允许用户以插件形式自定义后端存储方案。Volume 拥有独立生命周期，可跨沙箱共享。
      Volume 插件 →
    
    
      🚀 生产部署
      支持在腾讯云上使用 Terraform 一键部署生产集群。同时支持在标准 K8s 集群中部署（preview）。
      Terraform 部署 → ·
      K8s 部署 →
    
    
      💪 ARM 架构支持
      ARM64 全栈原生支持，覆盖编译、构建、部署全流程。
      裸机部署 →
    
  


 视频演示


  
    
      
    
    
      
    
    
      
    
    
      
    
  
  
    
      安装及功能演示
    
    
      性能测试
    
    
      RL 场景 (SWE-Bench)
    
    
      快照 · 克隆 · 回档
    
  



 性能与方案对比 (Benchmarks)

在 AI Agent 代码执行场景下，Cube Sandbox 实现了安全与性能的兼得：

| 维度 | Docker 容器 | 传统虚拟机 (VM) | CubeSandbox |
|---|---|---|---|
| 隔离级别 | 低 (共享内核 Namespaces) | 高 (独立内核) | 极高 (独立内核 + eBPF网络隔离) |
| 启动速度 完整启动OS时长 | 200ms | 秒级 | 毫秒级 ( Cube Sandbox 测试数据说明：其中，启动速度项基于裸金属环境测试，单并发下为 60ms，50 并发场景下平均 67ms（P95 90ms，