CubeSandbox 是什么?

CubeSandbox 是腾讯云开源的 AI Agent 代码执行沙箱,使用 RustVMM 与 KVM 运行 MicroVM,并提供兼容 E2B SDK 的 API。它可单机部署,也可扩展到多节点;Apache-2.0 许可。

⭐ 9,740 Stars 🍴 959 Forks Rust NOASSERTION 作者: TencentCloud
来源:github.com/TencentCloud/CubeSandbox 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

Agent 执行未知代码需要比共享宿主内核的普通容器更强的隔离,同时又要控制启动时间和密度。CubeSandbox 把 MicroVM、快照、eBPF 网络策略、E2B 兼容接口和集群部署放在一个开源项目中;v0.7.1 又补上控制面高可用和外部挂载快照。

来源:github.com/TencentCloud/CubeSandbox (1) · github.com/TencentCloud/CubeSandbox/releases/tag/v0.7.1 (2)

核心功能

MicroVM 硬件隔离

每个沙箱运行独立 Guest OS 内核,虚拟化层由 KVM、CubeHypervisor 与 containerd Shim v2 组成。

来源:github.com/TencentCloud/CubeSandbox/blob/master/docs/architecture/ove…
E2B SDK 兼容接口

CubeAPI 和 CubeProxy 提供 E2B 兼容路径,客户端可通过修改 API URL 接入自建服务;兼容差距仍在官方路线图中。

来源:github.com/TencentCloud/CubeSandbox
快照、克隆和恢复

CubeCoW 提供运行中快照、回滚与分叉;v0.7.1 把 Host Mount 和 Volume Plugin 纳入快照、恢复、回滚和克隆。

来源:github.com/TencentCloud/CubeSandbox/releases/tag/v0.7.1
网络和凭据边界

eBPF 负责沙箱间隔离和出站过滤,L7 代理可按域名、路径和方法控制请求,并在沙箱外注入凭据。

来源:github.com/TencentCloud/CubeSandbox/blob/master/docs/guide/security-p…

技术架构

请求由兼容 E2B 的 CubeAPI 接收,经 CubeMaster 调度到节点,CubeProxy 把后续请求路由至具体沙箱。Cubelet 管理节点生命周期,CubeHypervisor 和 CubeShim 创建 KVM MicroVM,CubeVS 在内核侧执行网络隔离。控制面依赖数据库与 Redis;v0.7.1 把模板中心拆成可独立扩展的服务,并支持 CubeMaster 多副本。

来源:github.com/TencentCloud/CubeSandbox/blob/master/docs/architecture/ove… (1) · github.com/TencentCloud/CubeSandbox/blob/master/docs/changelog/v0.7.1.md (2)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) KVM 或 x86_64 云主机上的 PVM 内核路径KVM 或 x86_64… XFS 挂载点 /data/cubeletXFS 挂载点 /dat… Docker/Compose、MySQL 或 PostgreSQL、RedisDocker/Compose… E2B Python/JavaScript SDK(客户端)E2B Python/Jav… MicroVM 硬件隔离 E2B SDK 兼容接口 快照、克隆和恢复 网络和凭据边界 CubeSandbox 项目本体 核心功能 关键依赖

技术栈

语言Rust 为主,含节点与部署组件框架RustVMM、KVM、containerd Shim v2、eBPF、XFS reflink,Apache-2.0
KVM 或 x86_64 云主机上的 PVM 内核路径XFS 挂载点 /data/cubeletDocker/Compose、MySQL 或 PostgreSQL、Re…E2B Python/JavaScript SDK(客户端)
快速路径要求 root、互联网、glibc >=2.31、至少 4 核/8GB/50GB;PVM 快速开始仅支持 x86_64,ARM64 要使用原生 KVM 的裸金属或自编译路径
来源:github.com/TencentCloud/CubeSandbox/blob/master/docs/guide/quickstart.md

快速上手

先在一次性测试服务器核对架构、glibc、磁盘和 XFS,再按官方文档选择原生 KVM 或 PVM 路径。PVM 路径会安装并切换宿主内核,重启确认 kvm_pvm 后才运行一键安装器;安装完成后创建 sandbox-code 模板,设置 E2B_API_URL 指向本地 3000 端口,用 E2B Code Interpreter SDK执行无敏感数据的最小命令。生产暴露前必须完成官方 Network Hardening。
来源:github.com/TencentCloud/CubeSandbox/blob/master/docs/guide/quickstart.md (1) · github.com/TencentCloud/CubeSandbox/blob/master/docs/guide/network-ha… (2)

使用场景

适合自建 Code Interpreter、需要多租户未知代码隔离的 Agent 平台、已有 E2B 客户端但需要自管基础设施的团队,以及需要快照分叉的评测任务。不适合没有 root/KVM/XFS 条件、不能承担宿主内核与控制面运维,或只需要简单容器任务隔离的小型应用。

