imgproxy

imgproxyとは？

imgproxyは、その場で画像処理を行うためのスタンドアロンサーバーです。画像URLに処理パラメータを付与することで、リモート画像のリサイズ、切り抜き、回転、ウォーターマーク追加、フィルタ適用、変換を行い、アプリケーション側で事前にあらゆる画像バリアントを生成する必要をなくします。

自社のインフラと自社の画像ストレージ上で動作するよう設計されています。製品はオープンソースのコアプロジェクトとして提供されており、Pro版では追加の処理オプション、動画・PDF・Photoshopドキュメントのプレビュー生成、その他の拡張機能などの高度な機能が追加されます。

主な機能

• オンザフライの画像リサイズと変換 — 事前に多くのファイルを保存する代わりに、リクエスト時に必要な画像バリアントをそのまま配信できます。
• URLベースの処理オプション — 変換内容と出力形式を画像URLに直接指定でき、CDNやアプリ主導の画像配信フローに適しています。
• セルフホスト型デプロイ — 画像を第三者のSaaSに送るのではなく、自社サーバーや自社インフラ上でimgproxyを運用できます。
• 画像リクエスト向けのセキュリティ制御 — image bombs対策、未承認の変換を防ぐURL署名、キャッシュ配信パスを保護するためのHTTPヘッダー認証を備えています。
• 広範な画像処理サポート — オープンソース版では、リサイズ、切り抜き、回転、ウォーターマーク、フィルタ、カラープロファイル削除、メタデータ削除、PNG量子化、スマートクロップに対応します。
• オープンコアとPro機能の分離 — オープンソース版はGitHubで公開されており、Proでは高度な圧縮、動的ウォーターマーク、動画プレビュー、オブジェクト検出、高度なスマートクロップ、その他の有料機能が追加されます。

imgproxyの使い方

一般的な構成では、まず自分のマシンまたはホスティング環境にDockerイメージかLinuxパッケージとしてimgproxyをインストールします。次に、ストレージ内の画像をアップロードするか参照先を指定し、必要に応じてサーバーを設定したうえで、URLに変換パラメータを追加して処理済み画像をリクエストします。

実際には、アプリケーションまたはフロントエンドが必要なサイズ、形式、変換設定を含む画像URLを生成し、imgproxyが要求に応じて処理結果を返します。

ユースケース

• Webアプリケーション向けのレスポンシブ画像配信 — 複数のバリアントが必要なレイアウト向けに、リクエスト時に異なる画像サイズと形式を生成します。
• プライベートインフラでの画像処理 — 外部サービスにアセットを送信したくない場合に、画像処理を自社環境内に留められます。
• 大量画像ワークロードのコスト管理 — マネージドな画像SaaSをセルフホスト型サーバーに置き換え、処理とスケーリングの判断を自社で管理できます。
• セキュリティ要件のある画像処理 — 署名付きURLとリクエスト認証を使って、悪用や未承認の変換リクエストを抑制します。
• 高度なメディアワークフロー — 動画プレビュー、PDFやPhotoshopドキュメントのプレビュー、高度な圧縮、動的ウォーターマークなどにPro機能を活用できます。

FAQ

imgproxyはセルフホスト型ですか？ はい。ソースでは、imgproxyは自社インフラ上で動作するセルフホスト型の画像処理サーバーとして説明されています。

画像バリアントを事前生成する必要はありますか？ いいえ。imgproxyは、URLパラメータに基づいて画像をオンザフライで処理・変換するよう設計されています。

オープンソース版はありますか？ はい。製品はオープンコアです。オープンソース版はGitHubで公開されており、クローズドソースのPro版もあります。

どの形式と変換に対応していますか？ ソースでは、JPEG、PNG、GIF、WebP、AVIF、JPEG XLなどの一般的な形式に加え、リサイズ、切り抜き、回転、ウォーターマーク、フィルタ、いくつかの最適化機能が挙げられています。

imgproxyはどのようにデプロイしますか？ DockerイメージとLinuxパッケージとして提供されており、ほぼ任意のホスティングサービスやローカルマシン上で動作するよう設計されています。

代替案

• その他のセルフホスト型画像処理ツール — 画像変換を自社インフラ内で実行することに重点を置いた類似ツールで、設定モデルや機能セットが異なる場合があります。
• マネージド画像変換サービス — リサイズや変換を代行するSaaSプラットフォームで、通常はセルフホスト型サーバーより運用上の制御が少なくなります。
• CDNの画像リサイズ機能 — 一部の配信ネットワークが提供するエッジベースの画像処理で、導入を簡単にできますが、同じレベルの処理の深さやデプロイ制御は提供されない場合があります。
• アプリ内のカスタム画像処理パイプライン — アプリのスタックに直接組み込まれたライブラリやサービスで、小規模なワークロードには適している場合がありますが、アプリ側での保守がより必要になります。