Sandbox SDK 提供了全面的 API,用于在隔离的 sandbox 中执行代码、管理文件、运行进程以及公开服务。
生命周期
创建和管理 sandbox container。获取 sandbox 实例,配置选项,并清理资源。
命令
执行命令并流式传输输出。运行脚本、管理后台进程并捕获执行结果。
文件
读取、写入和管理 sandbox 文件系统中的文件。包括目录操作和文件元数据。
文件监视
使用原生 inotify 实时监控文件系统更改。构建开发工具、热重载系统和响应式文件处理。
代码解释器
执行 Python 和 JavaScript 代码,并提供包括图表、表格和格式化数据在内的丰富输出。
端口
通过预览 URL 公开在 sandbox 中运行的服务。从互联网访问 Web 服务器和 API。
隧道
通过 sandbox.tunnels.get(port) 在免配置的 *.trycloudflare.com URL 上公开服务。最适合快速开发和 .workers.dev 部署。
存储
挂载与 S3 兼容的存储桶(R2、S3、GCS)作为本地文件系统,以便在 sandbox 生命周期内进行持久数据存储。
备份
创建目录的特定时间点快照,并使用写时复制 (copy-on-write) 覆盖层进行恢复。将备份存储在 R2 中。
会话 (Sessions)
在 sandbox 内创建隔离的执行上下文。每个会话均维护其自己的 shell 状态、环境变量和工作目录。
终端
通过 WebSocket 将基于浏览器的终端 UI 连接到 sandbox shell,并配备适用于自动重新连接和大小调整处理的 xterm.js SandboxAddon。