【Cloudflare】WordPress から Astro と Cloudflare Pages へ、ブログを静的サイトに移した話

はじめに

このブログは、もともと WordPress(テーマは Cocoon)で動かしていました。2026 年の 10 月に、これを Astro の静的サイトに作り替え、11 月には置き場をレンタルサーバー(ロリポップ)から Cloudflare Pages に移しました。

静的サイトとは、あらかじめ組み立てておいた HTML・画像などのファイルを、そのまま配るだけのサイトのことです。Astro は、Markdown の記事から静的サイトを組み立てる道具です。

この記事は、その引っ越しの流れと、途中でつまずいたところのメモです。

なぜ移したか

  • サーバーで動く物を減らしたい:WordPress は、見られるたびにサーバーで PHP とデータベースが動きます。静的サイトなら、組み立て済みのファイルを返すだけです。管理画面やログインの入り口も無くなります
  • 記事を手元のファイルで持ちたい:記事は Markdown のファイルになり、画像と一緒に git で履歴を持てます
  • レンタルサーバーをやめられる:Cloudflare Pages は静的サイトを無料の枠で置けます。ロリポップは年内に解約します

全体の流れ

  1. WordPress から記事・画像・URL の一覧を書き出す
  2. Astro で、今と同じ URL のサイトを組み立てる
  3. 全 URL を照合して、同じになったことを確かめる
  4. Cloudflare Pages に載せ、本番と返り方を比べる
  5. ネームサーバー(ドメインの行き先を決める DNS の置き場)を Cloudflare に替える
  6. 毎朝の「よく読まれている記事」の更新を、GitHub Actions で Pages に上げるようにする

WordPress から書き出す

まず、WordPress の REST API(外から記事などを読み出せる窓口)を読むだけの小さなスクリプトで、中身を全部書き出しました。

  • 投稿 67 本・固定ページ 4 本(Markdown に変換)
  • カテゴリ 84・タグ 128(件数つき)
  • 記事が使っている画像 945 枚(193MB)
  • 公開している URL の一覧 284 件(urls.csv)

この urls.csv が、あとで「同じ URL になったか」を確かめるときの答えになります。

Astro で同じ URL を再現する

URL は 1 文字も変えない

検索エンジンや、ほかのサイトから貼られたリンクを切らないよう、記事の URL は WordPress のころと 1 文字も変えないことにしました。記事の URL は、日付と、日本語を % エンコード(URL に使えない文字を %e3%81%8b のような形にすること)した名前でできています。ページの中のリンクや canonical(そのページの正式な URL を示すタグ)も、WordPress と同じ小文字の % エンコードで出しています。

一覧は 10 件ずつ /page/N/、RSS は /feed/、サイトマップは /sitemap.xml の 1 枚にしました。検索は Pagefind(組み立てのときに索引を作る、サーバーの要らない検索)で /search/?q= にしています。

WordPress 特有の部品を作り直す

Cocoon の記事には、Markdown にそのままでは載らない部品がありました。

  • ブログカード(リンクを題名と画像つきの箱で出す部品):107 件
  • 吹き出し(アイコンつきの会話):14 か所。範囲がわかるよう、Markdown に印のついた div で書きました
  • 目次:h2〜h4 の見出しから入れ子で作ります
<div class="speech-wrap" data-name="…" data-icon="…">
…(吹き出しの中身)
</div><!-- /speech-wrap -->

コードは組み立てのときに Shiki で色を付けています。タグはこの機会にやめて、カテゴリだけにしました(タグの URL は転送で受けています)。

全 URL を照合する

npm run check:urls で、urls.csv の 284 件すべてが組み立て結果にあり、canonical も一致することを確かめました。

$ npm run check:urls
URL 照合: 284 / 284 件 OK(うちタグ 128 件はカテゴリ・トップへの転送で確認)
付帯ファイル: 8 / 8 件あり

