sandbox 运行你不信任的代码,例如模型生成的代码、用户编写的代码,或依赖引入的代码。Cloudflare 会将 sandbox 与你的 Worker 以及其他 sandbox 隔离。关于该隔离的更多信息,请参阅 Cloudflare 上的 Sandbox。
隔离不会限制代码在其自身 sandbox 内的行为。请假定代码会使用它在那里能访问的一切,包括你的 Worker 提供的文件、凭据和网络访问。
Container 中的每个进程都运行在同一个 Linux 系统上。这些进程可以读取相同的文件、看到彼此,并连接到相同的 localhost 端口。加载到同一个 Dynamic Worker 中的代码会以同样的方式共享内存。
单独的 Linux 用户无法让命令远离文件。在已部署的 sandbox 中,每个进程都拥有与 root 相同的 Linux capabilities,因此文件权限无法限制它,并且它可以切换回 root。更多信息请参阅 exec() 的 user 选项。
因此,sandbox 是最小的信任单元。当两个用户共享一个 sandbox 时,每个用户的代码都可以读取对方的工作。为每个用户或每个任务使用独立 sandbox,可以让一个用户的代码远离另一个用户的文件和凭据。
例如,编程 Agent 会克隆私有仓库、安装依赖并运行测试。如果你的 Worker 把 token 放进克隆 URL,Git 会将该 URL 保存在仓库的 .git/config 文件中。测试以及它们加载的每个依赖,都拥有与 Agent 相同的访问权限。其中任何代码都可以读取该 token。
# Agent
$ git pull
Already up to date.
# 来自测试依赖项的代码
$ cat .git/config
[remote "origin"]
url = https://ghp_example@github.com/acme/app.git
在编程 Agent 的 sandbox 内,Agent 运行 git pull,来自测试依赖的代码读取 .git/config。token 在克隆 URL 中时,该依赖会从该文件读取 token。token 在你的 Worker 中时,文件中没有 token,你的 Worker 会将 token 添加到发往 github.com 的请求,git pull 仍然可以工作。
环境变量、命令参数以及 Worker 写入的文件也是同样的原理。一旦某个值进入 sandbox,那里的所有代码都可以读取它,并把它发送到 sandbox 能到达的任何地方。
将凭据放在 sandbox 之外更安全。Container 可以在不带凭据的情况下发出请求,由 Worker 中的出站 handler 在请求离开 sandbox 后添加凭据。仅向 HTTPS 请求添加凭据。handler 会使用 container 所用的 scheme 发起 fetch,因此添加到明文 HTTP 请求的凭据会在互联网上以未加密方式传输。
Dynamic Worker 可以接收一个方法:该方法在你的 Worker 中使用凭据,并只返回结果。方法和出站 handler 各自决定发起哪些请求,从而限制代码能对该服务做什么。这两种模式请参阅 从 sandbox 调用经过认证的 API。
Container 在运行期间会保留其文件。snapshot 会保存这些文件,包括 .git/config 中的 token,恢复 snapshot 会将它们带回来。只要你的 Worker 使用相同名称调用 getByName(),就会到达同一个 sandbox。
名称决定请求会到达哪个 sandbox 以及哪些已保存文件。它不会表明是谁发送了请求。请在 Worker 中认证调用方,并根据该身份派生 sandbox 名称。将名称或 snapshot 复用给其他人,会把先前用户的文件交给对方。操作指南从 URL 读取名称,只是为了让示例保持简短。
关于 sandbox 在实例之间会保留什么,请参阅 Sandbox 生命周期。
Container 默认以 enableInternet: false 启动,因此无法访问互联网。只有 Worker 中出站 handler 拦截的请求才会离开它。除非你在加载 Dynamic Worker 时设置 globalOutbound: null(这会使 fetch() 和 connect() 抛出错误),否则 Dynamic Worker 拥有与你的 Worker 相同的网络访问。
你允许的每个目标,都给代码提供了一条把可读内容发送出去的路径。如果为了让 npm install 下载软件包而打开互联网访问,某个依赖也可以把 token 发送到任意 server。Worker 中的出站 handler 可以允许软件包仓库并阻止所有其他目标。
使用出站处理程序时,请关闭 Internet 访问。处理程序只会接收其拦截范围内的连接。开启 Internet 访问后,其他所有连接都会直接出站。如需通过 Worker 路由请求,请参阅 Containers 的 interceptOutboundHttps() 和 Dynamic Workers 的出口控制。
来自 sandbox 的结果、文件和 HTTP 响应都来自你不信任的代码。在应用存储它们、基于它们采取行动,或把它们展示给其他人之前,需要像对待用户输入一样进行检查。
Web 预览的风险更高,因为它会在访问者的浏览器中运行。当 Worker 转发沙盒中的页面时,该页面会在提供它的主机名下运行。如果使用应用主机名,页面就可以使用应用 Cookie 并调用其 API。请在应用未使用的独立域名上提供预览,避免应用 Cookie 发送给该页面。示例请参阅在独立主机名上提供预览。