Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

概要

最終更新 Markdown で表示Agent セットアップ

変換は、Images の外に保存されているリモート画像を最適化・加工するリクエストです。

Cloudflare 上でアプリケーションを公開するとき、Images を使って任意のオリジンの画像を自動で最適化し、キャッシュできます。

画像最適化パイプラインには、メディアライブラリ全体に適用できる豊富な 機能 があります。大規模な圧縮、配信向けの効率的なフォーマットへの変換、用途やデバイスに合わせたリサイズと切り抜きができます。

仕組み

特別な形式の URL を使って、Cloudflare ゾーン上、または Workers 経由で変換をリクエストできます。

ゾーン上で変換を配信するには、まず機能を有効にします。

  1. Cloudflare ダッシュボードImages > Transformations を開きます。
  2. 変換を配信するゾーンを選択します。
  3. ゾーンで transformations を有効にします。

ブラウザーが変換済み画像をリクエストすると、Cloudflare は同じパラメーターで以前最適化したバージョンがエッジキャッシュにあるかを確認します。

キャッシュヒットの場合 — Cloudflare はオリジンにアクセスせず、最適化パラメーターも再適用せず、エッジから最適化済み画像をそのまま配信します。

キャッシュミスの場合 — Cloudflare はソースオリジンから元画像を取得し、指定されたパラメーター(例: formatwidthquality)を適用し、変換結果をキャッシュしてブラウザーに配信します。元画像もキャッシュし、同じソースの今後の変換を速くします。

ソース画像とパラメーターの組み合わせごとに、キャッシュと課金は別々に扱われます。カレンダー月内の各ユニークバージョンに対する最初のリクエストは、キャッシュの状態に関係なく、1 回の ユニーク変換 として課金されます。同じカレンダー月内の、この変換に対する以降のリクエストは課金対象になりません。

ゾーンの設定

ゾーンで変換を有効にしたあと、Cloudflare が変換リクエストをどう扱うかを設定できます。

  • ソースオリジンを定義する — Cloudflare がソース画像を取得できるオリジンを指定します。デフォルトでは、変換を配信するゾーンと同じゾーンのソース画像だけを受け付けます。
  • 変換フローを作成する — URL の変更やカスタムコードなしで、一致するリクエストに画像最適化を適用する自動ルールを設定します。
  • オリジンへのアクセスを制御する — Workers を使って、ソース画像へのアクセスを検証・制御するカスタムロジックを追加します。
  • リライトルールを設定する — Transform Rules を使って画像 URL を書き換え、カスタムパスから変換を配信します。

役に立ちましたか?