sandbox-stable · 为应用接入隔离代码执行环境

作者提供的示例，实际效果取决于你的输入和使用工具。

输入

编辑构造材料（未运行）：
Worker 已有 env.Sandbox 绑定；使用独立 edit-demo 实例；仅执行固定 Python 算术表达式 6*7，要求检查 exitCode 和 stdout。

输出

编辑示例 · 未运行

import { getSandbox } from "@cloudflare/sandbox";

const sandbox = getSandbox(env.Sandbox, "edit-demo");
const result = await sandbox.exec(
  'python3 -c "print(6 * 7)"'
);
if (result.exitCode !== 0) {
  throw new Error("诊断命令失败");
}
console.log(result.stdout.trim());

若依赖就绪且命令成功，算术结果应为 42；这里没有实际执行记录。

基于稳定版 @cloudflare/sandbox 开发或维护沙箱应用。

具体任务

在稳定版沙箱中执行固定诊断命令：基于稳定版 @cloudflare/sandbox 开发或维护沙箱应用。

必需材料

当前 @cloudflare/sandbox 版本与容器镜像配置

待执行命令、文件范围和输出要求

可选材料

会话状态需求

允许的网络和资源限制

使用门槛

熟悉 Workers 绑定及命令执行风险，能核对稳定包与容器镜像版本。

这个 Skill 额外提供的方法

先确认 stable 包与镜像同一版本线，再区分等待完成的 exec 与长任务/流式 API，避免混入 @next 单句柄模型。

编辑示例（未运行）

在稳定版沙箱中执行固定诊断命令

任务：在稳定版沙箱中执行固定诊断命令

输入：
编辑构造材料（未运行）：
Worker 已有 env.Sandbox 绑定；使用独立 edit-demo 实例；仅执行固定 Python 算术表达式 6*7，要求检查 exitCode 和 stdout。

结果片段：
```typescript
import { getSandbox } from "@cloudflare/sandbox";

const sandbox = getSandbox(env.Sandbox, "edit-demo");
const result = await sandbox.exec(
  'python3 -c "print(6 * 7)"'
);
if (result.exitCode !== 0) {
  throw new Error("诊断命令失败");
}
console.log(result.stdout.trim());
```
若依赖就绪且命令成功，算术结果应为 42；这里没有实际执行记录。

这是依据固定入口方法撰写的编辑示例，没有运行上游 Skill 或访问真实账号。先确认 stable 包与镜像同一版本线，再区分等待完成的 exec 与长任务/流式 API，避免混入 @next 单句柄模型。

首次任务

请使用已安装的 sandbox-stable Skill。
任务：在稳定版沙箱中执行固定诊断命令。

我的必需材料：
- 当前 @cloudflare/sandbox 版本与容器镜像配置：[粘贴我的实际材料或路径；缺少时写明]
- 待执行命令、文件范围和输出要求：[粘贴我的实际材料或路径；缺少时写明]

可选补充：
- 会话状态需求：[可选，未提供时不要假定存在]
- 允许的网络和资源限制：[可选，未提供时不要假定存在]

请先确认材料是否足够，只处理我提供的范围。sandbox.exec 具有真实命令执行能力；不得拼接未信任输入，不传入生产秘密，也不能把隔离环境当作无风险保证。交付可直接审阅的代码或查询片段，明确尚未执行或验证的部分。不要代入页面例子的虚构数据。
验收：
1. 包和容器镜像属于同一 stable 版本线。
2. 真实 exitCode 与 stdout/stderr 被检查。
3. 命令固定或严格验证，秘密、网络与资源限制符合授权范围。

验收方法

包和容器镜像属于同一 stable 版本线。

真实 exitCode 与 stdout/stderr 被检查。

命令固定或严格验证，秘密、网络与资源限制符合授权范围。

依赖与准备

需要完整 Skill 目录及随附资源。需要 @cloudflare/sandbox stable、匹配容器镜像、Workers Sandbox 绑定及运行权限；长任务按稳定 Commands API，迁移 @next 用专门兄弟技能。

使用边界

sandbox.exec 具有真实命令执行能力；不得拼接未信任输入，不传入生产秘密，也不能把隔离环境当作无风险保证。

需要 Cloudflare Sandbox 稳定版运行条件；与 next 预览版 API 不可混用。

页面中的例子为编辑撰写，未运行上游 Skill；不代表平台兼容认证或生产实测。

排错

调用示例类型不匹配：先检查已安装 stable 类型与容器版本，不通过 any 绕过。

跨命令目录或环境丢失：按 Sessions 参考建立需要的会话，不能假定每次调用共享 shell 状态。

固定来源

https://github.com/cloudflare/skills/blob/626547c06881a20b3322bdc2ed6e6451b33a4fb6/skills/sandbox-stable/SKILL.md

许可

Apache-2.0。许可原文：https://github.com/cloudflare/skills/blob/626547c06881a20b3322bdc2ed6e6451b33a4fb6/LICENSE

仓库热度

cloudflare/skills 仓库 2,944 Stars（2026-09-30 核验）；这是父仓库指标，不是单个 Skill 的评分。

先看看示例

输入

输出

方法说明