本文へスキップ

本ページはプロモーションが含まれています

AI

CloudflareのPagesとWorkersの違いと選び方

CATEGORY
DRAWN BY
TOM
DATE
REV.
READ
約27分
SHEETS
12枚
Pages vs Workers(違いと選び方を6項目で)

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

Cloudflareで新しくサイトを作るなら、いまはWorkersを選ぶのが素直です。Cloudflare自身が「新規プロジェクトはPagesではなくWorkersで」と案内していて、PagesからWorkersへの移行ガイドも用意しています。

ただ、Pagesで動いている静的サイトを急いで移す必要はありません。私のブログ2つはPagesのままで、困っている点はいまのところありません。

管理画面で「Workers & Pages」と同じ場所に並んでいるのに、作り始めると設定ファイルもコマンドも違う。迷うのは当然です。

比べる軸は、静的ファイルの配信・サーバー側の処理・Git連携とプレビュー・無料枠・カスタムドメイン・wranglerの6つです。どんなときにどちらを選ぶかは、Pagesで2サイトを動かしている立場から書きます。

この記事でわかること

  • Cloudflare PagesとWorkersの違いを6つの軸で並べた早見表
  • Cloudflareが新規プロジェクトにWorkersを勧めている理由と、Pagesの今後
  • Pages FunctionsとWorkersのスクリプトの書き方・無料枠の数え方の違い
  • 外部DNSのドメインを使うならPagesが残る理由
  • wranglerのコマンドの対応表と、PagesからWorkersへ移る手順

PARTS LIST /目次

Cloudflare PagesとWorkersの違いを先に結論から

Cloudflare Pagesは「Gitにつないで静的サイトを出す」ための製品です。Workersは「エッジ(利用者に近いCloudflareのサーバー)でプログラムを動かす」ための製品として始まりました。いまはWorkersに静的ファイルを配信する機能(Workers Static Assets)が入り、できることの多くが重なっています。

重なった結果、Cloudflareは新しい機能をWorkers側に集める方針を出しました。迷う理由は「機能の差」より「どちらに乗っておけば後で困らないか」のほうにあり、その答えはCloudflare自身が出しています。

Cloudflareは新規プロジェクトにWorkersを勧めている

CloudflareのWorkersのベストプラクティスのページは、はっきりした書き方です。新しいプロジェクトを始めるなら、PagesではなくWorkersを使うように、とあります。

同じページで、Workers Static Assetsは静的サイトを出すときの推奨の方法とも書かれています。Pagesを選ぶ理由は、少なくとも「新しく作るから」では見つけにくくなりました。

新規はWorkers、既存のPagesは動き続ける。Cloudflareの案内はこの2行に集約されます。

Pagesはなくならないが、新機能はWorkers側に来る

Pagesの終了は発表されていません。ベストプラクティスのページでも、Pagesは引き続き動くとしたうえで、新しい機能と最適化はWorkersに集中させると書いています。

実際、2026年9月22日に出た「Worker Previews」(ブランチごとのプレビュー環境)はWorkersの機能です。Pagesでは前からあったプレビューの仕組みを、Workers側で作り直した形です。

つまりPagesは「止まりはしないが、伸びもしない」側に回りました。今日動いているサイトに影響はなくても、3年後に欲しくなる機能はWorkersにしか来ない、と考えておくのが無難です。

6つの軸で見るPagesとWorkersの早見表

6つの軸で並べると、違いが出るのは「サーバー側の処理」「プレビュー」「ドメイン」の3つです。静的ファイルの配信と無料枠の考え方は、ほぼ同じです。

比較の軸Cloudflare PagesCloudflare Workers
静的ファイルの配信○ 無料・無制限○ 無料・無制限(Static Assets)
サーバー側の処理△ Pages Functions(functions/ フォルダ)◎ Workerのスクリプト。Cron Triggers・Queueの受信もある
Git連携とプレビュー◎ ブランチごとに自動でプレビュー○ Workers BuildsとPreviews(2026年9月〜)
無料枠(ビルド)月500回月3,000分
無料枠(動的な処理)1日100,000リクエスト(Workersと共通)1日100,000リクエスト
カスタムドメイン◎ 外部DNSのサブドメインも可△ ネームサーバーがCloudflareのドメインだけ
wranglerwrangler pages deploywrangler deploy

