概览

UCloud Sandbox 为您提供安全可靠的弹性沙箱计算服务。只需几秒钟，您就可以在云端获取和启用具备完整操作系统能力的沙箱，用于执行 AI Agent 生成的代码、进行自动化测试或运行不可信的脚本。

随着业务需求的变化，您可以实时扩展或缩减计算资源。UCloud Sandbox 支持按实际使用的资源计费，可以为您节约计算成本。

快速开始 | 核心概念 | CLI 指南 | 常见问题

---

推荐学习路径

按「先跑起来 → 理解概念 → 深入能力」的顺序开始：

第一步：快速上手

1. 前置条件与认证 - 获取 API Key 并配置环境
2. SDK 快速开始 - 5 分钟创建第一个沙箱
3. CLI 指南 - 命令行工具入门
4. 切换地域 - 学习如何切换地域

第二步：理解核心概念

1. 概念速览 - 沙箱、模板、快照的关系
2. 产品架构 - 系统组件与数据流
3. 模板工作原理 - 快照机制详解

第三步：深入使用

1. 模板快速开始 - 构建自定义模板
2. 命令执行 - 在沙箱中运行命令
3. 文件系统 - 文件读写与传输

---

核心能力

能力	说明	相关文档
代码执行	安全运行 Agent 生成的 Python、JavaScript 等代码	命令执行
多地域切换	支持在不同地域创建沙箱	切换地域
文件操作	在沙箱与宿主机之间传输文件	文件系统
自定义模板	预装依赖、预置文件、毫秒级启动	模板指南
网络控制	灵活控制沙箱的互联网访问权限	网络访问
数据持久化	挂载远程存储桶	持久化
E2B 兼容	使用现有 E2B SDK 无缝接入	E2B 兼容模式

---

典型应用场景

• AI Agent 代码执行：安全运行 LLM 生成的代码，隔离风险
• 自动化测试：在隔离环境中运行测试用例
• 数据分析：提供预装分析工具的沙箱环境
• 教育培训：为学员提供独立的实验环境

?> 更多示例请参阅 示例库

---

常见问题

遇到问题？请查阅 常见问题与排障，涵盖：

• 认证与权限问题
• 模板构建卡住
• 命令执行超时
• 网络访问失败
• 限流与资源限制

---

快速链接

类别	链接
入门	前置条件 · SDK 快速开始 · CLI 指南
概念	概念速览 · 产品架构
参考	词汇表 · 常见问题