Cloudflare Computer 深度解读：给 AI Agent 一台真正的电脑

如果 AI Agent 不只是调用 API，而是拥有一台真实的计算机——带文件系统、能运行 Shell 命令、能执行 JavaScript 模块——会怎样？Cloudflare 最新开源的 Cloudflare Computer 项目，正是朝着这个方向迈出的关键一步。

项目概述

Cloudflare Computer 是一个基于 Cloudflare 基础设施的虚拟文件系统与运行时环境。它的核心思路非常巧妙：将文件系统的所有状态存储在 Cloudflare 的 Durable Object（持久化对象）中，基于 SQLite 实现权威状态管理，再通过可插拔的运行时后端，让 AI Agent 安全地在沙盒中执行代码、读写文件、运行 Shell 命令。

项目上线不到两个月就收获了 4,868+ Stars，今日更是飙升 2,800+ Stars，足见开发者社区对这个方向的极度关注。

• GitHub 地址：github.com/cloudflare/computer
• Stars：4,868+（今日新增 2,800+）
• 语言：TypeScript
• 许可证：MIT
• 当前状态：Preview（仅供实验和反馈，不适合生产环境）

核心设计理念

Cloudflare Computer 的架构可以概括为 “一个权威状态源 + 多种运行时后端”：

• Durable Object + SQLite：所有文件系统的元数据和内容存储在 Cloudflare 的 Durable Object 中，底层基于 SQLite，保证数据持久性和一致性。
• 虚拟文件系统（Virtual FS）：在 SQLite 之上构建了一个完整的虚拟文件系统，支持标准的读写操作。
• 可插拔运行时：通过 workspace.runtime.exec(source, { backend }) 统一入口，支持三种后端切换。

三种运行时后端

1. Container 后端（真实 Linux 环境）

将 SQLite 中的状态挂载为容器内的真实 FUSE 文件系统。容器内运行 computerd 守护进程，通过 capnweb RPC 通道同步文件变更。这意味着 Agent 可以运行真实的 Linux 二进制文件，访问真实的网络，拥有完整的 Linux userland。

// 在容器沙盒中执行 Shell 命令
await workspace.runtime.exec("pandoc input.md -o output.pdf", {
  backend: "container"
});

2. Isolate Shell 后端（轻量级 Shell）

在 Cloudflare Workers 的 Dynamic Worker 中运行基于 just-bash 的 Shell 环境。无需真实容器，直接通过 Workers RPC 访问 Workspace，没有二次存储或同步开销，极快且轻量。

3. Isolate JavaScript 后端（ECMAScript 模块）

在全新的 Dynamic Worker 中执行 ECMAScript 模块。支持结构化输入/输出、持久化相对导入（durable relative imports）、配置库，以及 Workspace-backed 的 node:fs/promises 模块。

丰富的示例项目

项目仓库提供了 7 个可直接运行的示例，覆盖了不同使用场景：

• container：在 Docker 容器中运行 computerd，挂载 Workspace，通过 HTTP 接口读写执行。
• worker-shell：与 container 示例相同的 HTTP 接口，但 Shell 跑在 Dynamic Worker 中，无需容器。
• worker-javascript：不执行 Shell 命令，而是评估 ECMAScript 模块。
• think：基于 @cloudflare/think 的聊天 Agent，用 Workspace 作为工作目录。
• think-compare-runtimes：Web UI，并排对比 Container 和 Worker 两种运行时执行同一任务。
• tutorial：手把手教程——Agent 编写 Markdown 食谱卡片，再用容器中的 pandoc 生成 PDF。
• artifacts：在 Workspace 中生成 Worker 项目并发布到 Cloudflare Artifacts。
• assets：用 Workers AI 将 prompt 生成图片，写入 Workspace 并返回分享链接。

快速上手

安装

npm install @cloudflare/computer

基本用法

创建 Workspace 并进行文件操作：

import { Computer } from "@cloudflare/computer";

// 初始化 Computer 实例
const computer = new Computer(env);