Cloudflare PagesとWorkersの違い(移行ガイドの対応表と、各製品の上限・料金のページから整理)

静的ファイルの配信はPagesもWorkersも無料・無制限

HTML・CSS・画像のような静的ファイルを返すだけなら、PagesでもWorkersでもお金はかかりません。どちらの料金のページにも、静的ファイルへのリクエストは無料で無制限と書かれています。

ファイル数の上限も、無料プランなら両方とも20,000個、1ファイル25MiBまでです。ブログを出すだけなら、枠の広さで選ぶ理由はありません。違いが出るのは、配信の「設定の書き方」です。

Workers Static Assetsとは何か

Workers Static Assetsとは、HTML・CSS・画像などのファイルをWorkerと一緒にアップロードする機能です。配信とキャッシュは、Cloudflareが受け持ちます。

リクエストが来ると、まずアップロードしたファイルの中から一致するものを探します。見つかればWorkerのコードは動かずにファイルを返し、見つからなければWorkerのスクリプトに回します。スクリプトが無ければ404です。

この順番のおかげで、静的なページへのアクセスは無料のまま、動的な処理だけがWorkersの枠を使います。Pagesの「静的ファイル+Functions」と、考え方は同じです。

ファイルに一致したリクエスト

Workerのコードは動かない。無料・無制限で、1日10万リクエストの枠も減らない

一致しなかったリクエスト

Workerのスクリプトに回る。ここから先はWorkersの料金と上限で数える

_headersと_redirectsはWorkersでもそのまま使える

Pagesで使っている _headers(レスポンスヘッダーの設定)と _redirects(転送の設定)は、Workers Static Assetsでもそのまま読まれます。置き場所は、配信するファイルのフォルダの中です。

私のブログでも、_headers にセキュリティヘッダーやキャッシュの設定を、_redirects にWordPress時代のURLの転送を書いています。転送のルールは86行あります。書き直しになると気が重い量ですが、ファイルごと持っていけるのは助かるところです。

上限はPagesでは _headers が100ルール、_redirects が静的2,000本・動的100本です。転送ルールの数の実数と余裕は、Cloudflare Pagesの無料枠の記事にまとめました。

404ページとSPAは自分で指定する

PagesとWorkersで地味に違うのが、存在しないURLへの答え方です。Pagesは 404.html があるかどうかを見て、自動で振る舞いを決めていました。Workersでは設定ファイルで指定します。

  • not_found_handling: "404-page": いちばん近い 404.html を、ステータス404で返す(ブログ向け)
  • not_found_handling: "single-page-application": 一致しないURLにも index.html をステータス200で返す(ReactなどのSPA向け)
  • .assetsignore を置く: node_modules・.DS_Store・.git をアップロードから外す(Pagesは自動で外していた)

ブログを移すときに not_found_handling を書き忘れると、存在しないページの答え方がPagesのときと変わってしまいます。ソフト404で検索の評価を落とすのは避けたいので、移行の手順にも入れておきました。

サーバー側の処理:Pages FunctionsとWorkersの違い

動的な処理の書き方は、PagesとWorkersでいちばん差が出るところです。Pages Functionsはフォルダの構造で書き、Workersは1本のスクリプトに書きます。

どちらも中で動いているのはWorkersの仕組みで、料金もWorkersとして数えます。違うのは「書き方」と「使える機能の幅」です。お問い合わせフォームやAPIを1〜2本足したいだけなら、書き方の好みで選んでも困りません。

Pages Functionsはfunctionsフォルダの形がURLになる

Pages Functionsは、プロジェクトの functions フォルダに置いたファイルの場所が、そのままURLになります。/functions/helloworld.js なら example.com/helloworld で動く、という具合です。

// functions/api/hello.js → /api/hello で動く
export function onRequest(context) {
  return new Response("hello");
}

ファイルを置くだけでURLが決まるのは、Next.jsのページの置き方に近くて覚えやすい作りです。

注意したいのは、functions フォルダがあると、何も指定しない限りすべてのリクエストでFunctionsが呼ばれる点です。静的なページのアクセスまで枠を食わないように、_routes.json で動かすパスを絞ります(include・excludeの合計100ルールまで)。

Workersは1本のスクリプトで受ける

