「Cloudflare Workersで静的サイトと小さなAPIを公開する」無料枠でできること

ビルドした HTML はそのまま配信し、お問い合わせフォームの送信先のような小さな API だけをプログラムで処理する。Cloudflare Workers の Static Assets を使うと、この組み合わせを1つの設定ファイルで公開できます。DE:ZIGN の実際の設定をもとに説明します。

静的サイトにも、少しだけ動く部分がほしい

Astro などで作った静的サイトは、ファイルを置くだけで公開できます。困るのは、お問い合わせフォームのように「送られてきた内容を受け取って何かする」部分です。ここだけのためにサーバーを借りるのは大げさですし、外部のフォームサービスに頼ると見た目や項目の自由がききません。

Cloudflare Workers は、Cloudflare のネットワーク上で小さなプログラム(Worker)を動かす仕組みです。Static Assets という機能を使うと、HTML や画像などのファイルを Worker と一緒にアップロードでき、ファイルの配信とキャッシュは Cloudflare が受け持ってくれます。

料金も個人開発向きです。公式の料金ページによると、無料プランで Worker が受けられるリクエストは1日10万件まで、1回の処理に使える CPU 時間は10ミリ秒まで。そして、静的ファイルへのリクエストは無料・無制限です(2026年11月時点)。ページの閲覧はいくら増えても無料のまま、プログラムが動くのはフォームの送信のときだけ、という形にできます。

設定は wrangler.jsonc にまとめる

Worker の設定は、プロジェクト直下の wrangler.jsonc に書きます(wrangler は Cloudflare の公式コマンドラインツール)。DE:ZIGN の設定から、秘密に関係しない部分をそのまま載せます。

wrangler.jsonc
{
  "name": "dezign",
  "main": "worker/index.ts",           // プログラムの入口
  "compatibility_date": "2026-11-01",
  "assets": {
    "directory": "./dist",               // Astro が書き出したフォルダ
    "binding": "ASSETS",                // プログラムからファイルを返すときの名前
    "html_handling": "auto-trailing-slash",
    "not_found_handling": "404-page",
    "run_worker_first": ["/api/*"]       // /api/ だけプログラムを通す
  },
  "vars": {
    "MAILER_URL": "https://mailer.dezign.jp/dezign-contact-mailer.php",
    "ALLOWED_ORIGINS": "https://dezign.jp"
  }
}

ポイントになる項目を表にまとめます。

項目意味
assets.directoryデプロイのときにアップロードするフォルダ
assets.bindingプログラムの中で env.ASSETS.fetch(request) のようにファイルを返すための名前
html_handlingURL 末尾のスラッシュの扱い。初期値の auto-trailing-slash は、folder/index.html を /folder/ で、file.html を /file で返し、それ以外の書き方をそこへ転送する。ほかに force-trailing-slash・drop-trailing-slash・none がある
not_found_handlingファイルが見つからないとき。404-page はいちばん近い 404.html を404で返す。single-page-application は index.html を200で返す
run_worker_firsttrue ならすべてのリクエストでプログラムを先に動かす。パターンの配列なら、その URL だけ

出典:Cloudflare Workers ドキュメント「Static Assets」「HTML handling」(2026年11月14日に確認)

