ImageFlux

CDNとImageFluxを併用したい

対象プラン

ImageFlux

本マニュアルでは、外部のCDNとImageFluxを併用する際の構成やキャッシュの考え方を説明します。

ポイント

ImageFluxは、画像の変換・最適化からキャッシュ配信までを提供する画像CDNサービスです。

画像の配信はImageFlux単体で行えますが、既存のCDN環境を維持したい場合や、画像以外のコンテンツも含めて配信・管理したい場合などには、外部CDNと組み合わせて利用できます。

CDNとの構成

ImageFluxの前段にCDNを配置し、ImageFluxをCDNのオリジンサーバーとして利用できます。この構成では、CDNとImageFluxの両方でキャッシュが利用されます。

キャッシュ期間(TTL)

ImageFluxは、オリジンサーバーが返すCache-Controlヘッダをもとに、キャッシュ期間を決定します。

オリジンサーバーで設定したキャッシュ期間が、CDNとImageFluxの両方に適用されます(前段にCDNが存在する場合、一般的にはCDN側も同じCache-Controlヘッダを参照するため)。

例

オリジンサーバーが次のヘッダを返す場合、双方で1時間キャッシュされることがあります。

Cache-Control:s-maxage=3600

※CDN側の設定によっては、ImageFluxと異なるキャッシュ期間が適用されます。

キャッシュキーについて

