imgproxy
画像をリアルタイムでリサイズ、処理、変換するための、高速で安全なスタンドアロンサーバー。
スマートダウンロード
プロジェクトのホームページへ
インストーラはまだありません — ソースリポジトリをご覧ください
画像処理プロキシサーバー。高速かつ安全、Docker でワンクリックデプロイ。
主な機能
- リアルタイムでリサイズ、トリミング、回転、透かしの追加、フィルターの適用
- JPEG / PNG / WebP / AVIF / JPEG XL などの多様なフォーマットに対応
- libvips による超高速処理で、メモリ使用量は極めて低い
- URL 署名、タイプチェック、サイズ制限などのセキュリティ対策
- Docker で数秒で起動可能、設定は最小限
できないこと
- •imgproxy 自体は HTTPS を処理しないため、本番環境では Nginx、CDN、ロードバランサーの後ろに配置することを推奨します。大量の同時接続を処理する場合は、メモリと接続数を適切に設定する必要があり、デフォルト設定では高同時接続のシナリオには不十分な場合があります。Pro 版の多くの高度な機能（ビデオプレビュー、オブジェクト検出など）は有料サブスクリプションが必要です。署名キーは適切に保管してください。漏洩すると、第三者があなたの処理サーバーを悪用する可能性があります。
使用例
- ECサイトの商品画像をリアルタイムでトリミング・最適化
- ソーシャルプラットフォームでさまざまなサイズのアバターとサムネイルを自動生成
- CMSで画像の品質とフォーマットを動的に調整してクライアントに対応
- ImageMagick / GraphicsMagick などのコマンドラインツールの代替
詳細説明
imgproxyは高性能な画像処理サーバーで、画像のリサイズ、切り抜き、回転、フィルター適用、フォーマット変換をリアルタイムで実行できます。アプリケーションと画像ソースの間のプロキシとして機能し、画像処理の作業をすべてこの専用サービスに任せることができます。libvipsライブラリを基盤としており、非常に高速な処理と低いメモリ使用量を実現しています。JPEG、PNG、WebP、AVIF、JPEG XLなど、多様な入出力フォーマットをサポートしています。URL署名、画像タイプの検証、サイズチェック、ソース制限といった強力なセキュリティ機構を内蔵し、悪用を防止します。Dockerを使えば数十秒で起動・実行でき、Webアプリケーションにおける複雑な画像処理コードの理想的な代替手段です。プロジェクトではProバージョンも提供しており、動画プレビュー、オブジェクト検出、SSIMベースの自動品質などの高度な機能が含まれています。
トラブルシューティング & FAQ (2)
トラブル対応最新バージョンにアップグレードした後のimgproxy Dockerコンテナにおけるメモリリークの修正方法
最新のimgproxy Dockerイメージ（sha256:77069360a...を含む）にメモリリークが存在し、メモリ使用量が16GBを超えて急増します。回避策として、バージョン3.30.1（例：イメージタグ imgproxy/imgproxy:3.30.1）にロールバックしてください。恒久的な修正については、問題の監視を続けてください。
トラブル対応phixiv が Pixiv の ugoira リンクで「Broken or unsupported video」というエラーを表示するのはなぜですか？
これは、phixiv が ugoira(Pixiv の動くイラスト作品)の MP4 変換を処理する際の既知のサーバーサイドのバグで、メンテナーによって phixiv の issue #23 で追跡された修正により解決されました。クライアント側での対応は不要です。URL を再リクエストするか、リンクを再投稿(例:Discord)して埋め込みを再生成してください。エラーが解消しない場合は、プロキシされた動画がキャッシュされている可能性があります。キャッシュの有効期限が切れるのを待ってから再試行するか、作品 ID(例:/i/ugoira/<id>.mp4)を記載して phixiv の GitHub リポジトリに新しい issue を作成してください。
タグ
はじめ方
ソフトウェアをインストール
ダウンロードしたインストーラをダブルクリックし、指示に従ってください
ステップ1：Docker がインストールされていることを確認してください
ステップ2：docker run -p 8080:8080 -it ghcr.io/imgproxy/imgproxy:latest を実行します
ステップ3：http://localhost:8080 にアクセスすると画像の処理を開始できます
- ステップ1：Docker がインストールされていることを確認してください
- ステップ2：docker run -p 8080:8080 -it ghcr.io/imgproxy/imgproxy:latest を実行します
- ステップ3：http://localhost:8080 にアクセスすると画像の処理を開始できます
チェックサムがありません
このプロジェクトは GitHub Release ページに SHA-256 チェックサムを公開していません
SHA256 チェックサム
チェックサムなし
GitHub Releases から直接ダウンロードし、ファイルの整合性をご自身で確認してください
本プラットフォーム上のすべての SHA-256 チェックサムは、プロジェクトの公式 GitHub Release ページから抽出されたもので、一切の改変はありません。GitHub Releases ページで独自に検証できます。
オープンソースの透明性
GitHub ソースを見るアンインストール情報
Docker経由で実行している場合は、コンテナを停止してイメージを削除するだけです：docker stop <コンテナ名> && docker rm <コンテナ名> && docker rmi ghcr.io/imgproxy/imgproxy:latest。ソースからコンパイルした場合は、コンパイルディレクトリと関連するサービスファイルを削除してください。
追加の依存関係なし
ダウンロード後すぐに使用可能。追加のランタイムは不要です。
問題が発生？以下のFAQを確認
2 FAQs