Cloudflare Workers キャッシュ設定方法 - エッジキャッシュとTiered Cache

Fri, 11 Sep 2026 13:01:00 +0000

概要

この記事は Cloudflare Workers 静的サイトガイド - デプロイからSEOまでシリーズの一部です。

Workerが外部APIを呼び始めると、すぐにキャッシュが必要になります。かけなければオリジンの負荷がページビューの分だけ増えます。

かけること自体は1行で済みますが、その後に知らなければ必ず踏む罠がいくつかあります。特にエッジキャッシュが全世界で共有されないという点は、知ってしまえば当然ですが、知らなければ「なぜキャッシュが当たらないのか」としばらく悩むことになります。

KV・R2・D1のようなストレージは範囲外です。この記事はHTTPレスポンスキャッシュのみを扱います。

① fetch() の cf オプション — レスポンスをCloudflareのエッジキャッシュに任せます（Request ドキュメント）。

1await fetch(url, {
2 cf: { cacheTtl: 3600, cacheEverything: true },
3});

② Cache API — 自分で入れて取り出します。

1const cache = caches.default;
2const hit = await cache.match(key);
3if (hit) return hit;
4// ...
5ctx.waitUntil(cache.put(key, response.clone()));

エッジキャッシュはデータセンターごとに別です。 ドキュメントの表現そのままです。

The contents of the cache do not replicate outside of the originating data center.