📌 run_worker_first を絞る理由
run_worker_first を true にすると、画像1枚の表示でもプログラムが動きます。/api/* に絞っておけば、それ以外はファイルの配信だけで済み、無料の範囲を Worker のリクエスト数で食いつぶす心配がなくなります。

API の部分を書く

プログラムは、/api/ で始まる URL だけを自分で処理し、それ以外はファイルの配信に回します。DE:ZIGN のお問い合わせ用の Worker を、入力チェックを省いて短くしたものがこちらです。

worker/index.ts(要点だけ)
interface Env {
  ASSETS: { fetch(request: Request): Promise<Response> };
  MAILER_URL: string;
  MAILER_TOKEN: string;   // 秘密の値(設定ファイルには書かない)
}

const json = (status: number, body: unknown) =>
  new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json; charset=utf-8' } });

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const url = new URL(request.url);

    if (url.pathname === '/api/contact') {
      if (request.method !== 'POST') return json(405, { ok: false });
      const data = await request.json();
      // (ここで必須項目・メールアドレスの形式・文字数などを確かめる)
      const res = await fetch(env.MAILER_URL, {
        method: 'POST',
        headers: { 'content-type': 'application/json', 'x-mailer-token': env.MAILER_TOKEN },
        body: JSON.stringify(data),
      });
      return json(res.ok ? 200 : 502, { ok: res.ok });
    }

    // /api/ 以外はビルドしたファイルをそのまま返す
    return env.ASSETS.fetch(request);
  },
};

DE:ZIGN では、メールの送信そのものは、メールボックスがあるレンタルサーバー側の小さな PHP に任せています。Worker は入力をチェックして、合言葉(MAILER_TOKEN)を付けて転送するだけです。ドメインのメールをこれまでどおりレンタルサーバーで使い続けたかったので、この分け方にしました。

秘密の値は secret に入れる

合言葉や API キーのような値は、wrangler.jsonc の vars には書きません。vars は Git に入る設定ファイルの中身だからです。代わりに、コマンドかダッシュボードで secret として登録します。

ターミナル
npx wrangler secret put MAILER_TOKEN
# 値の入力を求められるので、そこに貼り付ける(画面にもファイルにも残らない)

ダッシュボードなら「Workers & Pages → 対象の Worker → 設定 → 変数とシークレット」から、種類を「シークレット」にして追加します。

旧サイトからのリダイレクトは _redirects で

サイトを引っ越すと、古い URL を新しい URL に転送したくなります。Static Assets は、公開するフォルダに _redirects という名前のファイルを置くだけで転送を設定できます。Astro なら public フォルダに置けば、ビルドで dist にコピーされます。

public/_redirects(DE:ZIGN の一部)
# 転送元          転送先       ステータス
/index.php        /           301
/about.php        /about/     301
/tips.php         /tips/      301

公式ドキュメントによると、1行に1つ「転送元 転送先 ステータス」を書き、ステータスを省くと302になります。上限は固定の転送が2,000件、パターンを使った転送が100件です。

⚠️ プログラムが返す URL には効かない
_redirects の転送は、静的ファイルとして返すリクエストにだけ適用され、Worker のプログラムが返すレスポンスには適用されないと公式ドキュメントに書かれています。/api/ の転送をしたいときは、プログラムの中で書いてください。

GitHub につなぐと、push で公開される

ダッシュボードで Worker を GitHub のリポジトリにつなぐと(Workers Builds)、main に push するたびに Cloudflare 側でビルドとデプロイが走ります。DE:ZIGN では、ビルドのコマンドを npm run build、デプロイのコマンドを npx wrangler deploy にしています。

main 以外のブランチを push すると、本番とは別のプレビュー用 URL にデプロイされる設定もあります。DE:ZIGN は、記事の下書きを preview というブランチに送って確認しています。

ここで1つつまずいた点があります。プレビューのデプロイで、wrangler が「設定ファイルに previews の項目がない」というエラーを出して止まりました。プレビュー用の環境変数を、本番とは別に書くよう求められていたのです。

wrangler.jsonc に足した部分
"previews": {
  "vars": {
    "MAILER_URL": "https://mailer.dezign.jp/dezign-contact-mailer.php",
    "ALLOWED_ORIGINS": "https://dezign.jp"
  }
}

secret(MAILER_TOKEN)はプレビュー側に登録していないので、プレビューのページからはメールが送られません。下書きの確認で問い合わせが届いてしまう事故を防げるので、この状態のままにしています。

独自ドメインをつなぐときの注意

Worker には最初から 名前.アカウント名.workers.dev の URL が付きます。独自ドメインで公開するには、ドメインの DNS を Cloudflare で管理し、Worker の設定からカスタムドメインを追加します。

ドメインで独自のメールを使っている場合は、DNS を移すときに MX(メールの宛先)と、メールサーバーを指す A レコードを必ず引き継いでください。メール関係のレコードはプロキシを通さない「DNS のみ」にします。DE:ZIGN もこの形で、Web は Cloudflare、メールはこれまでのレンタルサーバー、と分けて動かしています。

ネームサーバーを切り替えたあとは、古い DNS の情報が各地のキャッシュから消えるまで、しばらく新旧のサーバーが混ざって見えます。DE:ZIGN では、切り替えた当日の夕方になっても、一部の環境から旧サーバーのページが表示されていました。旧サーバーは数日そのまま残しておくと安心です。

まとめ

  • Cloudflare Workers の Static Assets を使うと、ビルドしたファイルと小さな API を1つの Worker でまとめて公開できる。
  • 無料プランでは静的ファイルへのリクエストは無料・無制限で、Worker のプログラムは1日10万リクエストまで動かせる(2026年11月時点)。
  • run_worker_first を ["/api/*"] のように絞ると、プログラムが動くのは API のときだけになる。
  • 合言葉や API キーは vars ではなく secret に登録し、Git に入れない。
  • 旧 URL の転送は公開フォルダの _redirects に書けるが、プログラムが返すレスポンスには適用されない。
  • GitHub につなぐと push で自動公開され、main 以外のブランチはプレビュー用 URL に出せる(wrangler.jsonc に previews の設定が必要)。

参考・出典

料金・上限は確認日の情報です。最新の情報は公式ドキュメントでご確認ください。