Workers

在本机运行 Cloudflare 模块 Worker。ocd 启动锁定版本的 workerd。不提供全球边缘网络、workers.dev 或 Cloudflare 控制台。

可以：

• 使用 oc run 部署模块 Worker（export default { fetch }）
• 绑定 KV、R2、D1、Durable Objects、Queues、Workflows 以及其他 Worker
• 使用 UTC cron 触发 scheduled()
• 在同一份部署中提供静态资源

export default {
  fetch(request: Request, env: Env): Response {
    return Response.json({
      message: env.GREETING,
      pathname: new URL(request.url).pathname,
    });
  },
} satisfies ExportedHandler<Env>;

仓库示例为 examples/hello-worker/。针对已运行的 ocd 部署（默认 origin http://127.0.0.1:8787）：

bun run oc run --config examples/hello-worker/open-compute.json --ocd <ocd-path>

兼容性

主题	Cloudflare	open-compute
模块 Worker（export default { fetch }）	提供	提供
isolate、env 绑定、fetch / scheduled / queue	提供	提供
Cache API、WebSocket hibernation、cloudflare:sockets、node:	提供	提供，与 Workers runtime APIs 一致
全球 Anycast / workers.dev / 自定义域名产品	提供	不提供
项目文件	wrangler.jsonc	open-compute.json（未知字段将被拒绝）
项目 JSON 中的 compatibilityDate	提供	不允许；由 runtime 锁定（当前 2026-08-30）
部署状态	Cloudflare 控制面	本机 SQLite；ocd 监督当前 workerd 进程

本节

• 快速开始
• 概念
• 示例
• 配置（绑定、兼容日期、兼容标志、Cron、环境变量、密钥、路由）
• 版本与部署
• 静态资源
• 缓存
• 运行时 API（handlers、bindings、cache、WebSockets、TCP、Node.js）
• 限制 · 已知问题 · 更新日志

若尚未运行 ocd，见 ocd 安装。