ImageFluxは、スキーム(http://またはhttps://)を除くURL全体をキャッシュキーとして使用します。

そのため、CDN 側でクエリパラメータをキャッシュキーから除外している場合、CDN と ImageFlux でキャッシュキーの解釈が異なる可能性があります。

次のURLは、ImageFluxでは別のキャッシュとして扱われます。

image.jpg?v=1

image.jpg?v=2

CDNがクエリパラメータをキャッシュキーに含めない場合は、同じキャッシュとして扱われることがあります。キャッシュバスターを利用する場合は、対象のクエリパラメータをCDN側のキャッシュキーにも含めてください。

キャッシュ削除

ImageFluxではキャッシュ削除APIを提供していますが、本APIで削除できるのはImageFlux内部のキャッシュのみです。前段のCDNにもキャッシュがある場合は、CDN側のキャッシュも削除してください。

ImageFlux側のキャッシュを無効にする場合

ImageFluxを画像変換エンジンとして利用し、CDN側だけでキャッシュを保持する場合は、ImageFluxのデフォルトキャッシュ期間を0秒に設定します。

ただし、オリジンサーバーがCache-ControlヘッダまたはExpiresヘッダでキャッシュ期間を指定している場合は、オリジンサーバー側の設定が優先されます。

なお、運用上はTTLを0秒にせず、短時間でもImageFlux側にキャッシュを保持することを推奨します。以下のような状況でオリジンサーバー負荷の軽減が期待できるためです。

  • CDN のキャッシュ失効時

  • 一時的なアクセス集中時

  • CDN 障害時のフォールバック時

ブラウザに応じた画像フォーマットの配信

f=webp:autoやf=webp:jpegなどの代替フォーマットを指定すると、ImageFluxはクライアントから送信されるAcceptヘッダに応じて画像フォーマットを切り替えます。

CDNがAcceptヘッダによるレスポンスの違いを考慮しない場合、異なるブラウザ間で同じキャッシュが使用され、未対応の画像フォーマットが配信される可能性があります。

代替フォーマットを指定する場合は、CDN側のVaryヘッダとキャッシュキーの設定を確認してください。

また、ブラウザの対応状況に応じて、f=webpなどを使用し、画像フォーマットを明示的に指定する方法もあります。

>ブラウザに応じた画像フォーマット配信について知りたい

画像変換に対応していないファイル形式の配信

through=autoを指定すると、ImageFluxが画像変換に対応していない形式のファイルを(SVGなど)そのまま配信できます。

注意事項

今後、対応フォーマットが追加された際に挙動が変わる可能性があります。継続的な互換性を保証していないため、詳しくは画像フォーマットによる除外をご参照ください。

本マニュアルでは、外部のCDNとImageFluxを併用する際の構成やキャッシュの考え方を説明します。

ポイント

ImageFluxは、画像の変換・最適化からキャッシュ配信までを提供する画像CDNサービスです。

画像の配信はImageFlux単体で行えますが、既存のCDN環境を維持したい場合や、画像以外のコンテンツも含めて配信・管理したい場合などには、外部CDNと組み合わせて利用できます。

CDNとの構成

ImageFluxの前段にCDNを配置し、ImageFluxをCDNのオリジンサーバーとして利用できます。この構成では、CDNとImageFluxの両方でキャッシュが利用されます。

キャッシュ期間(TTL)

ImageFluxは、オリジンサーバーが返すCache-Controlヘッダをもとに、キャッシュ期間を決定します。

オリジンサーバーで設定したキャッシュ期間が、CDNとImageFluxの両方に適用されます(前段にCDNが存在する場合、一般的にはCDN側も同じCache-Controlヘッダを参照するため)。

例

オリジンサーバーが次のヘッダを返す場合、双方で1時間キャッシュされることがあります。

Cache-Control:s-maxage=3600

※CDN側の設定によっては、ImageFluxと異なるキャッシュ期間が適用されます。

キャッシュキーについて

ImageFluxは、スキーム(http://またはhttps://)を除くURL全体をキャッシュキーとして使用します。

そのため、CDN 側でクエリパラメータをキャッシュキーから除外している場合、CDN と ImageFlux でキャッシュキーの解釈が異なる可能性があります。

次のURLは、ImageFluxでは別のキャッシュとして扱われます。

image.jpg?v=1

image.jpg?v=2

CDNがクエリパラメータをキャッシュキーに含めない場合は、同じキャッシュとして扱われることがあります。キャッシュバスターを利用する場合は、対象のクエリパラメータをCDN側のキャッシュキーにも含めてください。

キャッシュ削除

ImageFluxではキャッシュ削除APIを提供していますが、本APIで削除できるのはImageFlux内部のキャッシュのみです。前段のCDNにもキャッシュがある場合は、CDN側のキャッシュも削除してください。

ImageFlux側のキャッシュを無効にする場合

ImageFluxを画像変換エンジンとして利用し、CDN側だけでキャッシュを保持する場合は、ImageFluxのデフォルトキャッシュ期間を0秒に設定します。

ただし、オリジンサーバーがCache-ControlヘッダまたはExpiresヘッダでキャッシュ期間を指定している場合は、オリジンサーバー側の設定が優先されます。

なお、運用上はTTLを0秒にせず、短時間でもImageFlux側にキャッシュを保持することを推奨します。以下のような状況でオリジンサーバー負荷の軽減が期待できるためです。

  • CDN のキャッシュ失効時

  • 一時的なアクセス集中時

  • CDN 障害時のフォールバック時

ブラウザに応じた画像フォーマットの配信

f=webp:autoやf=webp:jpegなどの代替フォーマットを指定すると、ImageFluxはクライアントから送信されるAcceptヘッダに応じて画像フォーマットを切り替えます。

CDNがAcceptヘッダによるレスポンスの違いを考慮しない場合、異なるブラウザ間で同じキャッシュが使用され、未対応の画像フォーマットが配信される可能性があります。

代替フォーマットを指定する場合は、CDN側のVaryヘッダとキャッシュキーの設定を確認してください。

また、ブラウザの対応状況に応じて、f=webpなどを使用し、画像フォーマットを明示的に指定する方法もあります。

>ブラウザに応じた画像フォーマット配信について知りたい

画像変換に対応していないファイル形式の配信

through=autoを指定すると、ImageFluxが画像変換に対応していない形式のファイルを(SVGなど)そのまま配信できます。

注意事項

今後、対応フォーマットが追加された際に挙動が変わる可能性があります。継続的な互換性を保証していないため、詳しくは画像フォーマットによる除外をご参照ください。

お問い合わせ

上記をご確認いただいても問題が
解決しなかった場合、
下記リンク先よりお問い合わせください。

お問い合わせはこちら