启动 sandbox 并运行不受信任或生成的代码
sandbox 是用于运行代码的隔离环境。其中的代码无法直接读取你的应用内存或数据。你的 Worker 决定代码能获得哪些应用 API 与数据,以及代码是否可以访问公共互联网。
你可以将 sandbox 用于 Agent 编写的代码、用户上传的应用、数据分析、开发预览、构建流水线,以及任何不应与你的应用共享进程的工作。
Cloudflare 提供两种 sandbox 环境。两者都通过 Worker 访问,也就是已经处理你流量的那个应用。
如果你的应用使用 @cloudflare/sandbox 0.x,请参阅 Sandbox SDK 0.x,或使用 从 Sandbox SDK 0.x 迁移 升级到当前版本。
Containers 运行你提供的镜像。实例是完整的 Linux 环境,因此你可以运行任何语言,并让进程持续运行。你的 Worker 启动实例并向其发送工作。来自互联网的 HTTP 只能通过你的 Worker 到达该实例。
每个实例都是带有独立内核和网络的 microVM,因此不会与其他工作负载共享。
sandbox 所用的 container 使用 Durable Object 调度策略,该策略目前处于公开 Beta。
Worker 中的 Durable Object 会从镜像启动实例,并在其中运行命令:
container.start({
image: "cloudflare/debian-trixie",
entrypoint: ["sleep", "infinity"],
enableInternet: false,
});
const process = await container.exec(["uname", "-a"]);
const output = await process.output();运行 Linux 命令
构建编程 Agent runner
Dynamic Workers 在运行时创建新的 Worker。不受信任的代码可以是 JavaScript、Python 或 WebAssembly。加载 TypeScript 前请先编译为 JavaScript。
Workers 运行时会将每个 Dynamic Worker 与你的 Worker 以及其他 Dynamic Worker 隔离开。Dynamic Worker 只能通过你传入的方法和数据访问你的应用。
你的 Worker 将不受信任的模块作为新的 Worker 加载,阻止其出站请求,然后调用它:
const sandbox = env.LOADER.load({
compatibilityDate: "$today",
mainModule: "code.js",
modules: { "code.js": untrustedModule },
globalOutbound: null,
});
const entrypoint = sandbox.getEntrypoint<CodeEntrypoint>("Code");
const result = await entrypoint.evaluate();运行 JavaScript
构建 AI 代码解释器
选择 sandbox 环境
判断任务是否需要 Linux,还是只需调用 Worker 提供的方法。
Sandbox 生命周期
了解是什么让 Linux sandbox 保持运行、是什么会停止它,以及 snapshot 会带回哪些文件。
Sandbox 安全
决定每个 sandbox 中放置的内容,因为其中的代码可以使用你放入的一切。
运行命令
运行 Python 代码与测试、流式输出、保持进程运行,以及打开终端。
处理文件
移动文件、在实例之间保留工作区,以及挂载 R2 bucket。
预览应用
在浏览器中打开 sandbox 内运行的 Web server。
凭据与网络
将凭据保留在 Worker 中,并决定 sandbox 可以访问哪些服务。
管理 sandbox
列出用户的 sandbox,并记录每个 sandbox 何时以及为何停止。
编程 Agent
在属于单个任务的 sandbox 中运行 Claude Code、Codex、Devin 等编程 Agent。
这些 sandbox 环境所运行的无服务器平台。
为附加 container 提供身份与协调。
在 Cloudflare 上运行模型,然后在 sandbox 中执行它们生成的代码。