project
Cube Sandbox - 腾讯云开源的 AI Agent 沙箱执行环境底座
Cube Sandbox 是腾讯云开源的 AI Agent 沙箱执行环境底座,基于 RustVMM 与 KVM 构建,兼具硬件级安全隔离与亚百毫秒启动速度。每个 Agent 运行在独立内核中...
Cube Sandbox是什么
Cube Sandbox 是腾讯云开源的 AI Agent 沙箱执行环境底座,基于 RustVMM 与 KVM 构建,兼具硬件级安全隔离与亚百毫秒启动速度。每个 Agent 运行在独立内核中,单实例内存开销低于 5MB,单机可并发运行数千实例。Cube Sandbox原生兼容 E2B SDK,支持 Agent 应用零成本迁移,已支撑腾讯元宝等亿级产品稳定运行。
Cube Sandbox的主要功能
-
极速沙箱启动:基于资源池化预置与快照克隆技术,实现带完整内核的沙箱 60 毫秒内冷启动就绪,支持高频次 Agent 调用场景。
-
硬件级安全隔离:每个沙箱运行在独立 Guest OS 内核之上,配合 eBPF 网络隔离机制,彻底规避容器逃逸风险,安全执行任意 LLM 生成代码。
-
E2B 接口兼容:原生兼容 E2B SDK 标准,Agent 应用仅需修改环境变量即可无缝迁移,无需改动现有业务代码。
-
高密度并发部署:通过 Rust 底层重写、CoW 内存复用与 reflink 磁盘共享,单实例内存开销低于 5MB,单机可同时运行 2000+ 沙箱实例。
-
Agent 全周期支撑:支持单次代码执行与工具调用,能连续承载 Agent 的”思考—执行—反馈”循环,覆盖从应用运行到 RL 训练的完整场景。
-
精细化网络管控:通过 CubeVS 实现沙箱间网络隔离与出站流量过滤,开发者可自定义 Agent 的访问白名单与黑名单。
-
一键集群部署:支持单节点快速启动与多节点集群扩展,提供从开发环境到生产环境的一键部署能力。
Cube Sandbox的技术原理
- 核心虚拟化架构:基于 RustVMM 与 KVM 构建,每个沙箱运行在独立的 Guest OS 内核之上,从根本上规避 Docker 容器共享内核 Namespace 带来的逃逸风险,实现真正的硬件级隔离。
- 极速启动机制:通过资源池化预置、快照克隆与底层锁优化,跳过传统虚拟机冗长的初始化流程,将带完整内核的沙箱冷启动压缩至 60 毫秒以内。
- 极致资源优化:采用 Rust 重写 Hypervisor 核心,结合 CoW(Copy-on-Write)内存复用与 reflink 磁盘共享技术,将 Hypervisor 自身内存开销压至 5MB 以下,实现单机 2000+ 实例的高密度部署。
- 内核级网络隔离:通过 eBPF 驱动的 CubeVS 组件,在数据平面实现沙箱间的严格网络隔离与细粒度出站流量过滤,替代传统共享网络栈。
- 分布式控制架构:控制平面由 CubeAPI、CubeMaster 与 Cubelet 组成,负责沙箱生命周期与模板管理;数据平面通过 CubeProxy 代理流量,支持从单节点到多节点集群的无缝扩展。
如何使用Cube Sandbox
- 准备 KVM 环境:在 x86_64 Linux 物理机、云裸金属服务器或 WSL2(需 Windows 11 22H2+ 并开启嵌套虚拟化)上,克隆仓库并执行
prepare_image.sh与run_vm.sh初始化运行环境;国内用户可从cnb.cool镜像克隆加速。 - 一键部署服务:在目标环境中执行在线安装脚本:国内用户通过
MIRROR=cn参数使用镜像源,运行curl -sL .../online-install.sh | MIRROR=cn bash完成服务端部署。 - 创建沙箱模板:用
cubemastercli tpl create-from-image基于预置镜像(如sandbox-code:latest)创建代码解释器模板,配置可写层大小与暴露端口,通过tpl watch监控构建进度,等待状态变为READY并记录模板 ID。 - 配置并运行 Agent 代码:安装
e2b-code-interpreterPython SDK,设置E2B_API_URL(指向本地或集群服务端)、E2B_API_KEY、CUBE_TEMPLATE_ID及 SSL 证书路径,通过标准 E2B 接口创建沙箱并执行代码,GitHubexamples/目录提供 Shell 命令、浏览器自动化、OpenClaw 集成等场景示例。
Cube Sandbox的关键信息和使用要求
- 产品定位:腾讯云开源的 AI Agent 沙箱执行环境底座,业内首个兼顾硬件级隔离与亚百毫秒启动的开源沙箱服务。
- 核心性能:冷启动 < 60 毫秒(50 并发平均 67 毫秒),单实例内存开销 < 5MB,单机 96 核服务器可并发运行 2000+ 沙箱实例。
- 安全架构:基于 RustVMM + KVM,每个沙箱拥有独立 Guest OS 内核,配合 eBPF 驱动的 CubeVS 实现内核级网络隔离,彻底规避容器逃逸风险。
- 生态兼容:原生兼容 E2B SDK 接口标准,Agent 应用仅需修改环境变量即可从 Manus、OpenAI Agents SDK 等海外闭源方案零成本迁移。
- 生产验证:诞生于腾讯云 Serverless 体系,承载过百亿级调用,支撑腾讯元宝等亿级用户产品,支持 MiniMax 在 Agentic RL 训练中分钟级调度数十万实例。
Cube Sandbox的核心优势
-
安全与速度兼得:突破传统虚拟机”更安全则更慢”的悖论,在独立内核硬件隔离的前提下实现 60 毫秒冷启动,比行业均值快 2.5 至 50 倍。
-
极致资源效率:单实例内存开销低于 5MB,单机可同时运行 2000+ 沙箱,将 Agent 大规模部署的单位成本压至行业最低水平。
-
零迁移成本:原生兼容 E2B SDK,现有 Agent 应用仅需修改一个环境变量即可从海外闭源方案平滑接入,无需改动任何业务代码。
-
生产级可靠性:经腾讯云 Serverless 体系百亿级调用验证,支撑腾讯元宝等亿级用户产品稳定运行,经受住 MiniMax 分钟级调度数十万实例的极限考验。
-
内核级网络隔离:通过 eBPF 驱动的 CubeVS 实现沙箱间严格网络隔离与细粒度出站管控,彻底杜绝容器逃逸与横向攻击风险。
Cube Sandbox的项目地址
- GitHub仓库:https://github.com/TencentCloud/CubeSandbox
Cube Sandbox的同类竞品对比
| 维度 | Cube Sandbox | E2B(闭源) | Docker 容器 |
|---|---|---|---|
| 隔离级别 | 极高(独立内核 + eBPF 网络隔离) | 中等(依赖具体实现) | 低(共享内核 Namespaces) |
| 启动速度 | < 60ms(毫秒级) | 150–200ms | ~200ms |
| 内存开销 | < 5MB(极限裁剪) | 中等 | 低(共享内核) |
| 部署密度 | 极高(单机数千实例) | 中等 | 高 |
| 开源状态 | 开源(Apache 2.0) | 闭源商业服务 | 开源 |
| E2B SDK 兼容 | 原生兼容(Drop-in) | 原生标准 | 不兼容 |
| 网络隔离 | eBPF 内核级精细过滤 | 基础策略 | 依赖 CNI/iptables |
| 适用场景 | 高并发 Agent 执行与 RL 训练 | Agent 快速接入 | 微服务/常规容器化 |
Cube Sandbox的应用场景
-
AI Agent 代码执行:为 LLM 生成的 Python、Shell 等代码提供硬件级隔离的安全运行环境,防止恶意或错误代码影响宿主机。
-
Agent 工具调用链:支撑 Agent 的”思考—执行—反馈”循环(Harness Loop),连续完成多步工具调用与状态迭代。
-
Agentic 强化学习训练:支持大规模并发沙箱实例的分钟级调度,满足 RL 训练中对高并发、低成本执行环境的极致需求。
-
企业级 AI 编程助手:作为底层执行底座支撑 AI 编程场景,如腾讯元宝迁移后资源核时消耗降低 95.8%。
-
浏览器自动化操作:沙箱内可运行浏览器实例,支持 Agent 完成网页浏览、数据采集、表单填写等自动化任务。