・応答を待たせずに重い処理を後に回したい
・メール送信などの失敗を確実にやり直したい
・無料プランでどこまで使えるか知りたい
Cloudflare Queues は、Workers とあわせて使うメッセージキュー(処理の依頼を預かり、後で取り出して片付ける仕組み)です。送る側の Worker は書き込めた時点で応答を返せるので、重い処理で利用者を待たせません。失敗した分は自動で届け直され、2026年2月には無料プランでも使えるようになりました。
この記事では、仕組み、失敗と重複への備え、できること、料金と無料枠の数え方、始め方、使う前の注意点を、2026年11月時点の公式ドキュメントをもとに説明します。Cron Triggers・Workflows・K2 との細かい比べ方は、それぞれの記事に任せます。
この記事のゴール(読了目安 約8分)
送る側と受ける側の流れと料金の数え方を知り、自分の処理をキューに回すか決められるようになる
Cloudflare Queuesとは
Queues は、メッセージをキューに入れて非同期に処理するためのメッセージキューです。非同期処理とは、利用者への応答を先に返し、時間のかかる処理を後で行うことです。配信は保証付きで、エグレス(外へ出ていくデータの転送)の帯域に料金はかからず、無料・有料のどちらのプランでも使えます。
公式が挙げるできることは、配信の保証、リクエストからの処理の切り離し、Worker 間のデータの受け渡し、データをためてまとめること、の4つです。EC サイトの注文の受付と発送の処理を別の部品に分ける使い方が公式の例で、メール・通知・API 呼び出しのような裏方の仕事にも向くとされています。
利用者に返す処理と時間のかかる処理を、キューをはさんで切り分けるのが Queues です。
Workers 本体の料金や始め方は、Cloudflare Workersとは?仕組み・料金・無料枠と始め方で解説しています。
Queuesの仕組み:送る側と受ける側
Queues では、送る側(プロデューサー)がキューに書き込み、受ける側(コンシューマー)がまとめて受け取って処理します。
送る側の Worker には、キューをバインディング(Cloudflare の資源をコードから呼べるようにする結び付け)しておき、send() を呼んで書き込みます。send() が終わった時点でメッセージはディスクに書かれているので、Worker はそこで応答を返して構いません。
受ける側には、queue ハンドラーを書いた Worker がメッセージのあるときに呼ばれるプッシュ型と、HTTP でメッセージを取りに行くプル型の2種類があります。1つのキューにはどちらかの型しか設定できず、プッシュ型の Worker は1キューに1つまでです。受ける側は送る側と同じ Worker に書いてもよく、始めるならプッシュ型が簡単だと公式は書いています。
メッセージは、既定では10件たまるか5秒たつかの早いほうで、バッチ(まとめて届く数件)として届きます。queue() がエラーなく返ると、そのバッチは完了として扱われます。
Queues は、書き込んだ順番どおりに届けることを保証していません。 受ける側は順番に頼らない作りにします。

失敗したときの再試行と重複への備え
失敗したメッセージは既定で3回まで届け直され、それでも失敗すると、DLQ(デッドレターキュー)があればそこへ移り、無ければ削除されます。
既定では、成否をバッチ単位で扱います。公式の例では、10件のバッチの8件目で失敗すると、10件すべてが届け直されます。ack() で1件ずつ完了を伝えておけば、済んだ分は届け直されません。外部 API の呼び出しや DB への書き込みのように、繰り返すと困る処理で使います。再試行の回数は max_retries で最大100回まで増やせます。
DLQ は、上限まで失敗したメッセージの送り先にする別のキューです。受ける側の設定の dead_letter_queue に名前を書き、処理し直すときは DLQ にも受ける側をつなぎます。本番の前に DLQ を決めておけば、失敗し続けたメッセージを消さずに調べられます。

送るときも再試行のときも、メッセージは最大24時間遅らせられます。呼んでいる外部 API が 429(呼び出しが多すぎる)を返したら、遅らせて処理の速さを落とすのが公式の例です。
配信は既定で「少なくとも1回」なので、同じメッセージがまれに2回以上届きます。公式は、書き込むときに一意な ID を付け、DB の主キーや、メール・決済の API に渡す重複よけの ID に使うよう勧めています。
Queuesでできること
1件ずつ片付け、失敗したらやり直したい裏方の仕事が、Queues に向いています。 公式の例は次のとおりです。
- メール・通知・外部 API の呼び出しを、利用者への応答の後に回す
- JavaScript のエラーをキューに送り、まとめて R2 のログファイルに書く
- 毎秒2件までのメール API(Resend)に合わせ、バッチを2件にし、失敗したら5秒後にやり直す
- 巡回する URL をキューに入れ、Browser Run の1つのブラウザーでまとめて開く(Web クローラーの例)
キューへの入口は、Worker の send() だけではありません。R2 のイベント通知なら、バケットでのファイルの作成・削除がキューに届き、送る側の Worker は要りません。製品の出来事を受ける「イベントの購読」もあり、Email Sending なら配達・バウンス・苦情など6種類の状態をキューで受けられます。
決まった時刻に動かす処理は、Cloudflare Cron Triggersとは?定期実行の書き方と制限で扱っています。複数の手順を、途中の状態を保ちながら進めたいときは、Cloudflare Workflowsとは?手順を確実に進める仕組みと料金を読んでください。
Queuesの料金と無料枠
2026年11月時点の公式ページでは、Queues は2026年2月4日から無料プランでも使え、機能は有料と変わりません。料金は「操作」の数で決まり、プランの主な違いは操作の枠と保持期間(未読のメッセージを残す長さ)です。
数え方は次のとおりです。
- 書き込み・読み取り・削除を、それぞれ64KB ごとに1操作と数えます(約100バイトの内部データ込み)
- バッチにまとめても、Queues の操作はメッセージの件数で数えます。 減るのは受ける側の Worker が呼ばれる回数です
- 1件は多くの場合3操作です。再試行のたびに読み取りが1つ増えます
無料枠の1日10,000操作を3で割ると、64KB 未満で再試行の無いメッセージなら1日およそ3,300件です(公式の数字からの試算)。公式の計算例では、有料プランで64KB 未満を1日100万件、30日続けると月35.60ドルです。数え方の原文は Queues の料金ページ で読めます。

