静的コンテンツとは?
静的コンテンツは、保存済みの表現を配信するもので、通常はリクエストが変わっても同一の内容を保ちます。リクエストごとに生成するのではなく、元のリソースが更新されたときだけ内容が変わります。
静的コンテンツの仕組み
静的コンテンツとは、配信上の特性を指します。サーバーはリクエストに対してアプリケーションロジックを実行せずに、ディスク上のファイルやバケット内のオブジェクトなど、既存のバイト列を返せます。ファイルは手作業で作成したもの、ビルドで生成したもの、メディアパイプラインからエクスポートしたもののいずれでもよいため、「静的」は、内容が決して変わらないという意味ではありません。リクエストの到着時ではなく、保存済みファイルの置き換え時に内容が変わるという意味です。そのため、主に二つの HTTP の仕組みが使われます。Cache-Control で設定する鮮度は、ブラウザーや CDN が問い合わせなしでコピーを再利用できる期間を示します。検証子である ETag または
Last-Modified の日付を使うと、キャッシュはコピーが今も最新かを問い合わせ、最新であれば本文のない 304 レスポンスを受け取れます。画像、動画セグメント、フォント、スタイルシート、スクリプト、事前ビルド済みの HTML ページは、典型的な静的コンテンツです。アプリケーションの状態からリクエストごとに組み立てるレスポンスは、動的コンテンツです。
要点
- 静的ファイルは自動的にキャッシュされるのでしょうか。確実ではなく、期間も予測できません。
Cache-ControlまたはExpiresによる明示的な鮮度がない場合、HTTP ではキャッシュがヒューリスティックに鮮度を判断できます。RFC 9111 は、Last-Modifiedから有効期間を推定することを認め、一般的な設定として最終更新からの経過時間の 10% を挙げています。このため MDN は、すべてのレスポンスに明示的なCache-Controlヘッダーを付けることを推奨しています。CDN には独自のデフォルト設定もあります。たとえば Cloudflare は、MIME タイプではなくファイル拡張子に基づいてキャッシュし、デフォルトでは HTML や JSON をキャッシュせず、Set-Cookieを含むレスポンスもキャッシュしません。 - 静的ファイルの内容が変わっても URL を維持すべきでしょうか。ファイルごとに判断します。名前にハッシュを含むバンドルのように、内容に応じて URL が変わるファイルは、新しいバージョンが新しい URL で提供されるため、長い
max-age(MDN の例では一年)とimmutableを指定して配信できます。HTML ページのように URL を維持する必要があるファイルには、長い有効期間を設定すべきではありません。サーバー上のファイルを更新しても、ブラウザーがすでに保存した鮮度のあるコピーは置き換わりません。MDN が指摘するように、そのコピーへのリクエストはもはやサーバーに届かないため、ブラウザーは有効期間が切れるまでそのコピーを使い続けることができます。パージ機能のある CDN は自身のコピーを削除できますが、ブラウザーに保存済みのコピーにはパージが届きません。こうしたファイルはno-cacheと検証子を指定して配信し、再利用のたびに検証され、ファイルに変更がなければ 304 の応答だけで済むようにします。 - ファイルから配信すれば、共有キャッシュに安全に保存できるレスポンスになるのでしょうか。そうではありません。キャッシュ可否は本文の生成方法ではなく、リクエストとレスポンスヘッダーによって決まります。RFC 9111 では、
Authorizationを含むリクエストへのレスポンスは、public、s-maxage、またはmust-revalidateで許可されていない限り、共有キャッシュで再利用することを禁止しています。Cookieヘッダーを含むリクエストには、このような規則はありません。MDN でも、Cookie があるだけではレスポンスはプライベートにならないと説明しています。また、この RFC ではSet-Cookieはキャッシュを妨げないとしています。そのため、標準に従うキャッシュは、Cookie とともに送信された静的ファイルを保存し、後続のリクエストで再利用できます。ただし、CDN が独自の規則を適用する場合もあります。前述のとおり、Cloudflare はこのようなレスポンスをデフォルトではキャッシュしません。静的パスでは、できるだけ Cookie を設定しないでください。レスポンスに Cookie が必要な場合や、Cookie によってレスポンスをパーソナライズする場合は、privateを指定してください。すると、CDN などの共有キャッシュはそのレスポンスを保存してはならず、ファイルはブラウザーでのみキャッシュされます。 - ファイルを事前圧縮すると何が変わるのでしょうか。圧縮済みファイルと非圧縮ファイルは、同じ URL に対応する二つの表現です。そのため、レスポンスには
Vary: Accept-Encodingが必要です。また、RFC 9110 では、キャッシュ更新や範囲リクエストでの競合を防ぐため、コンテンツ符号化された表現の強いETagは、符号化されていない表現とは異なる値にする必要があると定めています。これらをどこまで自動で処理するかは、サーバーによって異なります。nginx のgzip_staticは、通常のファイルの代わりに既存の.gzファイルを送信します。ただし、Vary: Accept-Encodingを追加するのはgzip_varyが有効な場合だけで、デフォルトでは無効です。nginx の二つのモジュールページには、.gzレスポンスのETagがどのように生成されるか記載されていません。そこで、Accept-Encoding: gzipの有無を変えてファイルをリクエストし、Content-Encodingから前者のレスポンスだけが圧縮されていることを確認して、両方のレスポンスのVaryとETagヘッダーを比較してください。CDN 経由でも同じ確認を行ってください。gzip_staticはgzip_proxiedも考慮し、デフォルト値のoffではViaヘッダーを含むリクエストの圧縮が無効になります。そのため、CDN が転送したリクエストには非圧縮ファイルが返される場合があります。Apache のmod_deflateは配信時に圧縮を行い、デフォルトで圧縮方式をETagに付加します。ドキュメントでは、これにより圧縮コンテンツへの条件付きリクエストに 304 レスポンスが返されなくなると説明しています。
静的コンテンツが重要になる場面
コンテンツの改訂ごとに固有の URL を割り当てる場合は、キャッシュの有効期間を長く設定し、レイテンシーとオリジンの負荷を減らしてください。固定の URL で内容が更新される可能性がある場合は、有効期間を短くするか、再検証を行うほうが安全です。
Transloadit による静的コンテンツのサポート
Assembly がストレージ Robot でエクスポートしたファイルは、その時点から静的コンテンツになります。指定したパスでバケットに保存され、ストレージや CDN から配信されます。Robot の /s3/store は、保存ファイルに設定する headers オブジェクトを受け取ります。また、/video/adaptive は各セグメントとプレイリストに relative_path を割り当て、保存時の配置をプレイリストの参照先と一致させます。これに対し、Smart CDN はオンデマンドで動作し、最初のリクエスト時に結果を生成してキャッシュします。Robot の /file/serve は、ブラウザーと CDN が受け取る Cache-Control ヘッダーを設定し、cache_duration でその値を変更できます。
ページとは異なるオリジン(バケットや CDN のホスト名など)から HLS または MPEG-DASH ファイルを読み込むブラウザープレーヤーでは、ファイルを配信するサーバーに CORS ヘッダーが必要です。必要なヘッダーは /video/adaptive のページに記載されています。エクスポートしたファイルの保存後は、そのキャッシュヘッダーの管理はストレージまたは CDN の責任となります。
出典
- RFC 9111:HTTP キャッシュ(ヒューリスティックな鮮度、認証付きリクエスト、Set-Cookie)
- RFC 9110:HTTP セマンティクス(ETag とコンテンツ符号化された表現のエンティティタグ)
- MDN:HTTP キャッシュ(ヒューリスティックキャッシュ、検証、キャッシュバスティング、メインリソース)
- Cloudflare:デフォルトのキャッシュ動作とキャッシュ対象のファイル拡張子
- nginx: ngx_http_gzip_static_module
- nginx: ngx_http_gzip_module (gzip_vary)
- Apache HTTP Server:mod_deflate (DeflateAlterETag、事前圧縮されたコンテンツ)