Cache-Control ヘッダーとは何ですか?

Cache-Control は HTTP リクエストまたはレスポンスのヘッダーで、ディレクティブによってキャッシュの保存、鮮度、再検証、再利用を制御します。ブラウザーと共有の中継キャッシュには、それぞれ異なるディレクティブを適用できます。

Cache-Control ヘッダーの仕組み

Cache-Control は、HTTP リクエストまたはレスポンスに付けるカンマ区切りのディレクティブでポリシーを伝えます。鮮度に関するディレクティブは、オリジンに問い合わせずに再利用できる期間を定めます。保存、検証、適用範囲に関するディレクティブは、プライベートキャッシュと共有キャッシュが保持または配信できる内容を制限します。仕様に準拠するキャッシュはレスポンスのディレクティブに従う必要がありますが、リクエストのディレクティブは助言にとどまります。CDN は、クライアントがオリジンへの問い合わせを強制できるディレクティブを無視する場合があります。たとえば Google Cloud CDN は、リクエスト内の no-cache と max-age を無視します。このヘッダーは経路上のすべてのキャッシュに一括して作用し、特定のキャッシュだけを指定できません。そのため、RFC 9213 では、同じディレクティブを使用する別のレスポンスヘッダー CDN-Cache-Control を定義しています。対応する CDN キャッシュは、これを Cache-Control の代わりに使用します。

要点

  1. no-cache はレスポンスの保存を許可しますが、再利用のたびにオリジンでの検証が成功することを要求します。no-store は、プライベートか共有かを問わず、すべてのキャッシュにレスポンスを一切保存しないよう指示します。RFC 9111 はさらに、no-store がプライバシーを確保するための信頼できる、または十分な仕組みではないとしています。つまり、これはキャッシュへの指示であり、アクセス制御の代わりにはなりません。
  2. max-age はすべてのキャッシュの鮮度保持期間を設定します。s-maxage は CDN などの共有キャッシュでその値を上書きし、ブラウザーでは無視されます。内容が変わるたびに URL も変わるファイルについて、MDN は長い max-age(例では一年)と immutable を組み合わせるパターンを示しています。後者は、レスポンスが新鮮な間は更新されないことを示します。s-maxage には proxy-revalidate の意味も含まれます。レスポンスが古くなると、共有キャッシュは再利用前に再検証する必要があります。Cloudflare では、Free、Pro、Business プランでデフォルトの Origin Cache Control が有効な場合、s-maxage が付いた古いレスポンスを配信しません。Google Cloud CDN のドキュメントにも同じ動作が記載されているため、これらの環境では、併用しても stale-while-revalidate は効果を持ちません。Cloudflare がドキュメントで示す回避策は、max-age と stale-while-revalidate を組み合わせ、エッジ TTL ルールを別途設定する方法です。
  3. private は共有キャッシュへの保存を禁止しますが、ブラウザー自身のキャッシュへの保存は許可するため、キャッシュの無効化とは異なります。個人向けにカスタマイズしたレスポンスには、明示的に設定する必要があります。HTTP 自体が共有キャッシュへのレスポンスの保存を制限するのは、リクエストに Authorization ヘッダーが含まれる場合だけです。その場合でも、public、s-maxage、または must-revalidate があれば、その制限は解除されます。Cookie リクエストヘッダーでセッションを送信しても、このようなルールは適用されません。また、RFC 9111 は、Set-Cookie レスポンスヘッダーがキャッシュを妨げないとしています。Google Cloud CDN は、Set-Cookie を持つレスポンスをキャッシュしません。Cloudflare も、デフォルトのキャッシュレベルでは Origin Cache Control が有効な間はキャッシュしませんが、無効な場合は Set-Cookie ヘッダーを取り除いてレスポンスをキャッシュすることがあります。いずれもプロバイダー固有の動作であり、HTTP のルールではありません。
  4. Cache-Control がないレスポンスも、キャッシュされることがあります。RFC 9111 は、明示的な有効期限がなく、ヒューリスティックにキャッシュ可能なレスポンスに対して、キャッシュがヒューリスティックな有効期間を設定することを認めています。推奨される上限は、Last-Modified からの経過時間の一定割合です。オリジンが有効期間を送信しない場合、CDN は独自のデフォルト値を適用します。エラーにも同じルールが適用され、鮮度が明示された最終レスポンスは保存されることがあります。そのため、成功レスポンス用の長い max-age を付けて送信した 5xx は、下流のキャッシュに保存され、再び配信される可能性があります。ただし、CDN が保存するステータスコードはプロバイダーによって異なります。キャッシュしてはならないレスポンスには必ず no-store を付け、エラーレスポンスには成功時の有効期間を付けないでください。CDN は、ヘッダーでは無効にできない独自の設定に基づいてエラーをキャッシュすることもあります。Amazon CloudFront は、500、502、503、504 のレスポンスで no-store、no-cache、private を無視し、Error Caching Minimum TTL の期間キャッシュします。この値はステータスコードごとに設定され、デフォルトは 10 秒です。キャッシュビヘイビアで CachingDisabled マネージドキャッシュポリシーを使用する場合、これらのエラーはキャッシュされません。
  5. オリジンのヘッダーが、エッジで常に最優先されるとは限りません。Amazon CloudFront は、キャッシュポリシーの最小 TTL が 0 より大きい場合、オリジンが no-cache、no-store、または private を送信していても、その最小 TTL を使用します。Cloudflare の Edge Cache TTL ルールは、s-maxage と再検証ディレクティブを上書きします。Google Cloud CDN の FORCE_CACHE_ALL モードは、オリジンのディレクティブにかかわらず成功レスポンスをキャッシュします。ディレクティブによって共有キャッシュへの保存を防げると判断する前に、CDN の TTL と上書き設定を確認してください。

Cache-Control ヘッダーが重要になる場面

レスポンスが公開か非公開か、不変か頻繁に更新されるかに応じて Cache-Control を設定してください。矛盾するディレクティブや過度に許容的なディレクティブは、非公開データの露出や古いメディアの保持につながるおそれがあります。

Cache-Control ヘッダーに関する Transloadit の機能

Transloadit が Smart CDN 経由で変換済みファイルを配信する際は、Robot /file/serve が結果の Cache-Control ヘッダーを設定します。ブラウザーでの有効期間は max-age に、共有キャッシュでの有効期間は s-maxage に個別に設定されます。この Robot の cache_duration パラメーターは両方のディレクティブを同じ値に設定し、headers パラメーターは独自のヘッダー値をデフォルト値にマージして上書きします。署名付き Smart CDN URL では、実際のキャッシュ有効期間は署名の残りの有効期間によっても制限されます。

現在のデフォルトの有効期間は Robot のページに記載されています。

Transloadit の配信機能を見る

出典

メディアの知識を実用的なパイプラインに

単一の宣言的 API で、アップロード、処理、AI、ストレージ、配信を連携できます。エンコードスタックの管理、スケーリング、形式の変化への対応はお任せください。

Transloadit を無料で試す