Workersでは、main に指定した1本のスクリプトがリクエストを受けます。URLごとの振り分けは自分で書くか、Honoのようなルーターを使います。

// src/index.js(wrangler.jsonc の main に指定する)
export default {
  async fetch(request, env) {
    const url = new URL(request.url);
    if (url.pathname === "/api/hello") {
      return new Response("hello");
    }
    return env.ASSETS.fetch(request); // それ以外は静的ファイルへ
  },
};

最後の env.ASSETS.fetch は、静的ファイルを返すための入り口です。Pagesでは自動で用意されていましたが、Workersでは設定ファイルの assets に "binding": "ASSETS" を書いたときだけ使えます。

書く量はPages Functionsより少し増えます。その代わり、Workersにしかない機能がそのまま使えます。

機能PagesWorkers
定期実行(Cron Triggers)×○
Queueからの受信×○
メールの受信(Email Workers)×○
レート制限×○
ログの保存(Workers Logs・Logpush)×○
段階的なデプロイ(Gradual Deployments)×○
サイトの一部のパスだけで動かす×○
ファイルの場所でURLを決める書き方○△ 変換すれば動く

PagesとWorkersで使える機能の違い(移行ガイドの対応表から抜粋)

無料枠は1日100,000リクエストを共有する

動的な処理の無料枠は、PagesとWorkersで別々ではありません。Pages Functionsへのリクエストは、Workersの無料プランの枠(1日100,000リクエスト、1回あたりCPU時間10ミリ秒)から引かれます。数え直しは毎日UTCの0時、日本時間の朝9時です。

Workers側で枠を超えたときの動きは、設定によって変わります。run_worker_first で「先にWorkerを通す」と決めたパスは、無料枠を超えると静的ファイルに逃げず、429(Too Many Requests)を返します。

ハマりポイント
run_worker_first を全部のパスに付けると、静的なページも枠を食う

run_worker_first は、認証チェックなど「ファイルを返す前に必ず通したい」処理のための設定です。全パスに付けると、ただのHTMLのアクセスまでWorkerが動き、1日10万リクエストの枠から引かれます。無料枠を超えた日は、ブログ記事まで429で開けなくなります。付けるパスは絞り、静的なパスは先頭に「!/」を付けた除外パターンで外しておきます。

有料のWorkers Paidは月5ドルからです。月1,000万リクエストとCPU時間3,000万ミリ秒が含まれ、超えた分は100万リクエストごとに0.30ドルかかります。Workersの料金のページで、使う前に一度見ておくと安心です。

Git連携とプレビュー環境の違い

GitHubにpushしたら自動で出る、という使い方は両方でできます。差が出るのは、本番に出す前のプレビューの作り方と、ビルドの無料枠の数え方です。

Pagesは「ブランチを切ればプレビューが勝手にできる」手軽さが売りでした。Workersは2026年9月にPreviewsが入り、ようやく同じことができます。ただ、手軽さはまだPagesのほうが上です。

Pagesはブランチごとに自動でプレビューができる

PagesをGitHubかGitLabにつなぐと、本番以外のブランチにpushするたびにプレビュー用のURLができます。URLはコミットごとの <ハッシュ>.<プロジェクト名>.pages.dev と、ブランチ名の別名の2種類です。プルリクエストにもURLが貼られます。

プレビューは何も設定しないと誰でも開けます。見せたくない場合は、プロジェクトの設定からCloudflare Accessで閲覧を制限します。

注意点が1つあります。Pagesのプロジェクトは、作るときに「Git連携」か「直接アップロード(Direct Upload)」かを選び、あとから切り替えられません。直接アップロードで作ったプロジェクトをGit連携にしたくなったら、プロジェクトを作り直すことになります。

WorkersはWorkers BuildsとPreviewsで追いついた

Workersでは、Git連携を「Workers Builds」が受け持ちます。つなげる先はGitHub・GitLab・Cloudflareの Artifacts で、本番以外のブランチのビルドはPreviewを作るか更新します。

Previewsは、ブランチごとに本番と切り離した環境を、同じWorkerの下に作る機能です。URLは <プレビュー名>-<Worker名>.<サブドメイン>.workers.dev か、独自ドメインなら <プレビュー名>.app.example.com の形になります。