// 创建 Workspace
const workspace = await computer.createWorkspace("my-agent-workspace");

// 写入文件
await workspace.fs.writeFile("/hello.txt", "Hello from Cloudflare Computer!");

// 读取文件
const content = await workspace.fs.readFile("/hello.txt", "utf-8");
console.log(content); // Hello from Cloudflare Computer!

// 执行 Shell 命令（Container 后端）
await workspace.runtime.exec("ls -la /", { backend: "container" });

// 执行 JavaScript 模块（JS 后端）
await workspace.runtime.exec(
  `export default { async fetch(req) { return new Response("OK"); } }`,
  { backend: "javascript" }
);

运行 Tutorial 示例

git clone https://github.com/cloudflare/computer.git
cd computer/examples/tutorial
cp .env.example .env  # 配置 Cloudflare 凭据
npm install
npm run dev

这个示例演示了如何让 Agent 在 Workspace 中生成 Markdown 内容，然后调用容器中的 pandoc 将其转换为 PDF 输出。

技术架构亮点

• SQLite 驱动的文件系统：Durable Object 基于 SQLite 存储，提供事务性保证，同时利用 DO 的自动复制和故障转移能力。
• capnweb RPC 协议：容器与 Durable Object 之间的通信使用高效的 capnweb 序列化协议，支持流式传输和双向同步。
• FUSE 挂载：Container 后端通过 FUSE 将 Workspace 直接挂载为容器内的文件系统，Agent 可以像操作本地文件一样操作它。
• 无二次存储：Isolate Shell 后端直接通过 Workers RPC 访问 DO，无需中间缓存或同步层，零延迟。
• 性能表现：根据项目文档的基准测试，computerd 的 FUSE 挂载在元数据密集型工作负载上超过真实磁盘，仅在大文件顺序 I/O 上略有落后。

适用场景

• AI Coding Agent 沙盒：为 Claude Code、Codex、Cursor 等 Agent 提供安全的文件系统和命令执行环境。
• 云端开发环境：在 Cloudflare 基础设施上运行轻量级开发环境，支持文件编辑、Shell 命令、包管理。
• 自动化任务：将数据处理、文档转换（如 Markdown → PDF）、代码生成等任务交给 Agent 在 Workspace 中执行。
• 多租户文件系统：利用 Durable Object 的隔离性，为每个用户或 Agent 创建独立的 Workspace。
• Agent 工作流编排：多个 Agent 共享同一个 Workspace，协作完成复杂任务。

注意事项

• 当前为 Preview 阶段：API 不稳定，设计可能变更，不适合生产环境。
• Cloudflare 生态依赖：深度绑定 Cloudflare Workers、Durable Objects、Container Platform，无法在非 Cloudflare 环境中运行。
• 资源限制：受 Workers 和 Durable Objects 的资源配额限制。
• 不接收外部 PR：当前不接受 unsolicited pull requests，但欢迎通过 Issues 提交 bug 和功能建议。

总结

Cloudflare Computer 是一个非常有前瞻性的项目。它不只是给 Agent 一个”沙盒”——而是给 Agent 一台真正的、持久的、可编程的计算机。通过将文件系统状态托付给 Durable Object + SQLite，再通过可插拔运行时提供从轻量 Shell 到完整 Linux 容器的多种执行环境，Cloudflare 为 AI Agent 的自主执行铺平了道路。

虽然目前还处于 Preview 阶段，但这个方向无疑代表了 AI Agent 基础设施的重要演进方向——Agent 不但需要思考，还需要能够真正地执行。在 Cloudflare 的全球边缘网络上拥有这样一台”计算机”，想想都觉得令人兴奋。👾

如果你对 AI Agent 基础设施感兴趣，这个项目绝对值得 star 和关注。相信随着项目的成熟，它会成为 Agent 生态中不可或缺的基础组件。

---

📌 GitHub：github.com/cloudflare/computer
⭐ Stars：4,868+ | 📅 首次发布：2025年6月 | 📜 许可证：MIT