「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 の設定から、秘密に関係しない部分をそのまま載せます。
{
"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_handling | URL 末尾のスラッシュの扱い。初期値の 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_first | true ならすべてのリクエストでプログラムを先に動かす。パターンの配列なら、その URL だけ |
出典:Cloudflare Workers ドキュメント「Static Assets」「HTML handling」(2026年11月14日に確認)
API の部分を書く
プログラムは、/api/ で始まる URL だけを自分で処理し、それ以外はファイルの配信に回します。DE:ZIGN のお問い合わせ用の Worker を、入力チェックを省いて短くしたものがこちらです。
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 にコピーされます。
# 転送元 転送先 ステータス
/index.php / 301
/about.php /about/ 301
/tips.php /tips/ 301
公式ドキュメントによると、1行に1つ「転送元 転送先 ステータス」を書き、ステータスを省くと302になります。上限は固定の転送が2,000件、パターンを使った転送が100件です。
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 の項目がない」というエラーを出して止まりました。プレビュー用の環境変数を、本番とは別に書くよう求められていたのです。
"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 の設定が必要)。
参考・出典
- Cloudflare Docs:Workers Static Assets 2026年11月14日確認
- Cloudflare Docs:HTML handling 2026年11月14日確認
- Cloudflare Docs:Redirects(_redirects) 2026年11月14日確認
- Cloudflare Docs:Workers の料金と無料プランの上限 2026年11月14日確認
料金・上限は確認日の情報です。最新の情報は公式ドキュメントでご確認ください。