cloudflare/computer

项目概览

该项目将 SQLite 中的权威状态以文件系统形式暴露，并提供容器、Isolate Shell、Isolate JavaScript 三种可插拔执行后端；其 computerd FUSE 挂载在元数据密集型工作负载上的表现优于真实磁盘。

项目类型

AI Agent · AI 工作流 · 基础设施

应用场景

自动化执行

部署方式

查看项目说明

License

MIT

适合谁

• 需要在 Cloudflare Durable Objects 和 Workers 环境中为 AI 代理提供有状态虚拟文件系统和代码执行能力的开发者。

核心能力

• 在 SQLite 中保存权威状态，并将其作为可被代理挂载或访问的文件系统暴露出来。
• 将 SQLite 状态以 FUSE 挂载的形式投射到沙箱容器中，通过 RPC 将变更同步回来；提供带有真实二进制程序和网络访问的 Linux 用户空间。
• 在 Dynamic Worker 中运行 just-bash，通过 Workers RPC 访问权威 Workspace，无需第二份存储或同步。
• 在新的 Dynamic Worker 中运行 ECMAScript 模块，支持结构化输入/输出、持久的相对导入，以及由 Workspace 支撑的 node:fs/promises。
• 沙箱侧守护进程，将状态挂载为文件系统，并提供 HTTP/WebSocket RPC 服务器。
• 为 Node 环境提供 @platformatic/vfs 提供者。
• 附带多种 Worker workspace 示例，包括聊天代理、运行时对比界面、教程、制品生成和资源图片生成。

限制与风险

• 该项目不适合生产使用，仅作为预览提供以收集反馈。
• API 不稳定，设计可能发生变化。
• 规范文档具有前瞻性，描述的是设计意图而非当前代码的实际状态。
• FUSE 挂载在大块顺序 I/O 上落后于真实磁盘。

如何开始

• 安装 @cloudflare/computer 包后，按照 README 指引完成安装步骤，配置一种执行后端（容器、Isolate Shell 或 Isolate JavaScript），然后通过 workspace.runtime.exec(source, { backend }) 执行代码。需要理解 Cloudflare Durable Objects 和 Workers API，且 API 处于实验性、不稳定状态。

核验依据

• README: Cloudflare Computer is a virtual filesystem that lives inside a Durable Object.
• README: Three backends ship today: - **Container** projects the SQLite state into a sandbox container as a real FUSE mount. A sandbox-side daemon (`computerd`) mounts the state as a files…
• README: **PREVIEW ONLY** This package is provided as a preview for feedback only. > APIs are unstable and the design is subject to change. > > Suitable for experiments, exploration and pr…
• README: The examples/ directory holds runnable consumers of the public surface. Each is a Worker workspace with its own README. - examples/container — runs computerd inside a container, m…
• README: If you want to build on Cloudflare Computer, install [`@cloudflare/computer`](packages/computer/README.md) and follow that package's README — it has the installation steps, the en…

来源更新时间：2026-08-05T18:19:09Z

打开原始 GitHub 项目