サーバーDurable ObjectsWorkers料金・無料枠データベース

Durable Objectsとは?状態を1か所に集める仕組みと料金

フレアはゆるフレアはゆる
こんな人におすすめ
・チャットや共同編集の状態をそろえたい
・無料プランでどこまで動かせるか知りたい
・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 Object で、名前ごとに1つだけ動き、専用の保存領域を持つ
普通の Worker は状態を持たず、Durable Object は名前ごとに1つで保存領域を持ちます。

普通の Worker は要求ごとに別の場所で動くことがあり、要求の間でメモリを共有しません。Durable Objects は1か所で動き、前の要求の続きを覚えている Worker です。

無料プランで使えるようになったのは2025年4月で、対象は SQLite 型です。Worker の基本と無料枠を確かめるなら、Cloudflare Workersとはが入口になります。

仕組み:同じ名前は1か所に届く

同じクラスで同じ名前のインスタンスは、世界で同時に1つしか動きません。要求は次の3段でそこへ届きます。

  1. 利用者の要求は、まず Worker が受けます。Durable Object はインターネットから直接は要求を受けません
  2. Worker は getByName() に部屋の名前などの決まった文字列を渡してスタブ(特定のオブジェクトへ要求を送る窓口)を作り、メソッドを呼びます。このとき動き出し、無ければ作られます
  3. 要求は、その名前のオブジェクトを持つデータセンターへ運ばれます
別々の場所にいる A さんと B さんの要求を、それぞれ Worker が同じ名前で呼ぶと、同じ1つの Durable Object に集まり、そろった状態が両方に返る
別々の場所の利用者でも、同じ名前を指定すれば同じ1つのオブジェクトが受けます。

世界のどこの 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日10万回100万回/100万回ごとに0.15ドル
実行時間1日13,000 GB-s40万 GB-s/100万 GB-s ごとに12.50ドル
読んだ行1日500万行250億行/100万行ごとに0.001ドル
書いた行1日10万行5,000万行/100万行ごとに1.00ドル
保存量合計5GB5GB・月/1GB・月ごとに0.20ドル(課金の開始は予告。下の段落)

無料プランは、枠を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
状態を持たない API や変換を、近くの拠点で並列に処理する普通の Worker
利用者・商品・注文のデータに、その都度 SQL で問い合わせる(読み取りが多い)D1
セッションや設定値を、とても多く読むWorkers KV
複数の手順をつなぎ、失敗をやり直し、状態を数週間まで保つWorkflows
AI エージェントを動かす(1体が1つの Durable Object)Agents SDK

利用者や部屋ごとに覚えておく状態があるなら Durable Objects、無ければ普通の Worker です。

D1 の料金と始め方はCloudflare D1とは、手順の自動化はCloudflare Workflowsとはで扱っています。AI エージェントの作り方は、Workers AIとAgents SDKをまとめた記事にあります。

始め方:テンプレートから公開まで

公式の Get started のテンプレートなら、クラス・呼び出し・設定が最初からそろいます。アカウントと Node.js を用意して進めます。

  1. 下の1行目でプロジェクトを作り、Hello World example、Worker + Durable Objects、TypeScript を選ぶ(すぐ公開するかは No)
  2. フォルダーに移り、src/index.ts で、ctx.storage.sql を使うクラスと、getByName() で呼ぶ Worker を見る
  3. wrangler.jsonc で、バインディング(Worker からクラスを使う結び付け)と exports を確かめる
  4. 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つの Durable Object にする単位の例。チャットの部屋ごと、共同編集の文書ごと、ゲームのセッションごと、利用者のデータごとに1つ作る
部屋・文書・ゲーム・利用者のように、調整が要る単位ごとに1つ作ります。

全体で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 の記事へ進んでください。

無料ダウンロード資料「Cloudflareが漫画でわかる」資料を受け取る

この記事を書いた人

フレアはゆる

編集長

フレアはゆるフレア ハユル

Cloudflare を知り尽くした(未来形)、フレアはゆるの編集長。Webサイト制作とサーバー運用の現場で Cloudflare を使い、迷ったところ・つまずいたところをそのまま記事にしています。

フレアはゆるについて詳しく見る →

サーバーの記事一覧へ戻る
フレアはゆるとははゆるに相談