Flue Cloudflare沙盒实战：零冷启动的Agent云端执行完整指南

Flue Cloudflare沙盒实战零冷启动的Agent云端执行完整指南【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flueFlue是一个用 TypeScript 构建自主 AI Agent 的沙盒框架而将它部署到Cloudflare后Agent 可以在 Workers 边缘网络上获得零冷启动级别的执行体验会话状态由 Durable Object SQLite 持久化虚拟沙盒毫秒级启动甚至可以通过 Workers AI 绑定完全免 API Key 运行。本文将带你完整走一遍 Flue 在 Cloudflare 上的沙盒选型、接入步骤与生产级技巧。为什么 Flue Agent 适合跑在 Cloudflare 上大多数团队把 Agent 部署到传统服务器时会撞上三堵墙冷启动慢容器拉起需要数秒高峰期排队更糟状态易丢进程崩溃后Agent 的对话进度和沙盒文件全部蒸发密钥难管API Token 只能以环境变量注入容器Agent以及 LLM 本身直接可见Flue 的 Cloudflare 目标是平台原生集成而非常规 Node 适配器构建时flue()Vite 插件会扫描你的use agent模块为每个 Agent 生成一个 Durable Object 类会话流以追加只写方式落盘在 Durable Object SQLite 中。这意味着痛点Flue Cloudflare 的解法冷启动虚拟沙盒毫秒级就绪Dynamic Worker 按需拉起无容器预热状态丢失已接受的工作在崩溃、重启、重新部署后确定性恢复密钥泄露Workers AI 绑定免 Key或 outbound Workers 出口代理零信任注 Token弹性扩展每个 Agent 实例独立 Durable Object天然水平扩展三级沙盒策略从虚拟到容器Cloudflare 上 Flue 的沙盒能力分为三层按需升级即可起步成本几乎为零第一级虚拟沙盒默认最快最省只写useModel(...)的 Agent 默认运行在内存虚拟沙盒上由 just-bash 驱动的 JS Shell内置bash、grep、glob、read、write、edit全套工具毫秒级启动、无容器、无费用。适合高并发的提示-应答型 Agent比如翻译、客服分流。第二级Cloudflare Computer 持久工作区需要文件要留下来时用cloudflare/computer的Workspace一个 SQLite 支持的持久虚拟文件系统就住在 Agent 自己的 Durable Object 里容量约 10 GB文件状态可跨越 Durable Object 重启存活。Shell 命令通过 Worker Loader 在 Dynamic Worker 中执行同样无容器、无冷启动等待。⚠️ 注意它是 JS 壳环境而非完整 Linux——grep/find可用但原生二进制和npm不行。需要语言工具链时升级到第三级。第三级Cloudflare Sandbox 容器沙盒当 Agent 需要 git、Node.js、Python、浏览器等完整 Linux 环境接入cloudflare/sandbox每个会话获得独立容器带持久文件系统与完整 Linux 用户态镜像由你自己的Dockerfile定义。缓存镜像后启动也只需数秒是编码类 Agent 的正确选择。一句话决策法先虚拟再持久最后容器——绝大多数 Agent 停留在前两级就够了。最快配置方法三步接入沙盒以容器沙盒为例Flue 提供蓝图机制一条命令生成全部样板代码完整可运行示例见 examples/cloudflare/1️⃣ 运行蓝图flue add sandbox cloudflare2️⃣ 确认 Wrangler 配置蓝图会自动追加绑定与迁移你只需检查{ compatibility_flags: [nodejs_compat], durable_objects: { bindings: [{ class_name: Sandbox, name: Sandbox }] }, migrations: [{ tag: v2, new_sqlite_classes: [Sandbox] }], containers: [{ class_name: Sandbox, image: ./Dockerfile }] }3️⃣ 在 Agent 函数中挂载沙盒——整个接线就是一行useSandboxuse agent; import { env } from cloudflare:workers; import { useModel, useSandbox } from flue/runtime; import { cloudflareSandbox } from flue/runtime/cloudflare; import { getSandbox } from cloudflare/sandbox; export function CodingAgent({ id }: AgentProps) { useModel(anthropic/claude-opus-4-7); useSandbox(cloudflareSandbox(getSandbox(env.Sandbox, id))); return You have a full Linux sandbox. Use it to complete the task.; }本地vite dev用 workerd 起服务vite build wrangler deploy一条链路部署上线。Agent 的完整挂载路由见示例项目的 src/app.ts持久工作区适配器的完整实现可研读 examples/cloudflare/src/sandboxes/cloudflare-computer.ts。零冷启动背后的三个关键设计 执行模型Flue 在 Cloudflare 上复用了官方 Agents SDK 的 Durable Object 基类请求直接落在已就绪的 DO 实例上虚拟沙盒没有启动容器这一步动态 Worker 随取随用。 确定性恢复部署更新若打断正在执行的 DOFlue 采用保守重放规则——只在能证明提供商工作未发生时才重试否则在会话历史中记录一条可见的中断提示绝不盲目重复模型调用。这对生产环境是巨大的安心。 免 Key 与零信任出口通过Workers AI 绑定路由模型流量cloudflare/...模型标识符全程无需任何提供商 API Key容器需要调用外部 API 时用outbound Workers出口代理Token 在代理层注入容器内永远看不到密钥——零信任模型且代理与容器同机延迟可忽略资源导航从文档到源码官方文档Cloudflare 部署总指南apps/docs/src/content/docs/ecosystem/deploy/cloudflare.md容器沙盒cloudflare/sandboxapps/docs/src/content/docs/ecosystem/sandboxes/cloudflare.md持久工作区cloudflare/computerapps/docs/src/content/docs/ecosystem/sandboxes/cloudflare-computer.md沙盒概念总览apps/docs/src/content/docs/guide/sandboxes.md核心源码Cloudflare 运行时集成沙盒工厂、Workers AI 提供器、DO 协调器packages/runtime/src/cloudflare/端到端示例Workers AI 绑定、R2 技能、Git 工作区examples/cloudflare/src/agents/沙盒蓝图模板flue add sandbox生成物blueprints/sandbox--cloudflare.md、blueprints/sandbox--cloudflare-computer.md总结Flue 把Agent 上云最棘手的三件事——冷启动、状态持久化、密钥安全——分别交给了 Cloudflare 的 Durable Object、SQLite 存储和出口代理来原生解决。虚拟沙盒起步免费且毫秒级响应容器沙盒按需升级配合蓝图一条命令完成接入。如果你的 Agent 正在为冷启动和崩溃恢复头疼Flue Cloudflare 值得成为你的第一个验证目标。【免费下载链接】flueThe sandbox agent framework.项目地址: https://gitcode.com/GitHub_Trending/flue1/flue创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考