コンテンツにスキップ

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 に持ち越せる。

2024〜2025年にかけて、Cloudflare の方針が大きく動いた。

ただし同時に、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に対応する:

PagesWorkers
静的ファイルのホスティングWorkers Static Assets
functions/ ディレクトリ(ファイルベースルーティング)Worker の fetch ハンドラ+ルーティング
Pages の Git 連携Workers Builds
プレビューデプロイWorkers の Preview URLs

こうして機能が重なった結果、「2つを別製品として維持する理由が薄れた」のが統合方針の背景。

機能は重なったが、使い勝手の細部には差が残っている(2026年10月時点)。

観点PagesWorkers
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 の右にある鉛筆のアイコンをクリックすると、変更画面に入る。

Workers & Pages のページ。右カラムの Account details に Account ID と Subdomain が並び、Subdomain の右の鉛筆アイコンが赤丸で囲まれている

右カラムの Account details。Subdomain の右の鉛筆アイコンから変更画面に入る

Change account subdomain の画面。新しいサブドメイン名を入力している

新しい名前を入れると、my-worker という Worker がどの URL になるかがその場で示される。空いていない名前は先へ進めない

確認画面。移動する 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-site
Delegating to the latest version of Cloudflare Pages, now part of Cloudflare Workers

AI エージェントが実行したときだけ起きる。 人が同じコマンドを手で打っても 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.」と書かれている。

  • 静的サイトを手軽に公開したい・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 の両方に対応している。手順が違うところはタブで切り替える。

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 など)。