CubePod — 专为长生命周期自主 Agent 打造的持久微虚拟机沙箱
专为长生命周期自主 Agent 打造的持久微虚拟机沙箱
Persistent Writable RootFS MicroVM Execution Platform · 持久化可写 RootFS 微虚拟机执行平台
基于 Kata Containers 硬件隔离与双 CSI Raw Block 持久化。支持 Zero-Export 0 CPU 休眠、~1s 跨节点唤醒与 1s CoW 克隆，让系统环境与工作区永不丢失。
/dev/cubepod-rootfs RW · 持久 upperdir apt / pip / npm 修改实时落盘
/dev/cubepod-workspace RW · /workspace volumeKey: agent-ws · 1000:1000
预热微虚拟机毫秒级领用
CSI 块卷重挂载与快照分支
0 内存占用 · 无需镜像导出
双卷彻底解耦持久保留
一行配置兼容 E2B，或原生调用超集 SDK
切换标签或点击重放，实时观察 SDK 调用与沙箱内 podd 守护进程的执行遥测流。
export E2B_DOMAIN="127.0.0.1:8080"
export E2B_API_KEY="cpod_live_secret"
from e2b_code_interpreter import Sandbox
with Sandbox.create() as sbx:
sbx.commands.run("pip install pandas matplotlib")
res = sbx.run_code("import pandas as pd; pd.DataFrame({'a':[1,2,3]})")
print(res.results[0].html)from cubepod import AsyncCubePod
async with AsyncCubePod(base_url="http://127.0.0.1:8080") as cp:
box = await cp.create(
"cubeplex-ubuntu24-desktop",
volume_key="agent-ws-042",
secret_bindings=[{
"env_name": "GITHUB_TOKEN",
"placeholder": "cpodref_gh_readonly_01",
"allowed_hosts": ["api.github.com"],
}],
)
forked = await cp.fork(box.sandbox_id)
await cp.reset_rootfs(box.sandbox_id)
await cp.pause(box.sandbox_id)import { Sandbox } from 'cubepod';
const sbx = await Sandbox.create({
baseUrl: 'http://127.0.0.1:8080',
templateId: 'cubeplex-ubuntu24-desktop',
volumeKey: 'agent-ws-042',
});
await sbx.files.archiveSync({ 'app/main.py': 'print("ok")\n' }, { dest: '/workspace' });
const panel = await sbx.createEndpoint(8080, { expiresInSeconds: 3600 });
console.log('GUI Panel:', panel.url);
await sbx.pause();cubepod health
cubepod sandbox create --template cubeplex-ubuntu24-desktop
cubepod sandbox exec <id> "apt-get update && apt-get install -y ripgrep"
cubepod sandbox fork <id>
cubepod sandbox reset-rootfs <id>
cubepod sandbox pause <id>
# Expose sandbox tools via Model Context Protocol
cubepod mcp四层云原生架构栈
将易变 OS 依赖与用户工作区彻底解耦，零宿主机 Kubelet / containerd 侵入。
接入与协议层
Access Layer官方 E2B SDK 无缝迁移、原生 Python / TS / Go SDK 与 MCP Server。
无状态控制与网关面
Control PlaneAuto-Resume 流量拦截唤醒、PodWarmPool 调度与每 Pod mTLS 签发。
Kata 微虚拟机数据面
Hardware Isolation独立 Guest 内核中运行 Rust PID 1 podd-init、podd 与零信任出站代理。
CSI 持久块存储面
Raw Block CoW只读 Base OCI 叠加独立 rootfs-pvc 与 workspace-pvc 双块卷。
专为长周期 AI Agent 打造
点击任意能力卡片，深入对应架构规范文档。
双卷持久化与 OS 重置
递增 rootfsGeneration 即可清洗受损系统环境，同时通过 volumeKey 保留工作区。
Zero-Export 零开销休眠
落盘后销毁 Pod 使算力归零；来流时自动在集群任意节点 ~1s 恢复。
< 1 秒 CoW 沙箱分支
通过 CSI VolumeSnapshot 同步克隆双卷，支持多子 Agent 并行探索。
cpodref_ 零信任出站
真实密钥永不入沙箱；按序 allow/deny 规则与 mTLS 在出站边界动态换取。
懒加载桌面与 Panel 代理
按需拉起 Xorg、Chromium CDP 与 Neko WebRTC，经签名路径暴露零冲突。
6 语言内核与原生 MCP
支持 Python / JS / TS / R / Java / Bash 流式内核及 cubepod mcp 接入。
CubePod vs. 上游 E2B vs. 传统容器
| 对比维度 | CubePod v0.5.0 | 上游 E2B Cloud | 传统容器沙箱 |
|---|---|---|---|
| 系统盘持久化 | RootFS + /workspace 双持久 | 仅临时 RootFS | 重启即丢失 |
| 存储性能模型 | Dual CSI Raw Block (NVMe-oF) | 临时 overlay / 共享 FS | OverlayFS / NFS |
| OS 与数据耦合 | 完全解耦（独立重置 OS） | 状态耦合 | 全局重置丢失 |
| 休眠与唤醒 | 0 CPU/RAM · ~1s 块卷恢复 | 导出内存镜像 / 冷启 | 持续占内存 |
| 沙箱分支克隆 | < 1s CoW 双卷快照 | 不支持 / 全量拷贝 | 不支持 |
| 凭据安全隔离 | cpodref_ + mTLS 边界替换 | 明文环境变量 | 明文 ENV + 共享内核 |
| 部署自由度 | 100% E2B 超集 · 自托管开源 | 专有 SaaS | 需自行拼装 |