GitHubからCloudflare Pagesへ
エラーなく公開する最短ルート

Whyつまずきの正体

なぜ「Workers」でデプロイされてしまうのか

原因はほぼ100%、管理画面の入口を間違えていることです。Cloudflareは「Workers & Pages」が統合され、Createを押すと最初にWorkers寄りの画面（Ship something new）が出ます。ここで上の「Continue with GitHub」を押すと、ただのHTMLサイトなのにWorkerとして扱われ、エラーや404が連発します。

Basics混乱しやすい用語の整理

「種類」と「方法」は別の話

「Workers? Pages? Wrangler?」がごちゃ混ぜになりがちですが、実は2つの別々の軸です。ここを分けて考えると一気にスッキリします。

この2つを組み合わせると——

Pattern Aこれから作る人

A.最初から正しくやる最短手順

新しくサイトを公開するときの王道です。初回だけ少し手順がありますが、一度つなげば次からは「Pushするだけ」になります。

GitHubにリポジトリを用意する

作ったHTMLフォルダをGitHubに上げます。GitHub Desktopの「Publish repository」でもOK。

💡 リポジトリ名は test や lp など汎用名を避ける。名前-プロジェクト や 日付-プロジェクト 形式が安全（.pages.dev は世界で早い者勝ちのため）。

ダッシュボードで「Workers & Pages」を開く

dash.cloudflare.com → 左メニュー「Workers & Pages」→「Create」。

⭐ 一番下の「Pages … 始める」から進む

ここが最重要ポイント。「Create」を押すと下の画面が出ますが、上の「Continue with GitHub」を押すとWorkersになってしまいます。画面一番下の「Pages を導入しようとお考えですか? 始める」をクリックして、Pages専用のフローに入ってください。

ここをクリック

ビルド設定をこの通りに入れる

HTML1枚のLPなら、迷わずこの設定で。これでビルドエラーも404も出ません。

Production branch	main
Framework preset	None（日本語表示は「なし」。最初から選ばれているので触らなくてOK）
Build command	空欄（何も入れない）
Build output directory	/（HTMLが直下にある場合）

💡 Viteなどビルドが必要なときだけ dist にする。それ以外は / でOK。

「Save and Deploy」で公開完了

数十秒〜数分で https://リポジトリ名.pages.dev が立ち上がります。これで連携完了。

Pattern BすでにWorkersで出してしまった人

B.WorkersをPages連携に作り直す

残念ながら、一度Workerとして作ったものはPagesのGit連携に「変換」できません（Cloudflareの仕様）。なので、Pagesプロジェクトを新しく作り直すのが正解です。やることはパターンAとほぼ同じです。

Routine連携できた後の更新

2回目以降は、これだけ

一度Git連携できれば、管理画面はもう触りません。ローカルで直してPushすれば自動でデプロイされます。

Don'tこれは絶対に避ける

やってはいけないこと

一見ラクに見えても、後で「今どれが公開されてるの?」が分からなくなる原因になります。

FAQよくある質問

「wranglerで自動化したほうがラク」って本当?

生徒さんからよく出る疑問です。結論から言うと、ふだんの更新では GitHub連携のほうがラクで安全です。

Troubleshooting困ったとき

トラブル早見表