# Sandbox SDK

Build secure, isolated code execution environments

> Links below point directly to Markdown versions of each page. Any page can also be retrieved as Markdown by sending an `Accept: text/markdown` header to the page's URL without the `index.md` suffix (for example, `curl -H "Accept: text/markdown" https://cloudflaredoc.ubitools.com/sandbox/`).
>
> For other Cloudflare products, see the [Cloudflare documentation directory](https://cloudflaredoc.ubitools.com/llms.txt).

## Overview

- [Sandbox SDK](https://cloudflaredoc.ubitools.com/sandbox/index.md): 构建由 Cloudflare Workers 与 Containers 驱动的安全、隔离代码执行环境。

## 快速入门

- [快速入门](https://cloudflaredoc.ubitools.com/sandbox/get-started/index.md): 创建你的第一个 Sandbox SDK Worker，在隔离 container 中执行 Python 代码。

## 教程

- [教程](https://cloudflaredoc.ubitools.com/sandbox/tutorials/index.md): 分步 Sandbox SDK 教程，用于构建 AI Agent、代码执行器与测试流水线。
- [构建 AI 代码执行器](https://cloudflaredoc.ubitools.com/sandbox/tutorials/ai-code-executor/index.md): 使用 Claude 根据自然语言生成 Python 代码，并在沙箱中安全执行。
- [使用 AI 分析数据](https://cloudflaredoc.ubitools.com/sandbox/tutorials/analyze-data-with-ai/index.md): 上传 CSV 文件，使用 Claude 生成分析代码，并返回可视化结果。
- [自动化测试流水线](https://cloudflaredoc.ubitools.com/sandbox/tutorials/automated-testing-pipeline/index.md): 构建测试流水线：克隆 Git 仓库、安装依赖、运行测试并报告结果。
- [在 Sandbox 上运行 Claude Code](https://cloudflaredoc.ubitools.com/sandbox/tutorials/claude-code/index.md): 使用 Claude Code 在你的 GitHub 仓库中实现任务。
- [设置 Claude Managed Agents](https://cloudflaredoc.ubitools.com/sandbox/tutorials/claude-managed-agents/index.md): 在自管理的 Cloudflare 环境中运行 Claude Managed Agents。
- [构建代码审查 bot](https://cloudflaredoc.ubitools.com/sandbox/tutorials/code-review-bot/index.md): 克隆仓库、使用 Claude 分析代码，并向 GitHub PR 发布审查评论。
- [在 Cloudflare 上运行 Devin Outposts](https://cloudflaredoc.ubitools.com/sandbox/tutorials/devin-outposts/index.md): 部署 Devin Outpost，使每个 Devin 会话在隔离的 Cloudflare 容器中运行。
- [使用 OpenAI Agents SDK 构建 AI 编程 Agent](https://cloudflaredoc.ubitools.com/sandbox/tutorials/openai-agents/index.md): 将 OpenAI Agents SDK 与 Cloudflare Sandbox 结合，构建可在隔离环境中编写、测试并交付代码的 Python agent。
- [使用 R2 实现数据持久化](https://cloudflaredoc.ubitools.com/sandbox/tutorials/persistent-storage/index.md): 将 R2 存储桶挂载为本地文件系统路径，以便在沙箱生命周期之间持久保存数据。
- [使用 Workers AI 的代码解释器](https://cloudflaredoc.ubitools.com/sandbox/tutorials/workers-ai-code-interpreter/index.md): 使用 Workers AI GPT-OSS 模型和官方 workers-ai-provider 软件包构建代码解释器。

## API 参考

- [API 参考](https://cloudflaredoc.ubitools.com/sandbox/api/index.md): Sandbox SDK API，用于执行代码、管理文件、运行进程与暴露服务。
- [备份](https://cloudflaredoc.ubitools.com/sandbox/api/backups/index.md): 创建沙箱目录的时间点快照，并使用写时复制叠加层恢复它们。
- [命令](https://cloudflaredoc.ubitools.com/sandbox/api/commands/index.md): 在 Sandbox SDK container 中执行命令并管理后台进程。
- [文件监视](https://cloudflaredoc.ubitools.com/sandbox/api/file-watching/index.md): 使用 Sandbox SDK 的 watch API 实时监视沙箱文件系统变更。
- [文件](https://cloudflaredoc.ubitools.com/sandbox/api/files/index.md): 在 Sandbox SDK 文件系统中读取、写入与管理文件。
- [代码解释器](https://cloudflaredoc.ubitools.com/sandbox/api/interpreter/index.md): 在 Sandbox SDK 中执行 Python、JavaScript 和 TypeScript 代码，并获得丰富的输出格式。
- [生命周期](https://cloudflaredoc.ubitools.com/sandbox/api/lifecycle/index.md): 创建、配置并管理 Sandbox SDK 容器实例及其资源。
- [端口](https://cloudflaredoc.ubitools.com/sandbox/api/ports/index.md): 使用 Sandbox SDK ports API 通过公共预览 URL 暴露 sandbox 服务。
- [Session](https://cloudflaredoc.ubitools.com/sandbox/api/sessions/index.md): 在 sandbox 内创建具有独立工作目录与环境变量的 shell 会话。
- [存储](https://cloudflaredoc.ubitools.com/sandbox/api/storage/index.md): 将 S3 兼容存储桶挂载到 Sandbox SDK 文件系统，以实现持久数据访问。
- [终端](https://cloudflaredoc.ubitools.com/sandbox/api/terminal/index.md): 通过 WebSocket 将基于浏览器的终端 UI 连接到沙箱 shell。
- [Tunnel (隧道)](https://cloudflaredoc.ubitools.com/sandbox/api/tunnels/index.md): 使用快捷隧道 (*.trycloudflare.com) 或绑定到 Cloudflare Zone 上主机名的命名隧道，在公共互联网上公开 Sandbox 服务。

## 操作指南

- [操作指南](https://cloudflaredoc.ubitools.com/sandbox/guides/index.md): 使用 Sandbox SDK 解决特定任务的实用指南。
- [2026 弃用迁移指南](https://cloudflaredoc.ubitools.com/sandbox/guides/2026-deprecation/index.md): 从 2026 年 6 月弃用的 Sandbox SDK 功能迁移出去。
- [运行后台进程](https://cloudflaredoc.ubitools.com/sandbox/guides/background-processes/index.md): 启动并管理长时间运行的服务与应用。
- [备份与恢复](https://cloudflaredoc.ubitools.com/sandbox/guides/backup-restore/index.md): 创建时间点备份并恢复沙箱目录。
- [浏览器终端](https://cloudflaredoc.ubitools.com/sandbox/guides/browser-terminals/index.md): 使用 xterm.js 或原始 WebSocket 将基于浏览器的终端连接到沙箱 shell。
- [使用代码解释器](https://cloudflaredoc.ubitools.com/sandbox/guides/code-execution/index.md): 执行带有丰富输出的 Python 和 JavaScript 代码。
- [运行 Docker-in-Docker](https://cloudflaredoc.ubitools.com/sandbox/guides/docker-in-docker/index.md): 在沙箱 container 内运行 Docker 命令。
- [执行命令](https://cloudflaredoc.ubitools.com/sandbox/guides/execute-commands/index.md): 运行带有流式输出、错误处理与 shell 访问的命令。
- [暴露服务](https://cloudflaredoc.ubitools.com/sandbox/guides/expose-services/index.md): 创建预览 URL 并暴露 Web 服务端口。
- [监视文件系统变更](https://cloudflaredoc.ubitools.com/sandbox/guides/file-watching/index.md): 实时监视文件和目录，以构建响应式开发工具和自动化工作流。
- [使用 Git](https://cloudflaredoc.ubitools.com/sandbox/guides/git-workflows/index.md): 克隆仓库、管理分支，并自动化 Git 操作。
- [管理文件](https://cloudflaredoc.ubitools.com/sandbox/guides/manage-files/index.md): 在沙箱中读取、写入、组织和同步文件。
- [挂载存储桶](https://cloudflaredoc.ubitools.com/sandbox/guides/mount-buckets/index.md): 将兼容 S3 的对象存储挂载为本地文件系统，实现持久数据存储。
- [处理出站流量](https://cloudflaredoc.ubitools.com/sandbox/guides/outbound-traffic/index.md): 使用 Workers 拦截并处理来自沙箱的出站 HTTP。
- [部署到生产环境](https://cloudflaredoc.ubitools.com/sandbox/guides/production-deployment/index.md): 在生产环境中为预览 URL 设置自定义域名。
- [将请求代理到外部 API](https://cloudflaredoc.ubitools.com/sandbox/guides/proxy-requests/index.md): 通过 Worker 代理路由沙箱请求，并在请求时注入身份验证，从而安全地保管凭据。
- [流式输出](https://cloudflaredoc.ubitools.com/sandbox/guides/streaming-output/index.md): 处理来自命令和进程的实时输出。
- [WebSocket 连接](https://cloudflaredoc.ubitools.com/sandbox/guides/websocket-connections/index.md): 连接到沙箱中运行的 WebSocket 服务器。
- [连接 Workers 绑定（binding）](https://cloudflaredoc.ubitools.com/sandbox/guides/workers-connections/index.md): 从 sandbox 访问 KV、R2、Durable Objects 及其他绑定（binding）。

## 概念

- [概念](https://cloudflaredoc.ubitools.com/sandbox/concepts/index.md): 了解 Sandbox SDK 的工作原理，包括架构、生命周期、安全与 session。
- [架构](https://cloudflaredoc.ubitools.com/sandbox/concepts/architecture/index.md): Sandbox SDK 结合 Workers、Durable Objects 与 Containers，实现安全的代码执行。
- [Container 运行时](https://cloudflaredoc.ubitools.com/sandbox/concepts/containers/index.md): Sandbox SDK 容器运行装有 Python、Node.js 和常用开发工具的隔离 Linux 环境。
- [预览 URL](https://cloudflaredoc.ubitools.com/sandbox/concepts/preview-urls/index.md): Sandbox SDK 预览 URL 为运行在 sandbox 内部的服务提供公共 HTTPS 访问。
- [Sandbox 生命周期](https://cloudflaredoc.ubitools.com/sandbox/concepts/sandboxes/index.md): Sandbox SDK 沙箱会根据活动在运行、休眠和已销毁状态之间转换。
- [安全模型](https://cloudflaredoc.ubitools.com/sandbox/concepts/security/index.md): Sandbox SDK 使用 VM 级隔离、输入验证和网络控制来安全运行不受信任的代码。
- [Session 管理](https://cloudflaredoc.ubitools.com/sandbox/concepts/sessions/index.md): Sandbox SDK 的会话是单个沙箱内的 shell 执行上下文。
- [终端连接](https://cloudflaredoc.ubitools.com/sandbox/concepts/terminal/index.md): Sandbox SDK 终端连接在浏览器 UI 与 container shell 之间双向流式传输数据。

## 配置

- [配置](https://cloudflaredoc.ubitools.com/sandbox/configuration/index.md): 使用 Wrangler、Dockerfile、环境变量与传输模式配置 Sandbox SDK 部署。
- [Dockerfile 参考](https://cloudflaredoc.ubitools.com/sandbox/configuration/dockerfile/index.md): 使用软件包、工具和配置自定义 Sandbox SDK container 镜像。
- [环境变量](https://cloudflaredoc.ubitools.com/sandbox/configuration/environment-variables/index.md): 使用环境变量向 Sandbox SDK 容器传递配置、密钥与运行时设置。
- [Sandbox 选项](https://cloudflaredoc.ubitools.com/sandbox/configuration/sandbox-options/index.md): 使用休眠超时、资源限制与容器设置配置 Sandbox SDK 行为。
- [传输模式](https://cloudflaredoc.ubitools.com/sandbox/configuration/transport/index.md): 配置 Sandbox SDK 在 Durable Objects 与容器之间的通信方式。
- [Wrangler 配置](https://cloudflaredoc.ubitools.com/sandbox/configuration/wrangler/index.md): 为 Sandbox SDK 设置 Wrangler 绑定（binding）、Durable Objects 与容器设置。

## Sandbox Bridge

- [Sandbox Bridge](https://cloudflaredoc.ubitools.com/sandbox/bridge/index.md): 部署 Sandbox Bridge Worker 以从任何语言或平台通过 HTTP 控制 Cloudflare Sandboxes。
- [HTTP API 参考](https://cloudflaredoc.ubitools.com/sandbox/bridge/http-api/index.md): sandbox bridge Worker 的完整 HTTP API 参考。

## 平台

- [平台](https://cloudflaredoc.ubitools.com/sandbox/platform/index.md): Sandbox SDK 平台信息，包括定价与资源限制。
- [限制](https://cloudflaredoc.ubitools.com/sandbox/platform/limits/index.md): Sandbox SDK 的资源限制，包括 vCPU、内存、磁盘与 container 约束。
- [定价](https://cloudflaredoc.ubitools.com/sandbox/platform/pricing/index.md): Sandbox SDK 定价基于底层 Containers 平台的使用费率。