付帯ファイルは RSS・サイトマップ・robots.txt・404 などです。あわせて、次に書く転送の表も見ています。

古い URL を転送する

WordPress には、記事の正式な URL のほかにも、いろいろな入り口がありました。これらを 301(恒久的な転送)や 410(もう無い)で受けます。

  • www. あり → なし、http → https
  • /?p=記事番号・/?page_id=番号 → 記事(番号と記事の対応表を組み立てのときに作って埋め込む)
  • /?s=検索語 → /search/?q=検索語
  • 記事のフィード → 記事、カテゴリ・タグのフィード → /feed/
  • 日付の一覧・著者のページ → トップ
  • /wp-content/uploads/… の画像 → /images/…
  • /wp-admin・/wp-login.php・/wp-json・/xmlrpc.php → 410

ロリポップ(Apache)のころは、これを .htaccess に書いていました。

Cloudflare Pages に載せる

Pages には git 連携ではなく、手元で組み立てた物を wrangler(Cloudflare のコマンドラインの道具)で上げる「direct upload」を使っています。

$ npm run deploy:cf

上げる前に、Pages の上限(ファイル 2 万個・1 個 25MiB)を超えていないかを数えています。このブログは 1,853 個で、25MiB を超えるファイルは 0 個でした。wrangler は中身が変わったファイルだけを送るので、写真を毎回送り直すことはありません。

転送は _worker.js で書く

Pages では .htaccess が使えません。そこで、_worker.js を置く「advanced mode」にして、転送を JavaScript で書き直しました。Worker(Cloudflare の上で動く小さなプログラム)が要求を受けて、転送するか、静的なファイルを返すかを決めます。規則は .htaccess と同じものを同じ順に並べ、?p= とタグの対応表は同じ関数から両方に埋め込んでいます(表を二重に持たないため)。

_routes.json で Worker を通す道を絞る

Worker は無料の枠だと 1 日 10 万回までです。写真や CSS は転送が要らないので、_routes.json で Worker を通さないようにしました。

{
  "version": 1,
  "include": ["/*"],
  "exclude": ["/_astro/*", "/images/*", "/assets/*", "/og/*", "/pagefind/*"]
}

_redirects を使わなかった理由

Pages には、転送を書く _redirects というファイルもあります。使わなかったのは、

  • Worker を通る道には _redirects が効かない
  • タグの転送(128 件 × /page/N/)が、動的な規則の上限 100 件を超える

からです。転送はすべて Worker にまとめました。

pages.dev は検索に載せない

Pages には <プロジェクト名>.pages.dev という URL も付きます。これが検索に載って本番と重複しないよう、*.pages.dev で見たときだけ X-Robots-Tag: noindex を付けています。

if (url.hostname.endsWith('.pages.dev')) {
  res = new Response(res.body, res);
  res.headers.set('X-Robots-Tag', 'noindex');
}

本番と 417 件を比べる

切り替える前に、本番(ロリポップ)と pages.dev の両方に同じ URL を当てて、返り方を比べるコマンド npm run check:live を作りました。当てたのは 417 件です。

  • urls.csv の 284 件
  • ?p= の 78 件
  • 古い入り口の見本 50 件
  • 古い画像の置き場 5 件

状態コード・転送先(ホスト名は除く)・canonical・Content-Type を比べて、417 件すべて同じになるまで直しました。なお、上げた直後の 1 回目だけ 7 件が 500 を返し、当て直すと 200 になりました。上げた直後の行き渡り待ちだったようです。

ネームサーバーを切り替える

DNS のレコードを Cloudflare に写してから、ネームサーバーを Cloudflare に替え、sogablog.net と www.sogablog.net を Pages の独自ドメインに付けました(2026 年 11 月 3 日)。

付けた直後の数分は、522(Cloudflare が行き先とつながらないときのエラー)が返りました。Pages がドメインを確認している間だけで、待つと直りました。切り替えたあと、本物のドメインでも check:live の 417 件がすべて同じで、sogablog.net に noindex が付いていないことを確かめました。

