Cubesandbox

调研时间: 2026/07/08 调研范围: /home/zs/Develop/TraceCubeSandbox/sdk/ 全量 Python + Go 源码 目的: 系统性梳理 CubeSandbox 的客户端 SDK 的架构与使用方法 1. 概述 CubeSandbox 提供 Python 和 Go 两个官方 SDK，封装了与 CubeAPI 的所有交互，包括沙箱创建、代码执行、文件操作、快照管理、模板管理等。 属性 Python SDK Go SDK 包名 cubesandbox v0.3.0 github.com/tencentcloud/CubeSandbox/sdk/go 语言版本 Python >= 3.9 Go 1.22 HTTP 客户端 httpx >= 0.27 + requests net/http (标准库) API 兼容 E2B 兼容 E2B 兼容 关键依赖 httpx, requests 标准库 (零外部依赖) 配置 环境变量 (CUBE_*) 环境变量 (CUBE_/E2B_) 许可协议 Apache-2.0 Apache-2.0 核心职责:...

调研时间: 2026/07/08 调研范围: /home/zs/Develop/TraceCubeSandbox/web/ 全量 React/TypeScript 源码 目的: 系统性梳理 WebUI (管理控制台) 的架构、处理流程与安全配置 每节都带文件位置证据，可以直接引用。 1. 概述 WebUI 是 CubeSandbox 的浏览器端管理控制台，基于 React 18 + TypeScript 构建，提供沙箱、模板、节点、API 密钥和集群可观测性的可视化界面。 属性 值 语言 TypeScript (React 18) 构建工具 Vite 6 路由 react-router-dom v6 数据获取 TanStack Query v5 样式 Tailwind CSS v3 + HSL 变量 UI 组件 Radix UI (shadcn 风格) 状态管理 Zustand v5 国际化 i18next API 客户端 openapi-typescript (生成类型) Mock 工具 MSW (Mock Service Worker) 开发端口 5173 代理 Vite proxy /cubeapi → 127....

调研时间: 2026/07/03

一句话定位: 公网用户通过 *.cube.app 通配域名进入 CubeProxy,再反向代理到 sandbox 暴露端口 的入站面。

一句话定位: Guest 内 sandbox 通过 host 网络栈出到互联网 (LLM API / 第三方服务 / 模型下载) 的强制审计面。

一句话定位: 整个 CubeSandbox 安全模型的基石 —— 宿主进程与 Guest OS kernel 之间的硬件级隔离面。

一句话定位: 运维人员将可信根 (配置、镜像、模板、二进制) 注入 host 信任域的入口。

一句话定位: 公网用户 / LLM API / 第三方服务进入 CubeSandbox 的唯一访问入口。

CubeSandbox 依赖许多 Rust crate、Linux 内核、seccomp filter、cloud-hypervisor,这些依赖项自身会有 CVE。项目通过:

CubeSandbox 把日志分成: