Cloudflare Workers と Pages:関係の整理とどちらを使うか
Cloudflare で Web サイト・Web アプリを公開する受け皿には Cloudflare Pages と Cloudflare Workers の2つがある。本サイトのハンズオンは両方に対応していて、手順が違うところはタブで切り替えて読める。Cloudflare 公式は新規開発の主軸を Workers に移しつつある。本記事では両者の関係と違い、どちらを使うかの判断材料を整理する(2026年10月時点)。
- 本サイトのハンズオンは Pages と Workers の両方に対応している。手順が違うところはタブで切り替える(Workers のタブが先に開く)。一度選んだほうは、ほかの記事でも引き継がれる
- Cloudflare 公式は新規プロジェクトでは Workers を推している。今後の新機能投資は Workers に集中する
- Pages が廃止されるわけではない。継続サポートが明言されており、強制移行の期限も発表されていない
- 🚨 ただし 2026年9月から、Wrangler で新しく作ると Workers になる(→ 5章)。Pages で新しく作るなら、ブラウザのダッシュボードで作る
迷ったら Workers でよい。Pages を選ぶ理由が残るのは、pages.dev の短い URL がほしいとき、外部の DNS のまま独自ドメインを使いたいとき、サイト全体に認証をかけたいとき(→ 6章)くらい。
「いま Pages で学ぶことが無駄になる」心配は不要。Pages Functions の実体は Workers そのものなので(→ 3章)、Pages で覚えた概念はほぼそのまま Workers に持ち越せる。
2. 公式の方向性
Section titled “2. 公式の方向性”2024〜2025年にかけて、Cloudflare の方針が大きく動いた。
- 公式ブログ Your frontend, backend, and database — now in one Cloudflare Worker で、新規のフルスタック開発は Workers で、というメッセージが示された
- 公式ブログ Pages and Workers are converging into one experience で、Pages と Workers を1つの体験に統合していくこと、今後の投資は Workers 側に集中することが表明された
- きっかけは Workers Static Assets(→ 3章)。これにより「静的サイトの配信は Pages でないとできない」という理由がなくなった
ただし同時に、Pages の継続サポートも明言されている。公式の Pages → Workers 移行ガイドにも移行期限のような記述はなく、既存の Pages プロジェクトを急いで移す必要はない。
移行ガイドには、コーディングAI向けの移行用プロンプト(実験的)も用意されている。Claude Code に渡して「このPagesプロジェクトをWorkersに移行して」と頼む使い方が想定されており、いかにも今どきのアプローチ。
3. 役割の分担と重なり:Workers Static Assets
Section titled “3. 役割の分担と重なり:Workers Static Assets”もともと両者は役割が分かれていた。
- Pages: 静的サイトのホスティング。Git 連携でデプロイし、
pages.devの URL が発行される。サーバー側の処理が必要なら Pages Functions を足す - Workers: Cloudflare のネットワーク上で動くサーバー側のコード。API やリダイレクトなどのロジック担当
ここに Workers Static Assets が登場し、Workers でも HTML/CSS/画像などの静的ファイルを一緒にアップロードして配信できるようになった。wrangler.jsonc に公開フォルダを指定するだけ:
{ "name": "my-site", "compatibility_date": "2026-06-01", "assets": { "directory": "./public" }}重要な挙動として、リクエストが静的ファイルに一致する場合は Worker のコードを起動せずにファイルを返す。静的アセットへのリクエストは無料・無制限なので、静的サイト部分の配信コストは Pages と同じ感覚で済む。
逆方向の対応も整理されている。Pages Functions は実体が Workers なので、両者の構成要素はほぼ1対1に対応する:
| Pages | Workers |
|---|---|
| 静的ファイルのホスティング | Workers Static Assets |
functions/ ディレクトリ(ファイルベースルーティング) | Worker の fetch ハンドラ+ルーティング |
| Pages の Git 連携 | Workers Builds |
| プレビューデプロイ | Workers の Preview URLs |
こうして機能が重なった結果、「2つを別製品として維持する理由が薄れた」のが統合方針の背景。
4. 実用面の違い
Section titled “4. 実用面の違い”機能は重なったが、使い勝手の細部には差が残っている(2026年10月時点)。
| 観点 | Pages | Workers |
|---|---|---|
| URL | プロジェクトごとに <プロジェクト名>.pages.dev | アカウント共通の親の下に <Worker名>.<アカウントのサブドメイン>.workers.dev |
| プレビュー | push ごとに <ハッシュ>.<プロジェクト名>.pages.dev を自動発行 | Preview URLs はあるが制約あり(ログ不可など) |
| ブラウザからの新規作成 | できる(Create application → Continue to Pages) | できる(Create application → Upload your static files) |
| ブラウザからのアップロード更新 | できる(Create deployment) | できる(Worker のページの New deployment)。画面には「HTML, CSS, and JS files」とあるが、画像なども上げられる |
404.html | 置くだけで表示される | ブラウザから上げたときは置くだけで表示される。Wrangler で公開するときは wrangler.jsonc に設定が要る |
| 過去のデプロイに戻す | ダッシュボードから | ダッシュボードのほか wrangler rollback でも。直近100バージョンまで |
| 全リクエストへの割り込み | functions/_middleware.js をルート直下に置けば既定で割り込む | 🚨 run_worker_first の指定が要る(→ 3章) |
| 独自ドメイン | サブドメインなら外部DNSのまま CNAME で設定可 | Cloudflare でネームサーバ管理しているドメインのみ |
| 無料枠(ビルド) | 月500ビルド | Workers Builds は月3,000ビルド分(分単位で計測) |
| 静的配信 | 無料・無制限 | 無料・無制限(Worker を起動しない) |
| バックエンド | Pages Functions(functions/ に置くだけ) | Worker 本体に書く(自由度が高い) |
| 使える機能 | Workers の一部機能は使えない | Durable Objects・Cron・Queues など全機能 |
| 新機能 | 来ない(継続サポートのみ) | 公式が投資する側 |
なかでも差が大きいのは、次の2つ。
URL 体系: Pages はプロジェクト名がそのまま pages.dev のサブドメインになり、URL が簡潔。Workers はアカウント単位のサブドメインが親に入るため URL が長くなり、公式も本番運用では workers.dev ではなく独自ドメインを推奨している。つまり Workers できれいな URL にするなら独自ドメインが前提になりやすい。
外部 DNS: ドメインを Cloudflare 以外の DNS で管理している場合、Pages はサブドメインの CNAME だけで独自ドメインを張れるが、Workers は Cloudflare のネームサーバ管理が必須。DNS を移したくない事情があるなら Pages が柔軟。独自ドメインの具体的な設定手順は 独自ドメインを設定する を参照。
アカウントのサブドメインは後から変えられる
Section titled “アカウントのサブドメインは後から変えられる”Workers の URL に入る「アカウントのサブドメイン」は、アカウントを作ったときに自動で決まる。メールアドレスの @ より前の部分がそのまま使われる。短くてありふれた名前だと、末尾に短い識別子が付くこともある。本サイトのアカウント(tatsuo@…)では tatsuo-8d3 だった(末尾の3文字は Account ID の先頭3文字と同じ)。
これは後から変更できる。Workers & Pages ページを開き、右カラムの Usage の下にある Account details を見る(画面が狭いときは、右カラムがページの最下部に回り込む)。ここに Account ID と Subdomain が並んでいる。Subdomain の右にある鉛筆のアイコンをクリックすると、変更画面に入る。
右カラムの Account details。Subdomain の右の鉛筆アイコンから変更画面に入る
新しい名前を入れると、my-worker という Worker がどの URL になるかがその場で示される。空いていない名前は先へ進めない
確認画面。いくつの Worker が移るかが示される。赤い枠が警告
実際に 2026年9月に tatsuo-8d3 から ytolabo へ変えたところ、アカウント配下の7つの Worker がまとめて移り、旧URLは名前解決の時点で失敗するようになった。独自ドメイン(*.vibecodingnotes.com)を当ててあるものは、URL が変わらないので影響を受けない。
変えるなら URL を配る前が楽。配ったあとだと、ブックマークや他サービスに登録したコールバックの URL を貼り直すことになる。🚨 パスキーを使っているサイトはとくに注意が必要で、URL が変わると登録済みのパスキーが使えなくなる(パスキーはドメインに束縛されるため。→ パスキーでアカウントを作る)。
5. Wrangler で新しく作ると Workers になる
Section titled “5. Wrangler で新しく作ると Workers になる”🚨 2026年9月から、Wrangler で新しいプロジェクトを作ると Pages ではなく Workers になる。 「Cloudflare Pages に公開して」と頼んでも、*.workers.dev の Worker ができる。
$ npx wrangler pages deploy ./public --project-name=my-siteDelegating to the latest version of Cloudflare Pages, now part of Cloudflare WorkersAI エージェントが実行したときだけ起きる。 人が同じコマンドを手で打っても Pages のまま。判定は Wrangler が内部で持っているので、プロンプトの書き方では避けられない。
条件は次の全部がそろったときだけ(Wrangler の PR #14312 に列挙されている)。
- AI エージェントが実行している
--forceが付いていない- 対象の Pages プロジェクトがまだ無い
functions/_worker.js_redirects_headers_routes.jsonのどれも無いpages deployに--branchが付いていない
Wrangler 4.108.0(2026年7月)で入り、4.130.0(2026年9月8日)で対象が広がった。 当初は Pages を1つも持たないアカウント限定だったのが、既に Pages を使っているアカウントでも、新しいプロジェクトなら委譲されるようになった。
⚠️ まだ実験的な機能で、公式ドキュメントには載っていない(一次情報は Wrangler の CHANGELOG と PR)。オプトアウトの --force も未掲載で、フラグ名を変える提案が未マージのまま出ている。手順書に --force を書くと、いずれ動かなくなる。
| したいこと | やり方 |
|---|---|
| Pages で新しく作る | ブラウザのダッシュボードで作る(→ SUP の Pages のタブ)。作ったあとは Wrangler からそのまま更新できる |
| Workers で作る | ブラウザで作っても(→ SUP の Workers のタブ)、Wrangler に任せてもよい(→ WRG の4章) |
| 既存の Pages を更新する | これまでどおり。委譲は起きない |
Cloudflare Pages が非推奨になったわけではない(公式の非推奨一覧に Pages 製品の記載はない)。ただし Pages の公式ドキュメントの冒頭には「Start new projects with Workers.」と書かれている。
6. 使い分けの指針
Section titled “6. 使い分けの指針”- 静的サイトを手軽に公開したい・URL は
pages.devで十分 → Pages。ただしプロジェクトはブラウザで作る(→ 5章)。作ったあとは Wrangler から更新できる - Wrangler だけで作成から公開まで済ませたい → Workers。URL は長くなるが、プロジェクト作成の手順が要らない
- 静的サイト+軽い API(データ共有型Webアプリ)→ どちらでも組める。Pages なら
functions/+D1、Workers なら Static Assets+Worker+D1(D1W は両方に対応)。新規で長く育てるなら Workers が公式の本流 - サイト全体に認証などの割り込みをかけたい → Pages のほうが素直。
functions/_middleware.jsを置くだけで済む(Workers はrun_worker_firstの指定が必要で、忘れると無言で素通りする。→ 3章) - Cron 実行・Durable Objects・Queues など Workers 固有の機能を使いたい → Workers 一択
- すでに Pages で動いているもの → そのままでよい。困っていないなら移行の必要はない
デプロイの自動化(Git 連携 vs GitHub Actions)という別軸の選択については CDM を参照。Pages の Git 連携に相当する Workers 側の機能が Workers Builds で、構図は同じ。
7. 本サイトのハンズオンとの対応
Section titled “7. 本サイトのハンズオンとの対応”ロードマップ(SUP → WRG → BAU → TWA → D1W → SOL)は、SOL 以外は Pages と Workers の両方に対応している。手順が違うところはタブで切り替える。
- 静的サイト公開: SUP(ブラウザアップロード)、WRG(Wrangler)
- アクセス制限: BAU(Pages はミドルウェア、Workers は
run_worker_first) - データ共有型: D1W
Workers だけで書いている記事。
- SOL:ソーシャルログイン(Workers + D1)
- MLA:メールに届くリンクのログイン機能(Workers + D1 + Email Service)
- ACC:ログインキーのアカウント管理(Workers + D1)
- D1P:D1 の演習(Workers + D1)
- CAP:Claude API。サイト全体に鍵をかけるので
run_worker_first: true - SVY:Workers Static Assets + Workers Analytics Engine
- LAP・WAI:Workers Static Assets ベース
応用編には、まだ Pages だけで書いている記事も残っている(Git連携の CGT など)。
8. もっと詳しく
Section titled “8. もっと詳しく”- Pages and Workers are converging into one experience:統合方針の公式アナウンス
- Migrate from Pages to Workers:移行ガイドと機能対応表
- Workers Static Assets:静的アセット配信の公式ドキュメント


