沙箱https://github.com/TencentCloud/CubeSandboxCube Sandbox 是一款基于 RustVMM 与 KVM 构建的高性能、开箱即用的安全沙箱服务。它既支持单机部署也能方便地扩展到多机集群。对外兼容 E2B SDK可在 60ms 内创建具备完整服务能力的硬件隔离沙箱并将内存开销控制在 5MB 以内。产品能力一览⚡ 毫秒启动 · 高密度· 自动暂停恢复平均 60ms 冷启动单实例额外开销 5MB单机轻松跑起数千 Agent。支持沙箱的自动暂停及恢复实现成本优化快速开始 → 硬件级隔离每个沙箱独立 Guest OS 内核告别 Docker 共享内核放心跑大模型生成的未知代码架构概览 → E2B 无缝迁移原生兼容 E2B SDK替换一个 URL 环境变量即可接入零业务代码改动示例项目 →️ Web 控制台浏览器管集群沙箱、模板、节点、版本矩阵装完即开:12088WebUI 指南 → 凭证托管Agent 照常调 LLM 与外部 APIKey 不进沙箱、不进模型上下文、不落日志安全代理指南 →️ 出站管控域名白名单放行、越权出站当场拦截全量访问留审计日志方便合规安全代理指南 → 快照 · 克隆 · 回档百毫秒级检查点运行中随时快照回滚到任意状态或分叉探索v0.3 更新日志 → 模板体系OCI 镜像一键转模板模板商店装官方预置环境跨节点自动分发模板指南 → AgentHub 数字助手基于 OpenClaw 一键创建 AI 助手支持快照、回档与助手模板发布数字助手 →性能与方案对比 (Benchmarks)在 AI Agent 代码执行场景下Cube Sandbox 实现了安全与性能的兼得维度Docker 容器传统虚拟机 (VM)CubeSandbox隔离级别低 (共享内核 Namespaces)高 (独立内核)极高 (独立内核 eBPF网络隔离)启动速度*完整启动OS时长200ms秒级毫秒级 ( 60ms)内存开销低共享内核高 (完整 OS )低 (极限裁剪 5MB)部署密度高低极高 (单机数千实例)E2B SDK 兼容//✅ 完全兼容 (Drop-in)Cube Sandbox 测试数据说明其中启动速度项基于裸金属环境测试单并发下为 60ms50 并发场景下平均 67msP95 90msP99 137ms整体保持在百毫秒级。内存开销项基于 ≤ 32GB 规格沙箱实测更大规格下开销会略有上升但幅度极小。详细的创建时延和资源消耗情况可参考 核心操作性能基准测试报告裸金属 与 PVM 云服务器测试报告。编辑编辑编辑单 / 高并发场景下百毫秒级的沙箱交付不同规格沙箱 Cube Sandbox 自身内存消耗*其中蓝色部分为沙箱规格橙色部分为对应规格下消耗内存随着规格扩大内存消耗呈现少量增长快速开始编辑⚡ 毫秒级启动 —— 观看上方快速启动流程演示。Cube Sandbox 需要一台支持KVM的x86_64 Linux环境。指南带你四步完成全部流程 —— 准备服务器、安装 Cube Sandbox、创建沙箱模板、运行第一段 Agent 代码。无需编译源码几分钟即可上手。选择你的部署方式 PVM · 云服务器部署 → 推荐 裸金属部署 → Dev-Env →⚠️不推荐 — 性能差装完第一件事打开 Web 控制台️ 可视化管理 —— 从概览到创建沙箱、查看日志全程在浏览器完成。一键部署完成后在浏览器访问http://控制节点 IP:12088推荐三步先看概览— 打开Overview确认节点 Ready、资源有余量集群可以正常接单备好模板— 到Template Store一键安装官方预置镜像若Templates里已有READY模板可跳过创建沙箱—Sandboxes → New sandbox选READY模板创建几秒内进入详情页查看实时日志完整说明见 WebUI 控制台指南。深入探索文档首页 — 完整指南导航☁️ PVM 部署 — 在普通云服务器上部署无需裸金属或嵌套虚拟化模板概览 — 镜像到模板的概念与工作流示例项目 — 展示各种使用场景的示例涵盖代码执行、浏览器自动化、OpenClaw 集成与 RL 训练等️ WebUI 控制台 — 装完即用的可视化管理:12088 安全代理与凭证托管 — CubeEgress 域名过滤、注入与审计 数字助手 AgentHub — OpenClaw 助手创建与管理Preview 开发环境QEMU 虚机 — 暂时没有 KVM 访问权限在一次性的 OpenCloudOS 9 虚机里体验 Cube Sandbox架构概览编辑组件职责CubeAPI兼容 E2B 的 REST API 网关Rust替换 URL 即可从 E2B 无缝切换。CubeMaster编排调度器接收 API 请求并分发到对应 Cubelet负责资源调度与集群状态维护。CubeProxy反向代理兼容 E2B 协议将请求路由到对应沙箱。Cubelet计算节点本地调度组件管理单节点所有沙箱实例的完整生命周期。CubeVS基于 eBPF 内核态转发的虚拟交换机提供网络隔离与安全策略支持。CubeEgress基于 OpenResty 的出站安全网关L7 域名过滤、凭证注入、访问审计与 CubeVS 内核策略配合沙箱流量不可绕过。CubeHypervisor CubeShim虚拟化层 —— CubeHypervisor 负责管理 KVM MicroVMCubeShim 实现 containerd Shim v2 接口将沙箱集成到容器运行时。详见架构概览和 CubeVS 网络模型。社区与贡献我们欢迎各种形式的贡献——Bug 报告、功能建议、文档改进、代码提交。发现 Bug—— 在这里报告问题或提出建议有新想法—— 提问交流与想法分享想写代码—— 查看我们的 CONTRIBUTING.md 贡献指南了解如何提交 Pull Request。想贡献文档 / PR—— 欢迎按双语方式投稿到这 3 个社区文档入口故障排障、应用案例、生态集成。想成为最终用户—— 点击这里填写用户调研。想聊聊天—— 扫描二维码加入我们的微信交流群。编辑 扫描上方二维码加入微信交流群与核心开发者和社区伙伴零距离沟通Roadmap即将上线— 详见完整路线图。特性说明Kubernetes 原生部署使用 CRD、Operator 和原生调度在 K8s 集群内完整部署运营 CubeSandbox无需额外编排组件Volume 支持兼容 E2B Volume 协议的持久化与共享存储能力跨机暂停与恢复在一台宿主机上暂停沙箱在另一台上完整恢复内存和文件系统状态E2B API 对齐补齐补齐与 E2B 规范的剩余差距实现完整的兼容替代控制面与数据面分离解耦控制面与数据面控制面升级或故障不影响已在运行的沙箱保证全路径高可用沙箱异常恢复自动检测并恢复 VM Crash、shim 卡死、网络分区等异常支持可配置恢复策略调度与运维能力增强资源感知调度、亲和规则、在线均衡与带迁移的节点排空许可证Cube Sandbox 使用 Apache License 2.0 开源许可证。
