Durable Objects

Durable Object 将计算与强一致存储绑定在同一对象上。在 open-compute 上，所有对象运行在所属实例的单个本机 workerd 进程中。

例如：

• 在多个客户端之间协调状态
• 每个对象独立的强一致存储
• Alarms 与 WebSocket hibernation

export class Counter {
  constructor(
    private readonly ctx: DurableObjectState,
    private readonly env: Env,
  ) {}
  async fetch(request: Request): Promise<Response> {
    const n = ((await this.ctx.storage.get<number>("n")) ?? 0) + 1;
    await this.ctx.storage.put("n", n);
    return Response.json({ n });
  }
}

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const id = env.COUNTER.idFromName("global");
    return env.COUNTER.get(id).fetch(request);
  },
} satisfies ExportedHandler<{ COUNTER: DurableObjectNamespace }>;

在 cloudflare.config.ts 中使用 cf 标准 Durable Object 字段绑定：

import { bindings, defineConfig } from "cf/config";

export default defineConfig({
  worker: {
    name: "do-app",
    entrypoint: "src/index.ts",
    exports: {
      Counter: {
        type: "durable-object",
        storage: "sqlite",
      },
    },
    env: {
      COUNTER: bindings.durableObject({
        worker: "do-app",
        exportName: "Counter",
      }),
    },
  },
});

class 随 Worker 上传；Durable Object migration 使用 cf 标准 migrations 字段。语法见绑定。

兼容性

主题	Cloudflare	open-compute
Worker / class API	Durable Objects API	相同：namespace idFromName / newUniqueId / idFromString / get / getByName、stub fetch / RPC、state.storage 的 KV 与 SQL、transaction、output gate
对象位置	按地区调度，locationHint / jurisdiction / migration	全部位于所属实例的本机 workerd；locationHint / jurisdiction / migration 不产生地理效果
Alarms	提供	提供：getAlarm / setAlarm / deleteAlarm 与 alarm()
Hibernation	提供	提供
绑定	cf bindings.durableObject	标准 name 与 class_name，必须指定 class_name
Fetcher.connect()	通用出站	使用绑定声明的连接，而非第二条通用出站通道

下一步：Alarms · 使用 bindings 开发 · 兼容性与限制