はじめに
このブログは、もともと WordPress(テーマは Cocoon)で動かしていました。2026 年の 10 月に、これを Astro の静的サイトに作り替え、11 月には置き場をレンタルサーバー(ロリポップ)から Cloudflare Pages に移しました。
静的サイトとは、あらかじめ組み立てておいた HTML・画像などのファイルを、そのまま配るだけのサイトのことです。Astro は、Markdown の記事から静的サイトを組み立てる道具です。
この記事は、その引っ越しの流れと、途中でつまずいたところのメモです。
なぜ移したか
- サーバーで動く物を減らしたい:WordPress は、見られるたびにサーバーで PHP とデータベースが動きます。静的サイトなら、組み立て済みのファイルを返すだけです。管理画面やログインの入り口も無くなります
- 記事を手元のファイルで持ちたい:記事は Markdown のファイルになり、画像と一緒に git で履歴を持てます
- レンタルサーバーをやめられる:Cloudflare Pages は静的サイトを無料の枠で置けます。ロリポップは年内に解約します
全体の流れ
- WordPress から記事・画像・URL の一覧を書き出す
- Astro で、今と同じ URL のサイトを組み立てる
- 全 URL を照合して、同じになったことを確かめる
- Cloudflare Pages に載せ、本番と返り方を比べる
- ネームサーバー(ドメインの行き先を決める DNS の置き場)を Cloudflare に替える
- 毎朝の「よく読まれている記事」の更新を、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 の上でコマンドを自動で動かす仕組み)で毎朝こう動かしています。
- GA4 から閲覧数を取る(依存なしの Node のスクリプト。JWT を
node:cryptoで作り、GA4 Data API を直接呼ぶ) - 組み立てる →
check:urlsで照合する - Cloudflare Pages へ上げる
on:
schedule:
- cron: '0 20 * * *' # UTC 20:00 = 日本時間 5:00
GA4 から取れなかった日は、警告を出して手書きの 4 本で組み立てます。組み立ては止めません。
ひとつ気をつけることがあります。自動実行は GitHub の main の中身で組み立てるので、手元で記事を足して上げただけだと、翌朝に古い中身で上書きされます。記事や写真を足したら、main に push してから上げるようにしています。
まとめ
WordPress から Astro の静的サイトへ、そして Cloudflare Pages への引っ越しは、
- 記事・画像・URL の一覧を書き出す
- 同じ URL で組み立て、284 件を照合する
- 古い入り口の転送を
_worker.jsで書き直す - 本番と Pages に 417 件を当てて、すべて同じになるまで直す
- ネームサーバーを切り替える
の順で進めました。いちばん効いたのは、「本番と同じか」を数で確かめる道具を先に作ったことです。違いが 0 件になるまで直してから切り替えたので、切り替えのあとに慌てることはありませんでした。
ネームサーバーを Cloudflare に替えたので、そのあとドメインの契約も Cloudflare Registrar へ移しました。そちらは別の記事に書いています。
【Cloudflare】ムームードメインから Cloudflare Registrar へ .net ドメインを移管した手順