Queuesの始め方
Getting started(公式の入門手順)は5段で、送る側と受ける側を1つの Worker に書く流れです。事前に Cloudflare のアカウントを作り、Node.js を入れておきます。
- 新しい Worker のプロジェクトを作る
- キューを作る
wrangler.jsoncに送る側のバインディングを書き、send()を足して公開する- 同じコードに
queueハンドラー、設定に consumers を足して、もう一度公開する - 受ける側のログを見る
コマンドは次のとおりです(公開は3段目と4段目の2回)。
npm create cloudflare@latest -- producer-worker
cd producer-worker
npx wrangler queues create <MY-QUEUE-NAME>
npx wrangler deploy
npx wrangler tail
公式の例のコードは次のとおりで、MY_QUEUE はバインディングの名前です。
export default {
async fetch(request, env, ctx): Promise<Response> {
const log = {
url: request.url,
method: request.method,
headers: Object.fromEntries(request.headers),
};
await env.MY_QUEUE.send(log);
return new Response("Success!");
},
async queue(batch, env, ctx): Promise<void> {
for (const message of batch.messages) {
console.log("consumed from our queue:", JSON.stringify(message.body));
}
},
} satisfies ExportedHandler<Env>;
キューの名前は1〜63文字で、先頭と末尾は英字か数字、記号はハイフンに限られます。付けた名前は後から直せないため、debug-logs のように中身の分かる名前にします。
送る側がまだ無くても、ダッシュボードでキューの Messages タブから手でメッセージを送り、受ける側を試せます。手元では npx wrangler@latest dev で動かせますが、--remote には対応していません。本番では send() の失敗を try...catch で受け、DLQ も設定しておきます。
使う前の注意点
料金のほかに、メッセージが残る長さと流れる量にも決まりがあります。2026年11月時点の主な上限は次のとおりです。
- 無料プランでは、24時間以内に処理されなかったメッセージは消えます。 書き込みに処理が追いつかないと、たまった分が保持期間を過ぎて削除されることがあります
- 1件は 128KB まで。1キューに毎秒5,000件を超えて書くと、
send()がToo Many Requestsの例外を投げます - 受ける側の1回の実行は、待ち時間も含めた経過時間で15分までです
- 受ける側が不調なら、
npx wrangler queues pause-delivery <QUEUE-NAME>で配信だけを止められます。その間もキューは書き込みを受けて残します(保持期間を過ぎた分は消えます)。一方、全件削除(purge)は取り消せません
上限の一覧は Queues の上限のページ にまとまっています。
よくある質問
1つのメッセージを複数の仕組みで読めますか?
プッシュ型の受ける側は1キューに1つで、プル型の読み手を並べても、それぞれが別のメッセージを受け取ります。同じイベントを独立した複数の読み手で読むなら K2 が向く、と公式の製品の選び方にあります。詳しくはCloudflare K2とは?イベントを残して複数で読む仕組みと料金で解説しています。
Workerの waitUntil() では足りませんか?
waitUntil() で応答の後に処理を続けられるのは30秒までです。その中でキューに send() すれば応答は待たせずに済みますが、送信のエラーは黙って無視されます。失敗をやり直したい処理は send() の完了を確かめてキューに渡し、再試行を Queues に任せるのが編集部の目安です。
Cloudflareの外のサーバーからも使えますか?
使えます。書き込みは HTTP で直接でき、Queues Edit の権限を持つ API トークンを使います。受け取りはプル型で、読み取りと書き込みの両方の権限が要り、空のキューに取りに行っても読み取り1操作と数えます。
データを置く地域は選べますか?
2026年11月時点では、キューを作るときに EU・米国・FedRAMP のどれかに限れます。後から足す・変える・外すことはできず、一覧に日本はありません。地域を限ったキューにも、Workers はどこからでも書き込めます。
この記事のポイント
- 送る側は書き込めた時点で次へ進み、受ける側が後でまとめて処理する
- 失敗は既定3回まで再試行し、上限を超えるとDLQへ移るか削除される
- 届く順番は保証されず、まれに重複するので一意なIDで見分ける
- 無料プランは1日1万操作・保持24時間。1件は多くの場合3操作で数える
まとめ
Queues は、書き込む側と処理する側をキューで切り離し、重い処理を後に回すための仕組みです。失敗は既定で3回やり直され、上限を超えた分は DLQ に移せます。順番は保証されず、まれに重複するので、一意な ID で見分ける前提で作ります。無料プランでも1日1万操作まで使え、1件は多くの場合3操作です。
最初の一歩は、Getting started の5段でキューを1つ作り、ダッシュボードから送った1件が受ける側のログに出るかを見ることです。本番の前には DLQ と保持期間を確かめておきます。時刻で動かす処理や複数の手順の処理は、Cron Triggers と Workflows の記事と比べてください。






