CubeSandbox 学习中心

这是一套从零理解 CubeSandbox 的教程网站入口。它不是替代已有参考文档，而是把分散在 README、指南、架构、示例和线上资料里的知识串成一条可学习、可实践、可回头查的路线。

本教程以当前仓库内容为主，同时参考官方线上资料、GitHub 仓库、CNB Release 页面和上游 E2B SDK 语义。若线上发布版本与当前 checkout 存在差异，学习源码和本地部署时以当前仓库为准，生产部署时再对照最新 Release。

适合谁

角色	推荐目标
第一次接触 CubeSandbox 的开发者	理解它为什么不是普通 Docker 沙箱，并跑通第一个沙箱。
AI Agent / Code Interpreter 开发者	学会用 E2B 兼容 SDK、模板、快照和网络策略构建安全执行环境。
平台工程师 / SRE	掌握部署方式、组件职责、日志、WebUI、网络加固和排障入口。
想读源码或贡献的人	快速找到 CubeAPI、CubeMaster、Cubelet、CubeShim、CubeVS 等模块的学习顺序。

学习路线

建议按顺序阅读；如果你已经部署过，可以直接跳到 SDK、模板或网络章节。

顺序	页面	你会学到什么
1	基础概念	AI Agent 沙箱、MicroVM、KVM/PVM、E2B 兼容、模板、快照、出网控制。
2	系统架构	CubeAPI、CubeMaster、Cubelet、CubeShim、CubeHypervisor、CubeVS、CubeEgress 的协作关系。
3	环境与部署	如何选择 PVM、裸金属、多机集群或开发环境，以及安装后的检查项。
4	第一个沙箱	创建模板、配置 SDK、执行代码、通过 WebUI 观察运行状态。
5	模板体系	OCI 镜像如何变成毫秒级启动的模板，端口、探针、CA 和模板商店怎么用。
6	生命周期与状态管理	create、pause、resume、kill、auto-pause、snapshot、clone、rollback。
7	网络与安全	CubeVS eBPF 策略、CubeEgress L7 代理、凭证注入、审计和网络加固。
8	运维与排障	WebUI、日志路径、服务管理、版本矩阵、常见故障定位路径。
9	场景与集成	代码解释器、浏览器沙箱、OpenAI Agents、OpenClaw、SWE-bench、host mount 等示例。
10	源码导读	仓库结构、主要语言、请求链路源码入口和贡献前的检查清单。

完整文档地图

学习路线之外，独立站也包含原中文文档的主要栏目：

栏目	入口	内容
指南	指南总览	快速开始、部署、模板、生命周期、网络、安全代理、WebUI、排障与场景教程。
架构	架构概览	控制面、数据面、CubeVS 网络模型、CubeEgress 与关键组件协作。
开发者	开发者文档	Redis Key 命名规范和贡献者参考。
博客	博客列表	Release 解读、性能基准、网络深潜、快照/克隆/回滚深潜等文章。
更新日志	版本索引	v0.1.0 到 v0.4.0 的版本变更记录。

一张总图

可以先把 CubeSandbox 看成三层：

1. 接口层：给用户和 SDK 提供 E2B 兼容 API，也给 WebUI 提供管理接口。
2. 调度层：决定沙箱在哪台机器运行，维护模板、快照、生命周期和路由元数据。
3. 节点层：真正启动 MicroVM、挂载文件系统、连接网络、执行安全策略。

学习前准备

• 一台可用于实验的 Linux 主机。快速体验推荐参考 快速开始 或 PVM 部署。
• 基础 Linux 经验：systemd、Docker/Compose、网络端口、磁盘挂载。
• 基础 Python 经验：大多数 SDK 示例使用 Python，且兼容 E2B 的调用方式。
• 对容器或虚拟化有基本概念会更顺手，但不是必须。

资料来源

本教程主要整理自：

• 当前仓库的 README_zh.md、中文指南、架构文档 与 examples/。
• 官方 GitHub 仓库：TencentCloud/CubeSandbox。
• 官方 Release 页面：CubeSandbox Releases。
• E2B 上游生命周期语义：Sandbox auto-resume。
• CNCF Landscape 收录页：CubeSandbox in CNCF Landscape。

下一步

从 基础概念 开始，先建立术语和心智模型，再进入架构与部署。