つまずいたところ

wrangler がサイトのフォルダで Astro を見つけて設定を書き換え始める

wrangler 4.156 を、サイトのフォルダ(package.json と astro.config.mjs がある所)で wrangler pages … と動かしたら、Astro を見つけて「自動設定」を始めました。wrangler.jsonc を作り、package.json と astro.config.mjs を書き換え、@astrojs/cloudflare を入れようとします。静的サイトとして上げたいだけなので、これは困ります。

一度起きたので元に戻し、上げる物を package.json の無いフォルダに写して、その中から呼ぶようにしました。

rsync -a --exclude '.htaccess' --exclude '.DS_Store' dist/ "$STAGE/"
(cd "$STAGE" && npx --yes wrangler@4 pages deploy . --project-name "$CF_PROJECT" --branch main --commit-dirty=true)

また、Pages のプロジェクトがまだ無いときは、Workers へ回そうとして失敗しました(プロジェクトを作るときだけ --force を付けました)。

末尾の / を足す転送が 308 で、% エンコードが大文字になる

/2026/11/13/記事名 のように末尾の / が無い URL に来ると、Pages は / を足した URL へ転送します。比べてみると、Apache とは 2 か所違いました。

  • 状態コードが 301 ではなく 308
  • 行き先の % エンコードが大文字(%E3%81%8B)に直されている。本番の URL は小文字

Worker で 308 を受けたら、受けたままの書き方に / を足して 301 で返すようにしました。

if (r.status === 308) {
  let loc = r.headers.get('Location');
  const to = new URL(loc, url);
  if (to.host === url.host && same(to.pathname, `${p}/`)) loc = `https://${url.host}${p}/${url.search}`;
  return new Response(null, { status: 301, headers: { Location: loc } });
}

ほかにも、/x/index.html を拡張子なしへ 308 で送る、/feed/ の型など、Pages の癖を Apache に合わせています。

よく読まれている記事を毎朝更新する

トップの「よく読まれている記事」は、Google アナリティクス(GA4)の直近 90 日の閲覧数の上位 4 本です。静的サイトなので、選び直すには組み立て直す必要があります。そこで、GitHub Actions(GitHub の上でコマンドを自動で動かす仕組み)で毎朝こう動かしています。

  1. GA4 から閲覧数を取る(依存なしの Node のスクリプト。JWT を node:crypto で作り、GA4 Data API を直接呼ぶ)
  2. 組み立てる → check:urls で照合する
  3. Cloudflare Pages へ上げる
on:
  schedule:
    - cron: '0 20 * * *' # UTC 20:00 = 日本時間 5:00

GA4 から取れなかった日は、警告を出して手書きの 4 本で組み立てます。組み立ては止めません。

ひとつ気をつけることがあります。自動実行は GitHub の main の中身で組み立てるので、手元で記事を足して上げただけだと、翌朝に古い中身で上書きされます。記事や写真を足したら、main に push してから上げるようにしています。

まとめ

WordPress から Astro の静的サイトへ、そして Cloudflare Pages への引っ越しは、

  1. 記事・画像・URL の一覧を書き出す
  2. 同じ URL で組み立て、284 件を照合する
  3. 古い入り口の転送を _worker.js で書き直す
  4. 本番と Pages に 417 件を当てて、すべて同じになるまで直す
  5. ネームサーバーを切り替える

の順で進めました。いちばん効いたのは、「本番と同じか」を数で確かめる道具を先に作ったことです。違いが 0 件になるまで直してから切り替えたので、切り替えのあとに慌てることはありませんでした。

ネームサーバーを Cloudflare に替えたので、そのあとドメインの契約も Cloudflare Registrar へ移しました。そちらは別の記事に書いています。

【Cloudflare】ムームードメインから Cloudflare Registrar へ .net ドメインを移管した手順