Workers Previewsの数と条件

  • Workerあたりのプレビュー数は、無料プラン100個・有料プラン500個まで
  • 1つのプレビューに残せるデプロイは100回まで
  • wrangler 4.135.0以降が必要。手元のwrangler 4.155.0では wrangler preview がopen beta(公開ベータ)と表示される
  • プレビューは本番の変数・シークレットを引き継がない。設定ファイルの previews ブロックに書く

最後の「本番の設定を引き継がない」は、慣れるまで戸惑いそうな点です。Pagesは管理画面で本番用とプレビュー用の設定を分けて持ち、プレビュー用を一度入れればすべてのプレビューに効きます。

WorkersのPreviewsでは、変数は設定ファイルの previews ブロックに書き、シークレットは wrangler preview secret put などのコマンドで入れます。全プレビュー共通の設定(Base config)に入れたシークレットは、そのあとに作ったプレビューにしか効きません。既にあるプレビューで「なぜか動かない」となりやすいところです。

ビルドの無料枠はPagesが月500回、Workersが月3,000分

Cloudflare側でビルドする場合、無料枠の数え方が違います。Pagesは回数、Workers Buildsは時間で数えます。

項目Pages(無料)Workers Builds(無料)
ビルドの枠月500回月3,000分
同時に動くビルド1つ1つ
1回の時間の上限20分20分
有料にした場合Pro 月5,000回月6,000分(超えた分は1分0.005ドル)

ビルドの無料枠の比較(Pagesの上限のページとWorkers Buildsの上限と料金のページから)

1回3分のビルドなら、Workers Buildsの3,000分は月1,000回ぶんです。ビルドの短い静的サイトほど、Workers側のほうが回数に余裕があります。

どちらも、手元でビルドしてwranglerで直接アップロードすれば、ビルドの枠は使いません。私のブログはこの出し方です(詳しくは後半で書きます)。

カスタムドメインの違い:外部DNSならPagesが残る

独自ドメインの扱いは、Workersに移れない理由になりうる唯一の項目です。WorkersのカスタムドメインはネームサーバーをCloudflareに向けたドメインでしか使えず、外部のDNSで管理しているドメインには付けられません。

ドメインの登録先とDNSの管理先が別々になっていることは珍しくありません。移行を考える前に、自分のドメインのネームサーバーがどこを向いているかを確かめておきます。

Pagesは外部DNSのサブドメインでも付けられる

Pagesでは、blog.example.com のようなサブドメインなら、ドメインをCloudflareに移さなくても付けられます。外部のDNSにCNAMEレコードを足し、Pagesのプロジェクトを向けるだけです。

example.com のような頂点のドメイン(Apex)は、Pagesでもネームサーバーを Cloudflare に向ける必要があります。

PagesでCNAMEを使うときは、先にPagesの管理画面で「カスタムドメインを追加」を済ませてから、DNSにCNAMEを足します。順番を逆にすると、ドメインが解決できずに522エラーになります。

Workersはネームサーバーを Cloudflare に向けたドメインだけ

