你是否想过,无需购买服务器、不用配置 Docker、甚至不需管理 Linux 环境,就能在 Cloudflare 边缘网络上运行真实的命令行、读写文件系统、执行 Git 操作,甚至部署 Node.js 风格的脚本?Cloudflare Computer 正是这样一个颠覆性开源工具——它把一台轻量但功能完整的「虚拟电脑」封装进 Cloudflare 的 Durable Object 中,以 SQLite 为唯一数据源,通过多种运行时后端(容器、Bash 解释器、JS 模块)统一暴露为可编程的 Workspace 接口。它解决的核心问题是:让边缘计算真正具备「类本地开发环境」的表达力与一致性,告别状态同步混乱、环境碎片化和冷启动延迟。
核心功能
- 单一致态文件系统:所有操作都基于一个由 SQLite 驱动的持久化虚拟文件系统(Workspace),无论用哪种后端执行,读写都实时反映权威状态,无双写或同步冲突。
- 三合一运行时切换自如:支持三种执行模式——全功能 Linux 容器(FUSE 挂载 + real network)、极简 Bash shell(基于 just-bash,零依赖)、现代化 JS 模块(支持
node:fs/promises、ws:git、ws:artifacts等专属模块)。 - 按需懒加载后端:后端(如容器或 Isolate)只在首次调用
workspace.runtime.exec()时动态创建并连接,资源开销可控,适合突发性任务。 - 边缘原生 Git 支持:内置
ws:git模块,可在 Worker 中直接克隆、提交、推送代码库,配合 Workspace 文件系统,轻松实现「边缘 CI/CD 轻量流水线」。 - 安全沙箱 + 可信模块体系:所有 JS 运行时均在 Cloudflare Isolate 中执行,隔离严格;而
ws:artifacts等模块经过签名验证,确保只加载可信的二进制或构建产物。 - 无后端纯文件系统模式:可跳过执行层,仅使用 Workspace 的
fsAPI 进行文件增删改查,适合作为边缘缓存、配置中心或临时工作区。
适合哪些人用
前端工程师、全栈开发者、SaaS 工具作者、边缘计算探索者,以及任何需要「在 CDN 边缘快速执行脚本+操作文件+调用 Git」的场景。例如:自动化文档预览服务、用户提交代码的即时编译沙箱、静态站点的边缘 Git Hook 触发器、AI Agent 的临时工作空间、低延迟的 CLI 工具后端。它不是替代传统服务器的方案,而是为「轻量、瞬时、分布、安全」的任务提供全新抽象层级。
快速上手
目前项目处于技术预览阶段(Preview Only),暂未发布 npm 包,推荐从源码起步:
- 克隆仓库:
git clone https://github.com/cloudflare/computer - 安装依赖:
npm install(需 Node.js 20+) - 本地测试:运行
npx wrangler d1 dev+npx wrangler dev启动示例 Workspace 和 Worker - 调用示例(在 Worker 中):
const workspace = await Workspace.create("my-project");
await workspace.runtime.exec("git clone https://github.com/vercel/next.js", { backend: "isolate-shell" });
const files = await workspace.fs.readdir("/");
详细文档和完整示例见 GitHub README 中的 examples/ 目录,建议搭配 Wrangler CLI v3.60+ 使用。
项目信息
cloudflare/computer
GitHub
Give your agent a computer 👾
编程语言:TypeScript|Star 数:2304|开源协议:MIT|GitHub 项目地址
如果你厌倦了在边缘拼凑零散 API,渴望一个真正「有文件系统、有 Shell、有 Git、有 JS 生态」的统一执行环境,Cloudflare Computer 就是那个值得你第一时间试水的未来式工具。


