Cloudflare Images

解決する課題

Webサイトやアプリで画像を扱う場合、端末やレイアウトごとに異なるサイズ・形式の画像を用意する必要があり、自前で対応しようとすると変換用のサーバーやジョブ、保存先ストレージ、配信用のCDN設定までを一通り構築・運用しなければなりません。Cloudflare Imagesは、この画像の保存・変換・配信を一体化したマネージド基盤として提供します。

• 元画像を1枚アップロードするだけで、リサイズ・形式変換・最適化をオンデマンドに行える
• 端末の画面幅や対応形式に応じて、軽量な画像を自動選択して配信できる
• 画像専用のオリジンサーバーやリサイズ用ミドルウェアを自前で運用しなくてよい
• ユーザーがアップロードした画像（アバターや商品写真など）を、直接アップロードの仕組みで安全に受け取れる

画像処理基盤の構築・スケーリング・キャッシュ設計をCloudflare側に任せられる点が中心的な価値です。

主要概念と用語

• バリアント（Variant）: 幅・高さ・トリミング方法・画質などをあらかじめ定義した、画像の出力パターン。同じ元画像から用途別の複数バリアントを配信できる
• フレキシブルバリアント: バリアント名を事前定義せず、配信時にURLへ直接オプションを指定して変換する方式
• 直接アップロード（Direct Creator Upload）: サーバーを経由せず、エンドユーザーのブラウザから直接Cloudflare Imagesへ画像をアップロードできる仕組み
• 画像ID: アップロードした画像を一意に識別するID。配信URLの組み立てに使う
• 配信URL: 画像ID・バリアント・アカウントハッシュなどから構成される、変換済み画像を取得するためのURL
• 署名付きURL: 非公開の画像に対して、有効期限付きの署名を付けアクセスを制限する仕組み
• Images Transformations: 既存のオリジン（R2やその他のURL）にある画像を、配信時にオンザフライで変換する機能。保存先をCloudflare Imagesに移さずに変換だけを使える

仕様・制限・クォータ

• 対応する主要な画像形式（JPEG、PNG、WebP、GIFなど）のアップロードと、配信時の自動形式変換（WebP・AVIFなど）に対応する
• リサイズ、トリミング、回転、画質調整といった基本的な変換操作をURLパラメータやバリアント設定で指定できる
• アップロードできる画像1枚あたりのファイルサイズや、アカウントあたりの保存枚数には上限があり、プランによって異なる
• バリアント数やAPIのリクエストレートにも制限があり、詳細な数値は公式ドキュメントで随時更新される
• メタデータ（EXIFなど）の取り扱いは、配信時に既定で一部が取り除かれる設定になっている

具体的な上限値やプランごとの違いは変更されうるため、最新の公式ドキュメントで確認してください。

内部の仕組み

利用者から見ると、画像をアップロードすると画像IDが払い出され、その画像IDとバリアント指定を含む配信URLへアクセスするたびに、Cloudflareのエッジ上で変換済み画像が返る仕組みです。

• 保存: アップロードされた元画像はCloudflareの分散ストレージに保管される
• 変換: 配信リクエストを受けたエッジは、指定されたバリアント（サイズ・形式・画質など）に応じて元画像から変換後の画像を生成する
• キャッシュ: 一度生成した変換済み画像はエッジにキャッシュされ、同じバリアントへの再リクエストはキャッシュから高速に返される
• 形式の自動選択: リクエストしたブラウザが対応する形式（AVIF・WebPなど）を判定し、より軽量な形式を自動的に選んで配信する

変換処理はリクエストが来た際にオンデマンドで行われるため、あらかじめ全バリアントを生成しておく必要はありません。

設計パターン / ベストプラクティス

• レスポンシブ画像配信: 画面幅ごとに複数バリアントを用意し、HTMLの候補画像指定（srcset相当）と組み合わせて端末に応じた画像を配信する
• ユーザー投稿画像の受け口: 直接アップロードを使い、サーバーを経由せずブラウザから安全にアップロードさせてバックエンドの負荷を減らす
• 既存オリジンの画像最適化: 画像自体はR2や外部URLに置いたまま、Images Transformationsで配信時だけ変換し、移行コストを抑える
• 非公開画像の制限配信: 会員限定コンテンツなどは署名付きURLを使い、有効期限のあるアクセスに限定する

運用・監視

• アップロード数・配信数・エラー状況はダッシュボードで確認できる
• 画像の削除やメタデータの更新はAPI経由で行い、CI/CDやバックエンド処理に組み込める
• 配信が想定より重い・キャッシュヒットしない場合は、バリアントの組み合わせ数やキャッシュ設定を見直す
• アップロード失敗やアクセスエラーが出る場合は、APIトークンの権限範囲やファイルサイズ制限を最初に確認する

コスト

課金の考え方は、保存している画像枚数と、配信（変換）された回数の両方に基づく従量制が基本です。元画像1枚から複数バリアントを配信しても保存枚数自体は増えませんが、配信数はバリアントごとのアクセス数に応じて積み上がります。具体的な単価や無料枠は変動するため、最新の料金ページで確認してください。

セキュリティ

• 非公開にしたい画像は、配信URLを署名付きURLにして有効期限とアクセス範囲を制限する
• アップロード・削除などの管理操作はAPIトークンのスコープで制御し、最小権限に絞る
• 直接アップロードを使う場合も、発行するアップロードURL自体に有効期限があり、無制限に使い回されない設計になっている
• 保存データは暗号化された状態で管理され、配信経路もTLSで保護される

関連サービス・比較

汎用オブジェクトストレージであるR2とは役割が異なるため比較します。R2は任意のファイルをそのまま保存・配信するのに対し、Cloudflare Imagesは画像に特化し、リサイズや形式変換までを組み込みで提供します。

ハンズオン / CLI例

# wranglerでログインし、アカウントを認証
npx wrangler login

# ローカルの画像ファイルをCloudflare Imagesへアップロード
npx wrangler images upload ./photo.jpg

# アップロード済み画像の一覧を確認
npx wrangler images list

# 指定した画像を削除
npx wrangler images delete <image-id>