Workersでは、Cloudflareに登録したゾーン(ドメイン)に対して、カスタムドメインか「ルート」を設定します。ルートを使うと example.com/app/* のように、サイトの一部のパスだけをWorkerに任せることもできます。

この「一部のパスだけ」はPagesにはできない芸当です。既存のサイトの /api/ だけをWorkerで動かす、という使い方ができます。

Pagesのドメイン

外部DNSのサブドメインにCNAMEで付けられる。頂点のドメインはCloudflareのネームサーバーが必要。サイトの一部のパスだけに割り当てることはできない

Workersのドメイン

ネームサーバーがCloudflareのドメインだけ。その代わり、ルートでサイトの一部のパスだけを任せられる

wranglerの使い方の違い

wranglerはPagesにもWorkersにも使うCloudflareのコマンドラインツールで、1つのパッケージに両方のコマンドが入っています。Pages用のコマンドには pages が付く、と覚えておけばほぼ迷いません。

もう1つの違いは設定ファイルです。Pagesは設定ファイルが無くても出せますが、Workersは wrangler.jsonc(または wrangler.toml)に名前と日付を書くところから始まります。

PagesとWorkersのコマンド対応表

よく使うコマンドを並べると、次のようになります。手元のブログのリポジトリに入っているwrangler 4.155.0で、ヘルプを開いて引数を確かめました。

やりたいことPagesWorkers
手元で動かすwrangler pages dev(ポート8788)wrangler dev(ポート8787)
本番に出すwrangler pages deploy <フォルダ>wrangler deploy
プレビューに出すwrangler pages deploy <フォルダ> --branch=<名前>wrangler preview
プロジェクトを作るwrangler pages project create設定ファイルを書いて wrangler deploy
Functionsを変換する―wrangler pages functions build --outdir=<出力先>

wranglerのコマンドの対応(Pages用は pages が付く)

バージョンとヘルプの出力は、次のとおりです。

npx wrangler --version
4.155.0
npx wrangler preview --help
wrangler preview [script]

👀 Create a Preview deployment of the current Worker [open beta]

COMMANDS
  wrangler preview delete       Delete a Preview and all its deployments [open beta]
  wrangler preview secret       Manage secrets for Worker Previews [open beta]
  wrangler preview base-config  Manage the Preview base config shared by Worker Previews [open beta]

wrangler deploy --help には --assets(静的ファイルのフォルダを指定する)と --dry-run(アップロードせずに検査だけする)があります。Workersに静的サイトを出すとき、最初に試すならこの2つです。

Workersで静的サイトを出す最小の設定ファイル

静的なファイルだけを出すなら、Workerのスクリプトは要りません。wrangler.jsonc に名前・日付・ファイルの場所を書けば足ります。

{
  "name": "my-blog",
  "compatibility_date": "2026-11-20",
  "assets": {
    "directory": "./dist",
    "not_found_handling": "404-page"
  }
}

compatibility_date は、Workersの動作をどの日付の仕様に合わせるかの指定です。新しいプロジェクトでは今日の日付にしておくと、最新の動作になります。既存のPages Functionsを移す場合は、Pages側で使っていた日付をそのまま使います。

Pagesの設定にあった pages_build_output_dir は、Workersでは assets の directory に置き換わります。

Workersに移ると代わりの手段が要る4つの機能

Workersのほうが機能は多い、と書いてきました。では、Pagesにできて、Workersにできないことはないのでしょうか。

移行ガイドの対応表を1行ずつ見ていくと、「そのままでは使えないが、代わりの手段がある」という印が付いた項目がいくつか残っています。Pagesで当たり前に使っていた機能ほど、移したあとに気づきやすいところです。

機能PagesWorkersでの代わりの手段
Early Hints○ 自動△ Linkヘッダーを自分で送る
ブランチごとのデプロイ設定○ 細かく決められる△ Workers Buildsは設定の幅が狭い
Pages Plugins・ファイルの場所でURLを決める書き方○△ wranglerで変換するか、ルーターで書き直す
Rangeリクエスト(ファイルの一部だけ返す)○△ 206を返したいパスはWorkerで処理する

Workersで代わりの手段が要る機能(移行ガイドの対応表と、Static Assetsの料金と制限のページから)

Early HintsはLinkヘッダーを自分で送る

Early Hintsとは、HTMLを返す前に「このCSSを先に読んでおいて」とブラウザに知らせる仕組みです。表示の開始を少し早められます。

Pagesでは、何もしなくても使えます。Workersでは、ゾーンの設定でEarly Hintsをオンにしたうえで、Workerが Link ヘッダーを付けて返す必要があります。静的ファイルだけのサイトだと、このためだけにスクリプトを書くことになります。

ブランチごとのデプロイ設定はPagesほど細かくない

Pagesには、どのブランチをビルドするか、プレビューを作るかをブランチ名のパターンで決める設定(Branch Deploy Controls)があります。

Workers Buildsも本番以外のブランチでプレビューのビルドを流せますが、移行ガイドには「Pagesと同じ細かさはまだない」と書かれています。dependabot/* のようなブランチだけ外したい、といった運用をしている場合は、移す前に設定の画面を見比べておきます。

ブランチ名をそのまま好きなホスト名に向ける使い方も、Pagesのほうが自由です。WorkersのPreviewは <プレビュー名>.<ドメイン> の形に決まっています。

Pages Pluginsとファイルの場所でURLを決める書き方

Pages Pluginsは、認証やフォームの受け取りといった処理を、部品として functions に組み込む仕組みです。Workersには同じ名前の仕組みがありません。

既存のコードは、wranglerでPages FunctionsをまとめてWorkerに変換すれば動きます。新しく書き直すなら、自分のWorkerにコードを足すか、フレームワーク向けのプラグインを使います。ファイルの場所でURLを決める書き方が好きなら、移行ガイドが挙げているHonoXのようなフレームワークに移る手もあります。

Rangeリクエストは206ではなく200で返る

細かいところですが、動画や音声を置いているサイトでは効いてきます。Workers Static Assetsは、Range ヘッダー付きのリクエストにも、ファイル全体を 200 OK で返します。206 Partial Content は返らず、Content-Range・Accept-Ranges のヘッダーも付きません。

動画の途中から再生するような使い方では、ブラウザが毎回ファイル全体を受け取ることになります。必要なパスだけ run_worker_first でWorkerに通し、206を自分で返す、というのが案内されている回避策です。

私のブログにも、記事用のmp4の動画ファイルが3つあります。Workersに移すなら、動画の再生とシーク(途中への移動)を確かめる項目が増えます。

私の2ブログがPagesのままなのはなぜか

ここまで読むと「新規はWorkersなら、今のブログも移したほうがいいのでは」という疑問が残ります。

自分のブログの構成を見直してみると、Workersにしかない機能を1つも使っていませんでした。移行して得られるものより、DNSまわりを触り直す手間のほうが大きい、というのが今の判断です。

functionsフォルダの無い、完全に静的な構成

私のブログ(code-rebuildとsystradefx)は、2026年10月23日に移行しました。WordPressから、Astro+Cloudflare Pagesへの引っ越しです。移行の作業の大半はClaude Codeに任せ、私はCloudflareへの登録とネームサーバーの変更をしています。

LOG2026-11-20自分のブログの出し方を、設定とコードから数え直した

サイトのリポジトリには functions フォルダも _worker.js も wrangler.toml もありませんでした。2サイトとも、Pages Functionsを1本も使っていない完全な静的サイトです。

記事を反映する仕組みは、手元のMacで npm run build を流し、できた dist を wrangler pages deploy dist --project-name … --branch … --commit-dirty=true で直接アップロードしていました。設定に持っているのは、Pagesのプロジェクト名・アカウントID・出すブランチの3つ(STATIC_CF_PROJECT など)だけ。本番以外のブランチに出すときは、検索に載らない設定でビルドしています。今日のビルド結果は2,737ファイルでした。

Cloudflare側でビルドしないので、Pagesの月500回の枠も、Workers Buildsの月3,000分も関係ありません。リクエストはすべて静的ファイルに一致するので、1日10万リクエストの枠も使っていません。

この構成なら、PagesとWorkersの差は「出すときのコマンド」と「設定ファイルの有無」くらいです。

トム
トム

Workersに移しても、ブログの見た目も速さも変わらない。変わるのはコマンドの名前くらい、というのが正直なところです。

移すなら直す場所は3つある

それでも、いつか移す日のために、直す場所を洗い出しておきました。自分のリポジトリで見つけたのは次の3つです。

  1. _headers の pages.dev 向けの行。本番と同じ中身が pages.dev のURLでも見えるので、検索に載らないよう X-Robots-Tag: noindex を付けています。Workersに移るとURLが workers.dev に変わるので、この行を書き直します
  2. 記事を反映する仕組みのコマンド。wrangler pages deploy を wrangler deploy に替え、wrangler.jsonc を足します
  3. カスタムドメインの付け替え。Pagesのプロジェクトから外し、Workerに付け直します

3つめがいちばん怖いところです。移行のときはネームサーバーを切り替える前に、メール用のレコードを切り離す下準備が要りました。得るもののない状態で、あの作業をもう一度やる理由は今のところありません。メールの件はWordPressからAstroへの移行記事に書きました。

PagesとWorkersのどちらを選ぶか:場面別の判断

結局どちらを選ぶかは、「新しく作るのか」「サーバー側の処理が要るのか」「ドメインのDNSはどこか」の3つでほぼ決まります。

迷ったときの順番を図にすると、次のようになります。

flowchart TD
    A["Cloudflareでサイトを出したい"] --> B{"新しく作る?"}
    B -->|"はい"| C{"ドメインのDNSは<br>Cloudflare?"}
    C -->|"はい"| W["Workers<br>(Static Assets)"]
    C -->|"いいえ・移せない"| P["Pages"]
    B -->|"いいえ・Pagesで稼働中"| D{"Workersだけの機能が<br>欲しい?"}
    D -->|"はい"| M["Workersへ移行"]
    D -->|"いいえ"| K["Pagesのまま"]

Workersを選んだほうがいい場面

次のどれかに当てはまるなら、Workersから始めるか、Workersへ移る価値があります。

  • これから新しくサイトやアプリを作る(Cloudflareが勧めている側に乗っておく)
  • 定期実行・Queueの受信・メールの受信・レート制限など、Workersにしかない機能を使う
  • 既存のサイトの一部のパス(/api/ など)だけをWorkerに任せたい
  • 段階的なデプロイやログの保存(Workers Logs)で、本番の変更を慎重に出したい
  • Viteのプラグイン(Cloudflare Vite plugin)で手元の開発と本番をそろえたい

Pagesのままでいい場面

反対に、次の場面では、急いで移す理由は見当たりません。

  • Functionsを使わない静的なサイトが、問題なく動いている
  • ドメインを外部のDNSで管理していて、Cloudflareに移せない(サブドメインのCNAMEで付けている)
  • ブランチごとのプレビューを、設定なしで使い続けたい
  • 移行のためにDNSやメールの設定を触り直す余裕がない

私のブログが当てはまるのは1つめです。

AstroやNext.jsなどのフレームワークを使う場合

フレームワークを使っている場合は、静的に書き出しているか、サーバー側で描画しているかで話が変わります。

静的に書き出すだけなら、できたフォルダ(Astroなら dist)を配信するだけなので、PagesでもWorkersでも同じように出せます。私のブログのAstroもアダプターを入れていない静的な書き出しで、出し方はフォルダのアップロードだけです。

サーバー側で描画する(SSR)場合は、フレームワークごとのアダプターがPages向けかWorkers向けかを確かめます。移行ガイドでも、Pages専用のアダプターはWorkers向けのものに置き換えるよう書かれています。これから作るなら、最初からWorkers向けのアダプターを選んでおくと、あとで付け替えずに済みます。ドメインはCloudflareのネームサーバーに向けているので、2つめの理由で移れないわけではありません。

PagesからWorkersへ移行する手順

移ると決めたら、Cloudflareの移行ガイドに沿って進めます。静的なサイトなら、作業は次の6ステップです。

順番で大事なのは、Workerで動作を確かめてから、最後にドメインを付け替えることです。Pagesのプロジェクトを消すのは、本番のアクセスがすべてWorkerに移ったあとにします。

step
1
wrangler.jsoncを書く

name と compatibility_date を書き、Pagesの pages_build_output_dir を assets の directory に置き換えます。404ページを使うなら not_found_handling に "404-page" を指定します。

step
2
.assetsignoreを置く

配信するフォルダに .assetsignore を置き、node_modules・.DS_Store・.git を外します。Pagesでは自動で外れていたものです。

step
3
Functionsがあれば変換する

functions フォルダがある場合は、npx wrangler pages functions build --outdir=./dist/worker/ でWorkerの形に変換し、main に出力先(例: ./dist/worker/index.js)を指定します。ミドルウェアや _routes.json を使っていたなら、run_worker_first を true にします。

step
4
コマンドを置き換えて動作を確かめる

wrangler pages dev を wrangler dev に、wrangler pages deploy を wrangler deploy に替えます。まず workers.dev のURLで、ページ・転送・404の答え方を確かめます。

step
5
Git連携を付け替える

Git連携で出していた場合は、リポジトリをWorkers Buildsにつなぎ、Pagesのプロジェクト側の自動デプロイを止めます。両方で出し続けると、どちらが本番か分からなくなります。

step
6
カスタムドメインを移し、Pagesのプロジェクトを消す

Workerにカスタムドメインを付け、本番のアクセスがすべて移ったのを確かめてから、npx wrangler pages project delete でPagesのプロジェクトを消します。

バージョンと静的ファイルのずれに注意
Workersでは、デプロイした版ごとに静的ファイルを持ちます。段階的なデプロイを使うと、古い版のHTMLが新しい版にしかないファイルを読みに行く、といったずれが起きることがあります。リリースの手順を変える前に、移行ガイドの「Version skew and static assets」の節を読んでおきます。

よくある質問

Q1. Cloudflare PagesとWorkersは何が違いますか?

Pagesは静的サイトとPages Functionsを出す製品、Workersはエッジでスクリプトを動かす製品です。いまはWorkersでも静的ファイルを配信でき、定期実行やログの保存などWorkersにしかない機能もあります。外部DNSのサブドメインに付けられるのはPagesだけです。

Q2. 新しく作るならPagesとWorkersのどちらがいいですか?

Workersです。CloudflareはWorkersのベストプラクティスのページで、新しいプロジェクトにはPagesではなくWorkersを使うよう案内しています。新しい機能と最適化もWorkers側に集められます。

Q3. Cloudflare Pagesは終了しますか?

終了は発表されていません。Pagesは引き続き動くとされています。ただし新機能はWorkersに集中するので、Pagesに新しい機能が増えることはあまり期待できません。

Q4. PagesとWorkersの無料枠はどう違いますか?

静的ファイルの配信は、どちらも無料・無制限です。動的な処理は、Pages FunctionsもWorkersも同じ1日100,000リクエストの枠を分け合います。Cloudflare側のビルドは、Pagesが月500回、Workers Buildsが月3,000分です。

Q5. PagesからWorkersへの移行は必須ですか?

必須ではありません。Functionsを使わない静的サイトで困っていないなら、Pagesのままで問題ありません。Workersにしかない機能が欲しくなったときに、移行ガイドに沿って移せば足ります。

Q6. 外部DNSのドメインはWorkersで使えますか?

使えません。Workersのカスタムドメインは、ネームサーバーをCloudflareに向けたドメインだけが対象です。外部DNSのままなら、サブドメインにCNAMEで付けられるPagesを使います。

Q7. Pages Functionsはそのまま Workers で動きますか?

functions フォルダの書き方のままでは動きません。npx wrangler pages functions build でWorkerの形に変換し、設定ファイルの main に指定すれば動きます。新しく書くなら、Honoのようなルーターで1本のスクリプトにまとめる方法もあります。

PagesとWorkersの違いを知ったうえでの選び方(まとめ)

PagesとWorkersの違いは、静的なサイトを出すだけならほとんど表に出ません。差が出るのはサーバー側の処理・プレビュー・ドメインで、方針の面ではWorkersが先を行きます。

【要点まとめ】

  • Cloudflareは新規プロジェクトにWorkersを勧めている。Pagesは動き続けるが、新機能はWorkers側に来る
  • 静的ファイルの配信は両方とも無料・無制限。_headers と _redirects もWorkersでそのまま使える
  • 動的な処理の無料枠は、Pages FunctionsとWorkersで1日100,000リクエストを共有する
  • プレビューの手軽さと外部DNSのサブドメインは、いまもPagesが上
  • ビルドの無料枠はPagesが月500回、Workers Buildsが月3,000分。手元でビルドすれば、どちらも使わない

私のブログはPagesのまま動かしています。Workersにしかない機能が欲しくなったら、そのとき移行を考えます。最初に欲しくなるのが定期実行なのか、ログの保存なのかは、まだ分かりません。

NEXT STEP
自分のPagesのプロジェクトに functions フォルダがあるか、ドメインのネームサーバーがどこかを確かめる。

どちらも無ければ、Workersへ移すかどうかは「欲しい機能が出てきたとき」に決めれば十分です。Cloudflareで新しく作る予定があるなら、そちらはWorkersから始めてみてください。

途中経過は、また書きます。

NEXT READ本棚から1本

AIで開発を組み直すなら、まずこの5冊から

入門・実践・設計まで、Claude Codeの本をレベル別に5冊選んで比べました。

→ おすすめ5冊を見る

トム

SESで約8年、環境を変えられないもどかしさの中にいました。32歳で自社開発企業に転職し、今はClaude Codeと自動化で、仕事も時間も組み直している途中です。
・Javaバックエンドエンジニア(Java歴12年以上)
・資格:基本情報技術者/応用情報技術者/Java Silver/Python3エンジニア認定基礎
詳細なプロフィール

𝕏

AI

TOC