・チャットや共同編集の状態をそろえたい
・無料プランでどこまで動かせるか知りたい
・D1やWorkflowsとの使い分けに迷っている
Durable Objects は、計算と保存を組み合わせた特別な Worker で、同じ名前を指定した要求は、世界のどこから送っても同じ1つのインスタンス(実際に動く1つの実体)に届きます。1つずつに専用の SQLite のストレージが付くので、チャットの部屋や共同編集の文書など、複数の利用者が触る状態をそろえられます。
この記事では、2026年11月時点の公式ドキュメントに沿って、普通の Worker との違いと仕組み、料金と無料プランの枠、向く処理、始め方と注意点を説明します。AI エージェントの作り方は別の記事に任せます。
この記事のゴール(読了目安 約8分)
同じ名前が1か所に集まる仕組みと料金の数え方を知り、使う場面を判断して試せるようになる
Durable Objectsとは
公式の定義では、Durable Objects は計算と保存をあわせ持つ、特別な種類の Worker です。普通の Worker と比べた違いは、次の2点です。
- 名前:1つずつが世界で一意な名前を持ち、どこからでも決まったオブジェクトに要求を送れます。そのため、複数の利用者の調整役になれます
- 保存:永続ストレージがオブジェクトと同じ場所にあり、強い整合性(書いた直後から、どこで読んでも新しい値が返る性質)を保ったまま速く読み書きできます

普通の Worker は要求ごとに別の場所で動くことがあり、要求の間でメモリを共有しません。Durable Objects は1か所で動き、前の要求の続きを覚えている Worker です。
無料プランで使えるようになったのは2025年4月で、対象は SQLite 型です。Worker の基本と無料枠を確かめるなら、Cloudflare Workersとはが入口になります。
仕組み:同じ名前は1か所に届く
同じクラスで同じ名前のインスタンスは、世界で同時に1つしか動きません。要求は次の3段でそこへ届きます。
- 利用者の要求は、まず Worker が受けます。Durable Object はインターネットから直接は要求を受けません
- Worker は
getByName()に部屋の名前などの決まった文字列を渡してスタブ(特定のオブジェクトへ要求を送る窓口)を作り、メソッドを呼びます。このとき動き出し、無ければ作られます - 要求は、その名前のオブジェクトを持つデータセンターへ運ばれます

世界のどこの Worker から呼んでも、名前が同じなら受け取るのは同じ1つのオブジェクトです。
中はシングルスレッド(処理の流れが1本)で、1つずつ実行します。保存の読み書きの間はほかの要求を待たせ、要求と保存の操作には世界で1つの順序が付きます。ただし、届いた順に処理されるとは限りません。
今は、要求や未完了の通信などが無い状態が10秒続くと、オブジェクトはメモリから外れます(休止)。メモリ上の値は捨てられるので、残したい値はストレージに書いておきます。
1つのオブジェクトでできること
1つのオブジェクトは、データの保存、WebSocket の接続、時刻を決めた予約の3つを受け持てます。Worker 側からは、クラスの public なメソッドを RPC(別の場所の処理を、手元の関数と同じ書き方で呼ぶ仕組み)で呼び出します。
- 保存:SQLite 型なら SQL API とキー・バリュー API の両方を使え、トランザクションに対応します。中身はそのオブジェクト専用で、容量は1つ10GB(有料プラン)です
- WebSocket:1つで数千の接続を受け、チャットの部屋やゲームの参加者の間を取り持てます。公式が勧める Hibernation API なら、休止中も接続は切れず、その間の実行時間もかかりません
- アラーム:未来の時刻に自分を起こし、
alarm()を動かします。1つに同時に1個までで、少なくとも1回は実行され、失敗すると最大6回まで自動で再試行します
公式の製品ページの例では、チャットの部屋ごとに1つ置き、発言・参加者・部屋の状態をまとめて受け持たせます。
料金と無料プランの枠
2026年11月時点の公式の料金ページでは、料金は計算と保存の2種類で、無料プランで使えるのは SQLite 型だけです。
無料プランは、枠を1つでも超えるとその種類の操作がエラーになります。1日の枠は 00:00 UTC(日本時間の午前9時)に戻ります。有料プランの込みの量は、月5ドルからの Workers Paid の料金に入っています。
実行時間(GB-s:メモリの GB×秒)とリクエストは、次のように数えます。
- 動いている間と、休止できずにメモリに残る間を、使用量によらず128MB 分で数えます
fetch()などの通信を待つと、1つの操作ごとに最大15分メモリに残り、その間もかかりますaccept()で受けた WebSocket は、つながっている間ずっと数えます。リクエストの数では受信20通を1回と数え、送信は無料です
かからないのは休止中の実行時間です。WebSocket は Hibernation API で受ければ、処理を終えて待つ間を数えません。
行の込みの量と単価は D1 にそろえてあり、get() や put() も行で数えます。SQLite 型の保存量の課金は、料金ページ(2026年11月13日更新)でも「2026年1月7日を目標日に有効にする(それより前ではない)」という予告の書き方のままです。無料プランは課金されないと告知されています。
向く処理とほかの製品の使い分け
Durable Objects が向くのは、同じ状態を複数の利用者や要求が触る処理です。状態を持たない処理なら、普通の Worker で足ります。
利用者や部屋ごとに覚えておく状態があるなら Durable Objects、無ければ普通の Worker です。
D1 の料金と始め方はCloudflare D1とは、手順の自動化はCloudflare Workflowsとはで扱っています。AI エージェントの作り方は、Workers AIとAgents SDKをまとめた記事にあります。
始め方:テンプレートから公開まで
公式の Get started のテンプレートなら、クラス・呼び出し・設定が最初からそろいます。アカウントと Node.js を用意して進めます。
- 下の1行目でプロジェクトを作り、
Hello World example、Worker + Durable Objects、TypeScriptを選ぶ(すぐ公開するかはNo) - フォルダーに移り、
src/index.tsで、ctx.storage.sqlを使うクラスと、getByName()で呼ぶ Worker を見る wrangler.jsoncで、バインディング(Worker からクラスを使う結び付け)とexportsを確かめるnpx wrangler devで手元で試し、npx wrangler deployで公開する
npm create cloudflare@latest -- durable-object-starter
cd durable-object-starter
npx wrangler dev
npx wrangler deploy
{
"durable_objects": {
"bindings": [
{
"name": "MY_DURABLE_OBJECT",
"class_name": "MyDurableObject",
},
],
},
"exports": {
"MyDurableObject": {
"type": "durable-object",
"storage": "sqlite",
},
},
}
exports は2026年6月に加わった書き方で、以前の migrations に代わります。1つの Worker ではどちらか一方を使います。公式の Get started は最後に、Durable Objects の支出の上限かメールの通知を設定するよう案内しています。
使う前の注意点:分け方と置き場所
1か所に集める仕組みなので、何を1つにするかと、どこに作られるかで速さが変わります。
- 単位で分ける:公式は、チャットの部屋、ゲームのセッション、文書、利用者のデータ、テナント(顧客の会社)の作業場のように、調整が要る単位ごとに1つ作るよう勧めています。数に上限はありません
- 1つの処理量:目安は1秒1,000件ほどで、処理が重いと下がります。受けきれない要求は待ち行列に入り、それでもあふれると overloaded のエラーが返ります
- 割り込み:保存以外の通信(
fetch()や R2 への書き込み)を待つ間は、ほかの要求が割り込み、競合が起きることがあります - 置き場所:最初の要求の近くに作られ、今は後から動きません。最初の利用者の要求より前に作っておくと、応答が遅くなることがあります