来源:github.com/TencentCloud/CubeSandbox

优势与局限

优势

  • 独立 Guest 内核与 eBPF/L7 网络边界结合
  • 兼容 E2B SDK,已有客户端迁移成本较低
  • 支持快照、跨节点恢复、卷插件和控制面高可用
  • 提供裸金属、PVM、Kubernetes 与 Terraform 多种部署文档

局限

  • 快速部署涉及 root、宿主内核、重启、XFS、数据库、Redis 与网络配置,运维成本明显
  • README 的 <60ms 与 <5MB 来自官方特定裸金属和规格测试,不是所有环境的保证
  • E2B API 兼容仍有路线图项目,升级前要跑自己的 SDK 合约测试
  • PVM 快速路径限 x86_64;ARM64 需要原生 KVM 与另一套部署路径
  • Terraform 腾讯云路径会产生云资源费用,但不是运行 CubeSandbox 的必选路径
来源:github.com/TencentCloud/CubeSandbox (1) · github.com/TencentCloud/CubeSandbox/blob/master/docs/guide/quickstart.md (2)

最新版本

最新正式版 v0.7.1 于 2026-09-11 发布,新增端到端控制面高可用、独立 CubeTemplateCenter、CLM 主备,并让带 Host Mount 或 Volume Plugin 的沙箱支持快照、恢复、回滚与克隆;同时包含 virtiofsd 加固、外部 PostgreSQL、S3 快照开关和多项网络、部署修复。v0.7.2-rc1 是 2026-09-21 的预发布版。

来源:github.com/TencentCloud/CubeSandbox/releases/tag/v0.7.1

实测与证据

status: official_docs_checked_not_deployed  |  checked_at: 2026-09-23  |  environment: 核对官方 README、Quick Start、v0.7.1 changelog 与 release 页面;没有 root/KVM 测试机,未安装 PVM 内核、未运行脚本、未创建 MicroVM  |  limitations: 未验证一键安装脚本、内核兼容性、E2B 合约、启动时间、内存、网络隔离、快照一致性、控制面高可用或腾讯云/Kubernetes 部署  |  observed_output: 最新正式版为 v0.7.1,发布于 2026-09-11;v0.7.2-rc1 是预发布版。快速开始要求 glibc >=2.31、XFS、root、至少 50GB,PVM 路径限 x86_64

来源:github.com/TencentCloud/CubeSandbox/releases/tag/v0.7.1 (1) · github.com/TencentCloud/CubeSandbox/blob/master/docs/guide/quickstart.md (2)

同类项目对比

相比 E2B,CubeSandbox 的重点是把兼容 E2B SDK 的 MicroVM 控制面交给用户自建和运维;E2B 官方 SDK 默认连接 E2B Cloud,也提供开源 infra 供自托管研究。已经依赖 E2B SDK、又需要控制数据面、网络和节点时,可评估 CubeSandbox;更看重托管体验和少运维时,应直接比较 E2B Cloud 的当前能力与费用。兼容接口不等于所有行为完全一致。

来源:github.com/TencentCloud/CubeSandbox (1) · github.com/e2b-dev/infra (2)

总结评价

CubeSandbox 适合有 Linux 虚拟化和平台运维能力、确实需要自建强隔离执行面的团队。评估顺序应是先在可回滚服务器验证内核、XFS 与最小 E2B 流程,再测安全策略和容量;只想快速调用托管沙箱时,自建这套控制面可能过重。

来源:github.com/TencentCloud/CubeSandbox/blob/master/docs/guide/quickstart.md

常见问题

普通云服务器没有 /dev/kvm,能安装 CubeSandbox 吗?

x86_64 普通云主机可按官方 Quick Start 安装 PVM 宿主内核,重启后加载 kvm_pvm;这会改动宿主内核,应只在可回滚测试机验证。ARM64 不支持这条 PVM 路径。

CubeSandbox 为什么要求 /data/cubelet 使用 XFS?

官方说明快照和写时复制依赖 XFS reflink。Ubuntu、Debian 和 WSL 常见的 ext4 默认盘不满足要求,需要另行准备并挂载 XFS,至少留出 50GB。

把 E2B_API_URL 改掉就能完全替代 E2B 吗?

客户端迁移入口确实是修改 API URL,但官方路线图仍写有继续补齐 E2B API 兼容差距。上线前要对模板、文件、命令、超时、快照和错误语义跑自己的合约测试。

README 的 60ms 启动和 5MB 开销能直接当容量规划依据吗?

不能。60ms 来自官方裸金属测试,50 并发时平均 67ms、P95 90ms、P99 137ms;内存数字也有规格前提。应在自己的内核、磁盘、镜像和并发下重测。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 10:52.

参考材料:README、GitHub API、依赖文件