結論
Cloudflare Pages(クラウドフレア ページズ)とは、HTML・CSS・JavaScript などの静的なサイトやフロントエンドを、Git 連携・直接アップロード・コマンドのいずれかで Cloudflare のネットワークに公開するサービスです。公式ドキュメントは、新しく作るプロジェクトは Workers で始めるよう案内しています(2026年11月11日時点)。
この記事でわかること
- できること・デプロイ3通り・ビルド設定・独自ドメインの流れ
- _redirects と _headers の書式と、Python で検査した実行結果
- Workers との関係、制限と料金の考え方、つまずきと判断表
Cloudflare Pages は、「ファイルを置くフォルダー(出力フォルダー)の中身を、そのまま世界中から見られる URL にする」サービスです。この記事で実際に動かしたものは、自作の _redirects を1行ずつ検査する Python のスクリプトと、手元(127.0.0.1)での静的サイトの配信の2つです。Cloudflare へのログインとデプロイは行っていません。画面の手順・制限・料金は、Cloudflare の公式ドキュメント(developers.cloudflare.com)だけで確かめています。
flowchart TD
A[リポジトリ / 手元のフォルダー] --> B{デプロイの方法}
B -->|Git 連携| C[Cloudflare 側でビルド]
B -->|直接アップロード| D[ビルド済みを送る]
C --> E[出力フォルダーの中身]
D --> E
E --> F[本番の URL]
E --> G[プレビューの URL]
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| Cloudflare Pages とは | 静的サイトとフロントエンドを Cloudflare のネットワークに公開するサービス | Cloudflare Pagesとは |
| Cloudflare Pages の使い方 | Git 連携・直接アップロード・C3(コマンド)の3通りから選ぶ | デプロイの3つの方法 |
| ビルドの設定 | ビルドコマンドと出力フォルダーの2つが中心。ビルドが要らなければ exit 0 |
ビルドの設定 |
| プレビュー | 本番以外のブランチとプルリクエストごとに、別の URL が作られる | プレビューとロールバック |
| 独自ドメイン | apex はネームサーバーを Cloudflare へ。サブドメインは CNAME でも可 | 独自ドメインの設定 |
| _redirects の書き方 | 1行に「元 先 ステータス」。省略すると 302。上にある行が先に当たる | _redirectsの書き方 |
| Workers との違い・関係 | 公式は Workers を主な土台とし、新規は Workers で始めるよう案内 | Workersとの関係 |
| 料金・無料の範囲 | 静的ファイルへのリクエストは無料・無制限。上限はビルド回数やファイル数 | 制限と料金の考え方 |
| うまく公開できない | 出力フォルダーの指定・522・ビルド失敗などを症状から引く | よくあるつまずき |
確認環境:Ubuntu 24.04.5 LTS、Python 3.13.18、curl 8.5.0。自作の見本サイト(原稿2本・_redirects・_headers・CSS)を Python の小さなビルドで出力フォルダーに書き出し、python3 -m http.server を 127.0.0.1 だけで起動して curl で応答を確かめました。_redirects は自作の Python スクリプトで1行ずつ読み、公式の書式と上限に合うかを検査しました。Cloudflare のアカウント作成・ログイン・デプロイは行っていません。ダッシュボードの手順、制限の数字、Workers の案内は、公式ドキュメントの記載で確かめた範囲です(確認日 2026年11月11日)。手元の http.server は Cloudflare Pages の配信そのものではないため、違いは本文でその都度示します。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Cloudflare Pagesとは|使い方・デプロイ3通りとWorkersとの関係」
Cloudflare Pagesとは(意味・できること)
この節では、Cloudflare Pages が何をするサービスで、どんな機能があるのかが分かります。
Cloudflare Pages は、ビルドして出来上がったファイル一式を Cloudflare のネットワークに置き、URL で配信するサービスです。 公式ドキュメントの冒頭は、Pages を「Cloudflare のグローバルネットワークに即座にデプロイされるフルスタックのアプリケーションを作る」ものと説明しています。静的なファイルの配信が土台で、サーバー側の処理が要るときは Pages Functions を足します。
「デプロイ」は、作ったものを利用者が使える場所に置くことです。言葉の整理は、関連記事「デプロイとは|ビルド・リリースとの違いとロールバックを実例で解説」で扱っています。
1静的サイトの配信
出力フォルダーの中の HTML・CSS・JavaScript・画像を配信する。プロジェクトごとに *.pages.dev のアドレスが付く。
2Git 連携の自動ビルド
GitHub か GitLab のリポジトリとつなぐと、push のたびに Cloudflare 側でビルドして公開する。
3プレビュー
本番以外のブランチやプルリクエストごとに、確認用の URL が作られる。
4ロールバック
前の本番デプロイへ、すぐに戻せる。
5リダイレクトとヘッダー
_redirects と _headers という2つのテキストファイルで設定する。
6Pages Functions
functions フォルダーにコードを置くと、専用のサーバーを動かさずにサーバー側の処理を足せる。
言葉の整理:Pages・Workers・pages.dev
| 言葉 | 意味 |
|---|---|
| Cloudflare Pages | 静的サイト・フロントエンドを公開するサービス。この記事の題材 |
| Cloudflare Workers | Cloudflare のネットワークでコードを動かすサーバーレスの実行環境。静的ファイルも一緒に配信できる |
| Pages Functions | Pages のプロジェクトにサーバー側の処理を足す仕組み。リクエストは Workers のリクエストとして数えられる |
*.pages.dev |
Pages のプロジェクトに付く既定のアドレス。プロジェクト名がホスト名の一部になる |
| Wrangler・C3 | Wrangler は Cloudflare のコマンドラインツール。C3 はプロジェクトのひな形を作るコマンド |
| 出力フォルダー | ビルドの結果が入るフォルダー。公式の表記は build directory(build output directory) |
Cloudflare Pagesの使い方:デプロイの3つの方法
この節では、Cloudflare Pages にサイトを載せる3つの方法と、Git 連携の手順が分かります。
公式の「Get started」は、C3(コマンド)・Direct Upload(直接アップロード)・Git integration(Git 連携)の3つを入口として並べています。 どれを選ぶかで、ビルドをどこで行うかが変わります。
| 方法 | ビルドする場所 | 向いている場面 |
|---|---|---|
| Git 連携(GitHub・GitLab) | Cloudflare 側 | push のたびに自動で公開したい。プルリクエストごとにプレビューを見たい |
| 直接アップロード(Wrangler) | 手元か自前の CI | GitHub・GitLab 以外で管理している。ビルドを自分の CI で行いたい |
| 直接アップロード(ドラッグ&ドロップ) | 手元 | ビルド済みのフォルダーや zip を、ダッシュボードからそのまま載せたい |
| C3(コマンド) | 手元でひな形を作る | フレームワークの新しいプロジェクトを、コマンドから作り始めたい |
最初に決めておくこと
切り替えたいときは、新しいプロジェクトを作り直す
Git連携でデプロイする流れ(公式の手順)
公式の手順を、表示される名前のまま順に並べます。対応している Git のサービスは GitHub と GitLab です。
「Workers & Pages」を開く
Cloudflare のダッシュボードで「Workers & Pages」へ進み、「Create application」→「Pages」→「Connect to Git」を選ぶ。
GitHub か GitLab とつなぐ
サービスを選んで認証し、リポジトリを選ぶ。「Install & Authorize」のあと「Begin setup」へ進む。GitLab は、リポジトリでの役割が Maintainer 以上であることが条件。
プロジェクト名と本番ブランチを決める
「Project name」はホスト名の一部になる。「Production branch」は、ブランチを1つ以上 push してあると選べる。
ビルドの設定を入れる
「Framework preset」を選ぶと既定の値が入る。「Build command」と出力フォルダーの欄を確かめ、リポジトリの直下にプロジェクトが無いときは「Root directory (advanced)」の「Path」を入れる。
環境変数を足して公開する
必要なら「Environment variables (optional)」に値を足し、「Save and Deploy」を選ぶ。終わったら「Continue to project」でプロジェクトの画面へ進む。
直接アップロード(Wrangler・ドラッグ&ドロップ)
直接アップロードは、ビルド済みのフォルダーを送る方法です。公式に載っているコマンドは次の形です。
npx wrangler pages project create
npx wrangler pages deploy <BUILD_OUTPUT_DIRECTORY>
npx wrangler pages deploy <BUILD_OUTPUT_DIRECTORY> --branch=<BRANCH_NAME>
| 項目 | Wrangler | ドラッグ&ドロップ |
|---|---|---|
| 送れるもの | フォルダー1つ(zip は不可) | zip か、フォルダー1つ |
| ファイル数の上限 | 20,000 | 1,000 |
| 1ファイルの大きさ | 25 MiB | 25 MiB |
functions フォルダー |
コマンドを実行した場所にあれば一緒に送られる | コンパイルされない(Wrangler を使う) |
| 本番かプレビューか | --branch を付けなければ本番、付ければプレビュー |
「Create a new deployment」で選ぶ |
ドラッグ&ドロップは、ダッシュボードの「Workers & Pages」→「Create application」→「Get started」→「Drag and drop your files」から進み、プロジェクト名を入れてファイルを置き、「Deploy site」を選ぶ流れです(公式の記載)。この記事では、ログインが要るためコマンドも画面も実行していません。
ビルドの設定:ビルドコマンド・出力フォルダー・環境変数
この節では、Git 連携で入力するビルドの設定の意味と、出力フォルダーの考え方が手元の配信で分かります。
設定の中心は「ビルドコマンド」と「出力フォルダー」の2つです。 ビルドコマンドはフレームワークが用意しているコマンドで、終了コードが 0 以外だと Pages はビルドを失敗として扱います。出力フォルダーは、ビルドコマンドが出来上がったサイトを書き出す場所です。
| フレームワーク(公式のプリセット) | ビルドコマンド | 出力フォルダー |
|---|---|---|
| React(Vite) | npm run build |
dist |
| Vue | npm run build |
dist |
| Astro | npm run build |
dist |
| Next.js(Static HTML Export) | npx next build |
out |
| Docusaurus | npm run build |
build |
| VitePress | npx vitepress build |
.vitepress/dist |
| Hugo | hugo |
public |
| Jekyll | jekyll build |
_site |
| ビルドなし(HTML だけ) | exit 0 |
HTML を置いた場所 |
ビルドが要らないサイトについて、公式は「プリセットを使わないなら、ビルドコマンドに exit 0 を使う」と案内しています。何もせずに成功で終わるコマンドです。リポジトリの中に複数のプロジェクトがある構成(モノレポ)では、ルートディレクトリの指定が必要です。
環境変数:Pages が入れる値と、版の固定
| 変数 | 入る値 | 使いどころ(公式の例) |
|---|---|---|
CI |
true |
CI の上と手元とで動きを変える |
CF_PAGES |
1 |
Pages の上と手元とで動きを変える |
CF_PAGES_COMMIT_SHA |
コミットの SHA-1 | エラーの集計ツールにコミットを伝える |
CF_PAGES_BRANCH |
デプロイ中のブランチ名 | ブランチごとにビルドを変える |
CF_PAGES_URL |
デプロイ先の URL | ビルドのツールに公開先を伝える |
ビルドに使う言語やツールの版は、ビルドイメージの既定値で決まります。公式は、NODE_VERSION・PYTHON_VERSION・RUBY_VERSION・GO_VERSION・HUGO_VERSION などの環境変数か、プロジェクト直下の .nvmrc・.node-version・.python-version・.ruby-version などのファイルで既定の版を上書きできると説明しています。手元と同じ版に固定しておくと、「手元では通るのに Pages では失敗する」という食い違いを減らせます。
出力フォルダーの考え方を手元の配信で確かめる
出力フォルダーを取り違えると、ビルドは成功しているのにページが出ません。小さな見本で確かめます。
site/
├── build.py ← ビルドの処理(公開しない)
├── src/ ← 原稿(公開しない)
│ ├── index.md
│ └── about.md
├── static/ ← そのまま公開するファイル
│ ├── _redirects
│ ├── _headers
│ └── style.css
└── dist/ ← ビルドの出力フォルダー(ここだけを公開する)
ビルドを実行すると、dist に公開するファイルだけが出来ます。
$ python3 build.py
built dist/about.html
built dist/index.html
$ find dist -type f | sort
dist/_headers
dist/_redirects
dist/about.html
dist/index.html
dist/style.css
出力フォルダー(dist)を公開した場合は、トップページが出て、原稿やビルドの処理は外から見えません。
$ python3 -m http.server 18396 --bind 127.0.0.1 --directory site/dist
(別の端末で、パスごとにステータス・種類・大きさを表示)
/ 200 text/html 155B
/about.html 200 text/html 185B
/about 404 text/html;charset=utf-8 335B
/style.css 200 text/css 29B
/_redirects 200 application/octet-stream 345B
/src/index.md 404 text/html;charset=utf-8 335B
/build.py 404 text/html;charset=utf-8 335B
/nothing 404 text/html;charset=utf-8 335B
出力フォルダーの指定を誤り、プロジェクトの直下を公開した場合は、結果が逆になりました。
$ python3 -m http.server 18397 --bind 127.0.0.1 --directory site
/ 200 text/html; charset=utf-8 335B ← 「Directory listing for /」
/about.html 404 text/html;charset=utf-8 335B
/dist/about.html 200 text/html 185B
/src/index.md 200 text/markdown 37B
/build.py 200 text/x-python 743B
dist を公開(正しい指定)
/ と /about.html が 200
/src/index.md と /build.py は 404
公開されるのは 5 ファイルだけ
直下を公開(誤った指定)
/ はファイルの一覧、/about.html は 404
原稿(/src/index.md)と build.py が 200 で読める
ページは /dist/about.html に下がっている
この実験は Python の http.server での結果です。Cloudflare Pages の配信は次の点が違うと、公式は説明しています。
- 拡張子の扱い:
/contact.htmlは/contactへ、/about/index.htmlは/about/へリダイレクトされます。手元の http.server では/aboutは 404 でした。 - 404 の扱い:
404.htmlがあれば、近い階層から順に上へ探して使います。いちばん上に404.htmlが無いと、Pages はシングルページアプリケーションと見なし、ファイルに当たらないパスにはトップ(/)を返します。 _redirectsと_headers:Pages はこの2つを設定として読み、ファイルとしては配信しません。手元の http.server は/_redirectsを 200(345 バイト)で返しました。
プレビューデプロイとロールバック
この節では、本番に出す前の確認用 URL の仕組みと、前の版に戻す方法が分かります。
プレビューデプロイは、本番に反映せずに新しい版を確かめるための仕組みです。 Git 連携では、本番ブランチ以外のブランチへの push と、リポジトリ自身から出したプルリクエストごとに作られます。
| 項目 | 公式の説明 |
|---|---|
| デプロイごとの URL | ハッシュ付きのアドレス(<hash>.<project>.pages.dev)が付き、あとからも開ける |
| ブランチの別名 | ブランチ名のアドレスが、そのブランチの最新のコミットを指す |
| ブランチ名の変換 | 小文字にし、英数字以外はハイフンに置き換える(fix/api → fix-api) |
| 公開の範囲 | 既定では、プレビューの URL は公開されている |
| 見られる人を絞る | プロジェクトの「Settings」→「General」の「Enable access policy」で Cloudflare Access を有効にする |
| 検索エンジン | プレビューの応答には X-Robots-Tag: noindex が付く |
| 数 | 同時に有効にできるプレビューの数に上限はない |
フォークしたリポジトリからのコミットやプルリクエストでは、プレビューは作られません(公式の「Known issues」)。
ロールバック(前の本番に戻す)
ロールバックは、前の本番デプロイへすぐに戻す機能です。プロジェクトの「Deployments」を開き、「All deployments」の一覧から戻したいデプロイのメニューで「Rollback to this deployment」を選びます。戻せるのは、ビルドに成功した本番デプロイだけで、プレビューデプロイは対象になりません。戻したあとで、より新しいデプロイへ進め直すこともできます。
独自ドメインの設定(apexとサブドメインの違い)
この節では、自分のドメインを Cloudflare Pages に付ける手順と、ドメインの種類で変わる条件が分かります。
入口は同じで、プロジェクトの「Custom domains」から「Set up a domain」を選び、ドメインを入れて「Continue」へ進みます。 そのあとの条件が、apex(example.com のような先頭に何も付かないドメイン)とサブドメインとで違います。
| 種類 | 条件 | DNS の設定 |
|---|---|---|
| apex(example.com) | ドメインが Cloudflare のゾーンであること。ネームサーバーを Cloudflare に向ける | Cloudflare が CNAME レコードを作る |
| サブドメイン(shop.example.com) | Cloudflare のゾーンでなくてもよい | 使っている DNS で、<プロジェクト>.pages.dev を指す CNAME を足す |
- 1先にダッシュボードでドメインを足すCNAME だけを先に作ると名前が解決されず、見た人には 522 が出る(公式の注意)
- 2apex かサブドメインかで DNS を整えるapex はネームサーバーの変更、サブドメインは CNAME
- 3CAA レコードを確かめる発行元を絞る CAA があると証明書が発行できず、設定が失敗することがある
- 4pages.dev のアドレスの扱いを決める本番の pages.dev を独自ドメインへ送るには、アカウント単位の Bulk Redirects を使う
外すときは、DNS のレコードから Pages 向けの CNAME を消し、プロジェクトの「Custom domains」でドメインの横のメニューから「Remove domain」を選びます。CNAME や CAA などのレコードの役割は、関連記事「DNSレコードの種類一覧|digの実出力で役割と設定ミスを確認」で扱っています。
公式の「Known issues」には、ワイルドカードのドメイン(*.domain.com)は足せない、すでに Worker のルートがあるドメインは足せない、といった条件も載っています。
_redirectsの書き方と「上から順に当たる」ことの確認
この節では、リダイレクトを設定する _redirects の書式と、自作の見本を Python で検査した結果が分かります。
_redirects は、拡張子の無いテキストファイルで、出力フォルダーの直下に置きます。1行に1つ、「元のパス 先 ステータス」の順に空白で区切って書きます。
| 決まり(公式) | 内容 |
|---|---|
| 書式 | [source] [destination] [code?]。合わない行は無視される |
| ステータス | 省略すると 302。使えるのは 301・302・303・307・308 |
| コメント | # で始まる行 |
| スプラット | * は残りの文字すべてに当たる。1つの URL に1つだけ。先では :splat で使う |
| プレースホルダー | :name(英数字とアンダースコア)。同じ名前は1回だけ。パスでは / の手前まで当たる |
| 200(プロキシ) | URL を変えずに別のパスの中身を返す。先は自分のサイトの相対パスだけ |
| 上限 | 静的 2,000 件・動的 100 件の合計 2,100 件。1行 1,000 字まで |
| 順番 | 同じ元のパスが複数あれば、いちばん上が使われる。静的を動的より先に書く |
| 対象外 | クエリーでの出し分け、ドメイン単位、国や言語、Cookie による出し分け、404 などへの書き換え |
スプラットやプレースホルダーを含む行を「動的」、含まない行を「静的」と呼びます。自作の見本は次のとおりです。
# 自作の見本(書式は Cloudflare Pages の公式ドキュメントの範囲)
/home /
/blog/old-post /blog/new-post 301
/news/* /blog/:splat 301
/products/:id /items/:id
/blog/* /archive/:splat 302
/docs https://example.com/docs 308
/app/* /app/index.html 200
Pythonで1行ずつ読み、書式に合うか確かめる
各行を空白で区切り、欄の数・元と先の始まり方・ステータス・スプラットの数・プレースホルダーの重なりを調べるスクリプトを書いて、見本に当てました。うしろに並べたパスは、「どの行に当たるか」を試す入力です。
$ python3 check_redirects.py dist/_redirects /home /blog/old-post /blog/2026/11 \
/news/2026/11 /products/42 /products/42/spec /docs /app/settings/profile /about
2行目 OK /home -> / [302] … 静的
3行目 OK /blog/old-post -> /blog/new-post [301] … 静的
4行目 OK /news/* -> /blog/:splat [301] … 動的
5行目 OK /products/:id -> /items/:id [302] … 動的
6行目 OK /blog/* -> /archive/:splat [302] … 動的
7行目 OK /docs -> https://example.com/docs [308] … 静的
8行目 OK /app/* -> /app/index.html [200] … 動的
静的 3 件(上限 2,000)/動的 4 件(上限 100)/合計 7 件(上限 2,100)
注意:7行目の静的なルールが、4行目の動的なルールより下にある
/home -> 2行目 302 /
/blog/old-post -> 3行目 301 /blog/new-post
/blog/2026/11 -> 6行目 302 /archive/2026/11
/news/2026/11 -> 4行目 301 /blog/2026/11
/products/42 -> 5行目 302 /items/42
/products/42/spec -> 当たるルールなし(ファイルを探す)
/docs -> 7行目 308 https://example.com/docs
/app/settings/profile -> 8行目 200 /app/index.html
/about -> 当たるルールなし(ファイルを探す)
7行すべてが書式に合い、4行目の /products/:id はステータスを省いたので 302 になりました。/products/42/spec が当たらないのは、プレースホルダーが / をまたがないためです。検査は1つ注意を出しています。7行目の静的なルール(/docs)が、動的なルールより下にあります。 公式の「静的を先に」に合わせるなら、7行目を3行目の下へ移します。
当たる行を決める部分は、次の20行ほどです。上から順に試し、最初に当たった行で決めています。
import re
CODES = {301, 302, 303, 307, 308, 200}
def to_regex(src):
out = ""
for tok in re.split(r"(\*|:[A-Za-z0-9_]+)", src):
if tok == "*":
out += "(?P<splat>.*)" # スプラットは残り全部に当たる
elif tok.startswith(":"):
out += f"(?P<{tok[1:]}>[^/]+)" # プレースホルダーは / の手前まで
else:
out += re.escape(tok)
return re.compile("^" + out + "$")
def match(rules, path):
for no, src, dst, code, kind in rules: # 上から順に試し、最初に当たった行で決まる
m = to_regex(src).match(path)
if m:
for k, v in m.groupdict().items():
dst = dst.replace(":" + k, v)
return no, code, dst
return None
この関数は、公式の「同じ元のパスが複数あれば、いちばん上が使われる」「スプラットは残りすべてに当たる」という説明をもとに作った手元の模型です。Cloudflare の中の処理そのものではないので、公開前の確認にはプレビューデプロイを使います。
順番を入れ替えると結果が変わる
同じ2行を、順番だけ変えて /blog/old-post を試しました。
(動的なルールを上に書いた場合)
/blog/* /archive/:splat 302
/blog/old-post /blog/new-post 301
注意:2行目の静的なルールが、1行目の動的なルールより下にある
/blog/old-post -> 1行目 302 /archive/old-post
(静的なルールを上に書いた場合)
/blog/old-post /blog/new-post 301
/blog/* /archive/:splat 302
/blog/old-post -> 1行目 301 /blog/new-post
動的なルールが上にあると、/blog/old-post は個別の行まで届かず、/archive/old-post へ 302 で送られました。個別の行を上に置くと、ねらいどおり /blog/new-post へ 301 です。「細かい行を上、広い行を下」が基本です。
書式に合わない行の例
わざと誤りを入れた8行を同じスクリプトに通しました。
1行目 OK /old -> /new [301] … 静的
2行目 NG /gone /404.html 404 … ステータス 404 は対象外
3行目 NG /onlyone … 欄が1個(2〜3個のはず)
4行目 NG /a/*/b/* /c 301 … スプラット(*)が2つある
5行目 NG /users/:id/:id /u/:id … 同じ名前のプレースホルダーが2回ある
6行目 NG /api/* https://example.com/:splat 200 … 200(プロキシ)の先が相対パスでない
7行目 NG old.html /new.html … 元が / で始まらない
8行目 NG /a /b 301 extra … 欄が4個(2〜3個のはず)
無いページを 404 にしたい
/gone /404.html 404 と書く(301〜308 と 200 以外は対象外)404.html を置く。Pages が見つからないパスに使う404.html が無いと、SPA と見なされてトップが返る
外部の API を同じ URL で見せたい
/api/* https://example.com/:splat 200 と書く(200 の先は相対パスだけ)Functions が応える URL には _redirects は効かない
もう1つ大事な決まりがあります。_redirects は、Pages Functions が応えるリクエストには適用されません。 リダイレクトはファイルの有無に関係なく先に効き、ヘッダーのルールよりも先に処理されます。2,100 件を超えるときは Bulk Redirects が案内されています。Apache で同じことをする書き方は、関連記事「.htaccessの書き方|リダイレクト・https化・アクセス制限のコピペ集」で扱っています。
_headersの書き方と、Pagesが既定で付けるヘッダー
この節では、応答のヘッダーを足す _headers の書式と、何もしなくても付くヘッダーが分かります。
_headers も拡張子の無いテキストファイルで、出力フォルダーの直下に置きます。URL のパターンを1行書き、その下に字下げして「名前: 値」を並べます。
# 自作の見本
/*
X-Frame-Options: DENY
/assets/*
Cache-Control: public, max-age=31556952, immutable
https://:project.pages.dev/*
X-Robots-Tag: noindex
この見本は、すべての URL に X-Frame-Options を付け、/assets/ の下を長くキャッシュさせ、pages.dev のアドレスで開かれたときに検索エンジンへ「登録しない」と伝えます。最後の2つは公式の例と同じ形です。max-age=31556952 は、86,400 で割ると 365.2425 日、つまり1年です。
| 決まり(公式) | 内容 |
|---|---|
| 上限 | ルールは 100 個まで。1行は 2,000 字まで |
| 複数のルールに当たる | 当たったルールのヘッダーをすべて受け継ぐ |
| 同じヘッダーが2回 | 値がカンマでつながる |
| ヘッダーを外す | 名前の前に ! と空白を置く(例:! Content-Security-Policy) |
| 絶対 URL | https で始める。ポートの指定はできない |
| スプラット・プレースホルダー | _redirects と同じ。値の中で :splat・:name として使える |
| Functions との関係 | Pages Functions が作った応答には適用されない(コードの中で付ける) |
何もしなくても付くヘッダー
公式の「Serving Pages」によると、Pages は次のヘッダーを付けます。
| ヘッダー | 値 | 付く場面 |
|---|---|---|
Access-Control-Allow-Origin |
* |
いつも |
Referrer-Policy |
strict-origin-when-cross-origin |
いつも |
X-Content-Type-Options |
nosniff |
いつも |
Cache-Control |
public, max-age=0, must-revalidate |
キャッシュできるファイル |
X-Robots-Tag |
noindex |
プレビューの URL で開いたとき |
Etag |
ファイルごとの値 | 200 の応答。If-None-Match が合えば 304 を返す |
公式は、サイトの側で独自のキャッシュを組むことは避けるよう勧めています。圧縮(gzip・Brotli)もできる範囲で自動で行われます。
Pages Functionsとは(サーバー側の処理を足す)
この節では、静的なサイトにフォームの受け取りや API のような処理を足す Pages Functions の仕組みが分かります。
Pages Functions は、プロジェクトの functions フォルダーに置いたファイルが、そのまま URL に対応する仕組みです。 公式は「専用のサーバーを動かさずに、サーバー側のコードで動的な機能を足す」ものと説明しています。
| ファイル | 対応する URL |
|---|---|
functions/index.js |
/ |
functions/fruits/apple.js |
/fruits/apple |
functions/users/[user].js |
/users/nevi(1区切りだけ。/users/nevi/foobar には当たらない) |
functions/users/[[catchall]].js |
/users/daniel/xyz/123(何区切りでも) |
公式の最小の例は次の形です。URL の一部が context.params に入ります。
// functions/users/[user].js → /users/daniel で呼ばれる
export function onRequest(context) {
return new Response(context.params.user);
}
_routes.json:Functions を呼ぶ範囲を絞る
Functions を足すと、既定ではリクエストが Functions を通ります。_routes.json を出力フォルダーに置くと、Functions を呼ぶパスを決められます。
{
"version": 1,
"include": ["/api/*"],
"exclude": ["/api/health"]
}
includeは1つ以上必要で、excludeがincludeより優先されます。includeとexcludeは合わせて 100 個まで、1つのルールは 100 字までです。- 除外した静的なパスは、Functions の呼び出しとして数えられません。
D1(データベース)・KV・R2 などとつなぐ「バインディング」も使えます。ここから先は Workers の機能と重なるので、次の節で関係を整理します。
Cloudflare PagesとWorkersの関係(公式の案内)
この節では、Pages と Workers のどちらで始めるかについて、Cloudflare の公式ドキュメントがいま何と案内しているかが分かります。
2026年11月11日時点で、Pages の公式ドキュメントには次の趣旨の案内が載っています。「Workers は Pages の使い道のほとんどに対応し、より広い機能を備えている。Workers は、アプリケーションを作るための Cloudflare の主な土台である。新しいプロジェクトは Workers で始める」。 「Get started」のページにも、同じ案内が「本当に Pages を使いますか」という見出しで置かれています。
Workers の側には、静的なファイルを Worker と一緒に配信する「Static Assets」という機能があります。設定ファイルに、配信するフォルダーを書きます。
"assets": {
"directory": "./dist",
"binding": "ASSETS"
}
この directory が、Pages の出力フォルダーに当たります。見つからないパスの扱いは not_found_handling で選び、"single-page-application" は index.html を 200 で返し、"404-page" は近い 404.html を 404 で返します。
移行の案内と、機能の対応
公式には「Pages から Workers への移行」のガイドがあり、「多くの場合、移行は分かりやすい作業」と説明されています。ガイドの見出しは、フレームワーク、プロジェクトの設定、変数とバインディング、Wrangler のコマンド、ビルド、プレビュー環境、ヘッダーとリダイレクト、pages.dev、独自ドメイン、の順です。機能の対応表は次のように整理されています。
| 区分 | 機能(公式の対応表より) |
|---|---|
| 両方で使える | ロールバック、プレビューの URL、手元での開発、リダイレクト、独自のヘッダー、D1・KV・R2 などのバインディング |
| Workers だけ | Cloudflare の Vite プラグイン、段階的なデプロイ、Workers Logs、Logpush、Cron Triggers、キューの受け手、ルート以外へのルーティングなど |
| Pages だけ | Cloudflare のゾーンの外にある独自ドメイン |
| 一部だけ対応 | Workers 側:Early Hints、ブランチごとのデプロイの制御、ファイルの配置によるルーティング、Pages のプラグイン |
- 1新しく作るなら、まず Workers を検討する公式の案内は「新しいプロジェクトは Workers で始める」
- 2ドメインの DNS を Cloudflare に移せないなら、Pages が合うゾーンの外の独自ドメインは、対応表で Pages だけの項目
- 3動いている Pages のサイトは、急いで動かす理由があるかを見る確かめた範囲の公式ページに、Pages の提供終了の告知は載っていなかった
- 4移すときは _redirects と _headers の動きをプレビューで確かめる移行ガイドに「ヘッダーとリダイレクト」の節がある
3つ目は「この記事で確かめたページに載っていなかった」という事実で、今後の方針を保証するものではありません。判断の前に、公式の最新の案内を確かめることを勧めます。
Cloudflare Pagesの制限と料金の考え方
この節では、公式の「Limits」に載っている上限と、費用がどこで決まるかの考え方が分かります。
公式は「静的なファイルへのリクエストは、無料プランでも有料プランでも無料で無制限」と説明しています。上限があるのは、ビルドの回数・ファイルの数・Functions のリクエストなどです。 次の表は 2026年11月11日時点の公式の記載です。プランの月額はこの記事では確かめていないため載せていません。
| 項目 | Free | Pro | Business |
|---|---|---|---|
| 1か月のビルド回数 | 500 | 5,000 | 20,000 |
| 同時に走るビルド | 1 | 5 | 20 |
| 独自ドメイン(1プロジェクト) | 100 | 250 | 500 |
| ファイル数(1サイト) | 20,000 | 100,000 | 100,000 |
| プランによらない項目 | 上限(公式) |
|---|---|
| 1ファイルの大きさ | 25 MiB |
| ビルドの時間 | 20 分で打ち切り |
| プロジェクトの数 | 1アカウントに 100(Workers のプロジェクト数とは別に数える) |
| プレビューデプロイ | 同時に有効な数に上限なし |
_redirects |
静的 2,000 件+動的 100 件 |
_headers |
ルール 100 個、1行 2,000 字 |
| ダッシュボードで管理できる人数 | 上限なし |
有料プランで 100,000 ファイルを使うには、プロジェクトの設定に PAGES_WRANGLER_MAJOR_VERSION=4 を入れると書かれています。同時に走るビルドは、アカウント単位で数えます。
Functions のリクエストは Workers の枠で数える
Pages Functions へのリクエストは、Cloudflare Workers のリクエストとして数えられます。無料プランでは Workers と合わせて1日 100,000 リクエストで、公式は「Functions で 50,000、Workers で 50,000 を使うと、1日の枠を使い切る」と例を挙げています。枠は UTC の 0 時に戻ります。
数字を自分の使い方に当てはめる
上限の数字は、1日あたりに直すと見当が付きます。Python で割り算をしました。
月 500 回 ÷ 30 日 = 16.7 回/日 月 500 回 ÷ 22 日 = 22.7 回/日
月 5,000 回 ÷ 30 日 = 166.7 回/日 月 20,000 回 ÷ 30 日 = 666.7 回/日
1日 100,000 リクエスト ÷ 86,400 秒 = 平均 1.157 回/秒
見本の dist:5 ファイル ÷ 20,000 = 0.025% 最大のファイル 345 B(上限 25 MiB = 26,214,400 B)
max-age=31556952 秒 ÷ 86,400 = 365.2425 日
- ビルド 500 回/月は、毎日使うなら1日 16.7 回、月に 22 日使うなら1日 22.7 回です。ブランチへの push のたびにプレビューのビルドが走る点を見込んでおきます。
- Functions の1日 100,000 リクエストは、ならすと1秒に約 1.16 回です。静的なファイルだけのページはこの枠を使いません。
- ファイル数は、見本のサイトで 5 個(上限の 0.025%)でした。数が増えるのは、記事の多いブログや、画像を細かく分けたサイトです。出力フォルダーで
find dist -type f | wc -lを実行すると数えられます。
利用の条件(仕事での利用を含む)は、提供元の規約で決まります。使う前に、Cloudflare の最新の規約と料金のページを確かめることを勧めます。
Cloudflare Pagesでよくあるつまずき(症状→原因→直し方)
この節では、公開までに出会いやすい症状と、公式ドキュメントに載っている原因・直し方が分かります。
| 症状 | 原因 | 直し方 |
|---|---|---|
| ビルドは成功したのにページが出ない | 出力フォルダーの指定が、実際の出力先と違う | 手元でビルドし、index.html があるフォルダーの名前を設定に入れる |
| ビルドが失敗する | ビルドコマンドが 0 以外で終わった。ツールの版が手元と違う | ログで失敗した行を見る。NODE_VERSION や .nvmrc で版を固定する |
| HTML だけなのにビルドコマンドを求められる | ビルドが要らない構成 | ビルドコマンドを空にするか、exit 0 を入れる |
| 「Production branch」が選べない | ブランチをまだ push していない | 1つ以上のブランチを push してから設定する |
| 独自ドメインで 522 が出る | ダッシュボードでドメインを足す前に、CNAME だけを作った | 「Custom domains」でドメインを足してから CNAME を設定する |
| 独自ドメインの確認が終わらない | CAA レコードが発行元を絞っている。/.well-known/acme-challenge/* への確認が遮られている |
CAA に Cloudflare が使う発行元を足す。そのパスを通す |
Error 1000: DNS points to prohibited IP |
Cloudflare のロードバランサーの先に *.pages.dev を置いた |
公式の「Known issues」の手順(ホストヘッダーの追加)を確かめる |
| プログラムから取得すると 403(エラー 1010) | Pages では Browser Integrity Check が常に有効で、ライブラリ既定の User-Agent が断られる | 内容の分かる User-Agent を送る |
| 無い URL でもトップが 200 で返る | いちばん上に 404.html が無く、SPA と見なされている |
出力フォルダーの直下に 404.html を置く |
_redirects が効かない |
書式に合わない行は無視される。Functions が応える URL には適用されない | 1行ずつ書式を確かめる。Functions の中で書くか _routes.json で外す |
| ドラッグ&ドロップで Functions が動かない | ダッシュボードからのアップロードは functions をコンパイルしない |
Wrangler でデプロイする |
pages.dev の名前を変えたい |
*.pages.dev のサブドメインは変更できない |
プロジェクトを消して、新しい名前で作り直す |
| プロジェクトが消せない | デプロイが 100 を超えると削除に失敗することがある | wrangler pages deployment delete でデプロイを先に消す |
公式には、GitHub と GitLab 以外では自動ビルドに対応していない(直接アップロードを使う)、増分ビルドには対応していない、といった点も「Known issues」として載っています。
ほかの方法との位置づけ(判断表)
この節では、静的サイトを公開するほかの方法と Cloudflare Pages を、どんな条件で選び分けるかが分かります。
優劣ではなく、「コードとドメインがいまどこにあるか」「サーバー側の処理が要るか」で決まります。 ほかのサービスの料金や上限は、それぞれの公式ページで確かめます。
| 方法 | 合う条件 | 先に確かめること |
|---|---|---|
| Cloudflare Pages | GitHub・GitLab から自動で公開したい。ドメインの DNS を Cloudflare に移さずサブドメインで使いたい | ビルド回数とファイル数の上限。Workers の案内 |
| Cloudflare Workers(Static Assets) | 新しく作る。ログ・定期実行・キューなど Workers だけの機能を使う見込みがある | ドメインが Cloudflare のゾーンにあるか |
| GitHub Pages | コードが GitHub にあり、リポジトリの設定だけで公開したい | 公開の方法とビルドの流れ(関連記事を参照) |
| AWS Amplify・S3 の静的ホスティング | ほかの仕組みが AWS にあり、権限や請求を AWS にまとめたい | AWS の公式の料金と、アクセス権の設定 |
| 自前の配信(nginx など) | サーバーの設定を細かく自分で決めたい。社内のネットワークだけで見せたい | 証明書の更新・OS の更新を続ける体制 |
GitHub Pages の公開の方法は、関連記事「GitHub Pagesとは|使い方・公開3通り・独自ドメインと404の直し方」で扱っています。S3 に静的サイトを置く手順は、関連記事「S3静的ウェブサイトホスティングをAWS CLIで設定|403・404の原因」で、Git 連携で公開する別のサービスの例は、関連記事「Netlifyとは|使い方・料金・デプロイ方法とエラー対処を実例で」で扱っています。
- 1コードはどこにあるかGitHub・GitLab なら Git 連携。それ以外は直接アップロードか、自前の CI から Wrangler
- 2ドメインの DNS を Cloudflare に移せるか移せないなら、サブドメインを CNAME で向けられる Pages が合う
- 3サーバー側の処理は要るか少しなら Pages Functions。定期実行やキューまで使うなら Workers
- 4ビルドの回数とファイルの数は上限に収まるか1日あたりに直して見積もる
- 5すでに動いている基盤があるかAWS や自前のサーバーにまとまっているなら、同じ場所に置く方が運用をそろえやすい
Cloudflare Pagesのよくある質問
この節では、Cloudflare Pages について検索されることの多い疑問の答えが分かります。
Q. Cloudflare Pages とは何ですか。
A. 静的なサイトやフロントエンドを、Cloudflare のネットワークに公開するサービスです。Git 連携・直接アップロード・C3 のいずれかで始め、出力フォルダーの中身が *.pages.dev や独自ドメインで配信されます。
Q. Cloudflare Pages は無料で使えますか。
A. 公式は、静的なファイルへのリクエストは無料プランでも有料プランでも無料で無制限と説明しています。Free プランの上限は、1か月のビルド 500 回、同時ビルド 1、1サイト 20,000 ファイルなどです(2026年11月11日時点)。最新の条件は公式の料金のページで確かめます。
Q. Cloudflare Pages と Workers の違いは何ですか。
A. Pages は静的サイトの公開が出発点のサービスで、Workers はコードを動かす実行環境です。いまは Workers でも静的なファイルを配信でき、公式は「Workers は Pages の使い道のほとんどに対応する」「新しいプロジェクトは Workers で始める」と案内しています。
Q. Cloudflare Pages は無くなりますか。
A. この記事で確かめた公式ドキュメントのページ(Pages の概要・Get started・Limits・移行ガイド)には、提供終了の告知は載っていませんでした(2026年11月11日時点)。載っていたのは、新規は Workers で始めるという案内と、移行のガイドです。今後の方針は公式の発表で確かめます。
Q. Git 連携と直接アップロードは、あとから切り替えられますか。
A. 切り替えられません。公式は、Git 連携で作ったプロジェクトは直接アップロードに変えられず、直接アップロードで作ったプロジェクトも Git 連携に変えられないと説明しています。変えるときは新しいプロジェクトを作ります。Git 連携のプロジェクトでも、すべてのブランチの自動デプロイを止めれば Wrangler からデプロイできます。
Q. ビルドの出力フォルダーには何を入れますか。
A. ビルドコマンドが出来上がったサイトを書き出すフォルダーの名前です。Vite や Astro は dist、Hugo は public、Jekyll は _site が公式のプリセットの値です。手元でビルドして、index.html が出来る場所を確かめるのが確実です。
Q. _redirects の行は、どの順番で当たりますか。
A. 公式は「同じ元のパスに複数のリダイレクトがあれば、いちばん上が使われる」「静的なリダイレクトを動的なものより先に書く」と説明しています。この記事の検査でも、広いルール(/blog/*)を上に置くと、個別のルールに届きませんでした。
Q. プレビューの URL は、ほかの人にも見えますか。
A. 既定では公開されています。応答には X-Robots-Tag: noindex が付きますが、URL を知っている人は開けます。見られる人を絞るには、プロジェクトの設定で Cloudflare Access のポリシーを有効にします。
Q. WordPress や PHP は動きますか。
A. Pages が配信するのは、出力フォルダーの静的なファイルです。サーバー側の処理は Pages Functions(JavaScript・TypeScript)で書きます。公式のプリセットの一覧にあるのは、Hugo・Jekyll・Astro などの静的サイトジェネレーターと、フロントエンドのフレームワークです。
Q. 独自ドメインを使うには、ネームサーバーを変える必要がありますか。
A. apex ドメイン(example.com)は、ネームサーバーを Cloudflare に向ける必要があります。サブドメイン(shop.example.com)は、いま使っている DNS に CNAME を足す方法でも設定できます。どちらも、先にダッシュボードでドメインを足します。
まとめ
この節では、この記事の要点を5つに絞って振り返れます。
- Cloudflare Pages とは、静的サイトとフロントエンドを Cloudflare のネットワークに公開するサービスです。入口は Git 連携・直接アップロード・C3 の3つで、Git 連携と直接アップロードはあとから切り替えられません。
- ビルドの設定の中心は、ビルドコマンドと出力フォルダーです。手元の配信では、指定を誤るとページが 404 になり、原稿や build.py が読める状態になりました。
_redirectsは「元 先 ステータス」を1行に1つ。省略は 302、上限は静的 2,000+動的 100。検査では、順番を入れ替えるだけで/blog/old-postの送り先が変わりました。- 公式は、新しいプロジェクトは Workers で始めるよう案内しています(2026年11月11日時点)。ゾーンの外の独自ドメインは、対応表で Pages だけの項目です。
- 静的なファイルへのリクエストは無料で無制限、上限はビルド回数(Free は月 500)・ファイル数(Free は 20,000)・Functions のリクエスト(Workers と共通の枠)にあります。
参考・出典
この節では、この記事の内容を確かめた公式のページが分かります(いずれも確認日 2026年11月11日)。
- Cloudflare Pages docs「Overview」https://developers.cloudflare.com/pages/
- 同「Get started」「Git integration」「Direct Upload」https://developers.cloudflare.com/pages/get-started/
- 同「Build configuration」「Build image」https://developers.cloudflare.com/pages/configuration/build-configuration/
- 同「Preview deployments」「Rollbacks」「Custom domains」「Serving Pages」https://developers.cloudflare.com/pages/configuration/
- 同「Redirects」https://developers.cloudflare.com/pages/configuration/redirects/
- 同「Headers」https://developers.cloudflare.com/pages/configuration/headers/
- 同「Functions」の「Routing」「Pricing」https://developers.cloudflare.com/pages/functions/
- 同「Limits」「Known issues」https://developers.cloudflare.com/pages/platform/limits/
- Cloudflare Workers docs「Static Assets」「Migrate from Pages to Workers」https://developers.cloudflare.com/workers/static-assets/
- Python ドキュメント「http.server」https://docs.python.org/ja/3/library/http.server.html
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「Cloudflare Pagesとは|使い方・デプロイ3通りとWorkersとの関係」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。