全体で1つにまとめず、調整が要る単位ごとに分けます。サイト全体のカウンターやレート制限を1つのオブジェクトで受けると、すべての通信がそこを通って詰まります。
よくある質問
日本の利用者の近くに置けますか?
既定では、最初の要求の近くに作られます。最初の呼び出しで位置ヒント(置きたい地域の希望)に apac-ne(北東アジア太平洋。告知の例では日本・韓国など)を渡せますが、保証ではありません。公式は、どうしても要るとき以外は付けないよう勧めています。
ネットの古いコード例は今も使えますか?
idFromName() と get() を組み合わせる書き方は今も使え、2025年8月からは getByName() で名前から直接呼べます。migrations のままの設定も動きます。「有料プランが必要」という解説は、2025年4月より前の情報です。
料金が膨らむのを途中で止められますか?
2026年11月13日から、ダッシュボードの Billing > Spend limits で、支出の上限と通知のメールを決められます。上限に達すると新しい要求や SQL の読み書きは拒否されますが、データは消えません。保存量の料金は対象外で、Workers の上限は別に設定します。
デプロイするとWebSocketの接続は切れますか?
2026年10月30日からは、デプロイしても、動いているオブジェクトは休止するまで最大5分、それまでのコードのまま動きます。Hibernation API の接続は、休止の後に新しいコードへ替わっても切れません。すぐ替えるなら --durable-objects-code-update-mode immediate を付けて公開します。
この記事のポイント
- 同じ名前の要求は、世界で1つのインスタンスが受けて処理する
- SQLite型なら無料プランで使え、枠を超えるとその操作がエラーになる
- WebSocketはHibernation APIで受け、待機中の実行時間を省く
- 部屋や文書などの単位で分け、全体を1つにまとめない
まとめ
Durable Objects は、同じ名前の要求を世界で1つのインスタンスに集め、専用の SQLite に状態を残す Worker です。部屋・文書・利用者ごとに状態をそろえる処理に向き、SQLite 型なら無料プランでも使えます。WebSocket を扱うなら、受け口は公式が勧める Hibernation API にします。
最初の一歩は、テンプレート「Worker + Durable Objects」のプロジェクトを npx wrangler dev で手元で動かすことです。作るときは部屋や文書の ID を名前に渡し、全体で1つにしません。保存先や手順の自動化で迷ったら、D1 や Workflows の記事へ進んでください。






