在动态 Worker 中运行不受信任或由 AI 生成的代码时,您需要控制它可访问的网络资源。常见要求包括:
- 阻止所有出站访问,使动态 Worker 只能使用您提供的绑定。
- 将出站请求限制到一组特定的允许目标。
- 在不向动态 Worker 暴露机密的情况下,将凭据注入出站请求。
- 记录或审核每个出站请求,以便进行可观测性分析。
由 get() 返回或传递给 load() 的 WorkerCode 对象中的 globalOutbound 选项控制所有这些。它会拦截动态 Worker 发出的每个 fetch() 和 connect() 调用。
将 globalOutbound 设置为 null,使动态 Worker 与网络完全隔离:
return {
mainModule: "index.js",
modules: { "index.js": code },
globalOutbound: null,
};动态 Worker 发出的任何 fetch() 或 connect() 调用都会抛出异常。
在此模式下,您仍可使用绑定授予 Dynamic Worker 对特定资源和服务的直接访问权限。这是设计沙箱最安全的方式:阻止 Internet 访问,然后通过绑定提供特定功能。
如果需要与 Dynamic Worker 沙箱内运行的现有 HTTP 客户端库兼容,阻止 fetch() 可能并不可行。在这种情况下,请改为拦截请求。
要拦截出站请求,请在充当网关的 loader Worker 中定义一个 WorkerEntrypoint 类。动态 Worker 发出的每个 fetch() 和 connect() 调用都会通过此网关,而不是直接访问网络。使用 globalOutbound 和 ctx.exports 将网关传递给动态 Worker:
import { WorkerEntrypoint } from "cloudflare:workers";
export class HttpGateway extends WorkerEntrypoint {
async fetch(request) {
// Every outbound fetch() from the dynamic Worker arrives here.
// Inspect, modify, block, or forward the request.
return fetch(request);
}
}
export default {
async fetch(request, env, ctx) {
const worker = env.LOADER.get("my-worker", async () => {
return {
compatibilityDate: "$today",
mainModule: "index.js",
modules: { "index.js": code },
// Pass the gateway as a service binding.
// The dynamic Worker's fetch() and connect() calls
// are routed through HttpGateway instead of going
// to the network directly.
globalOutbound: ctx.exports.HttpGateway,
};
});
return worker.getEntrypoint().fetch(request);
},
};从这里开始,您可以向网关添加任何逻辑,例如限制目标、注入凭证或记录请求。
一种常见的模式是将凭证附加到出站请求,因此动态 Worker 永远看不到机密。类似于自定义绑定,您可以使用 ctx.props 将每租户或每个请求上下文传递给网关。
动态 Worker 正常调用 fetch()。HttpGateway 拦截请求,从 loader Worker 的环境附加令牌,然后转发它。动态 Worker 永远无法访问 API_TOKEN。
import { WorkerEntrypoint } from "cloudflare:workers";
export class HttpGateway extends WorkerEntrypoint {
async fetch(request) {
let url = new URL(request.url);
const headers = new Headers(request.headers);
// For requests to api.example.com, inject credentials.
if (url.hostname === "api.example.com") {
headers.set("Authorization", `Bearer ${this.env.API_TOKEN}`);
headers.set("X-Tenant-Id", this.ctx.props.tenantId);
}
return fetch(request, { headers });
}
}
export default {
async fetch(request, env, ctx) {
const tenantId = getTenantFromRequest(request);
const worker = env.LOADER.get(`tenant:${tenantId}`, async () => {
return {
mainModule: "index.js",
modules: {
"index.js": `
export default {
async fetch() {
const resp = await fetch("https://api.example.com/data");
return new Response(await resp.text());
},
};
`,
},
globalOutbound: ctx.exports.HttpGateway({
props: { tenantId },
}),
};
});
return worker.getEntrypoint().fetch(request);
},
};