imgproxy

A fast, secure image processing proxy. Resize, crop, convert, and optimize images on the fly by changing the URL — no need to pre-generate thumbnails or run batch jobs.

What You Can Do After Deployment

imgproxy processes images via URL-based commands. Point it at any image source and transform on the fly.

Resizing and cropping: Generate thumbnails, fit images to specific dimensions, smart-crop to focus on faces or objects, pad with background color.

Format conversion: Serve WebP or AVIF to supported browsers automatically. Convert between JPEG, PNG, GIF, TIFF, BMP, ICO, SVG, HEIC, and 30+ formats.

Optimization: Strip metadata, adjust quality, apply Gaussian blur or sharpen. Serve optimized images without touching your originals.

Security: Sign URLs with IMGPROXY_KEY and IMGPROXY_SALT to prevent abuse. Only signed requests are processed when configured.

Sources: Load images from HTTP(S) URLs, S3-compatible storage, Google Cloud Storage, or Azure Blob Storage.

Configuration

• URL signing: Set IMGPROXY_KEY and IMGPROXY_SALT (hex-encoded) to require signed URLs. Without these, all requests are accepted.
• Quality: IMGPROXY_QUALITY sets default JPEG quality (default: 80)
• Max source size: IMGPROXY_MAX_SRC_RESOLUTION limits input image resolution in megapixels (default: 16.8)
• Allowed sources: IMGPROXY_ALLOWED_SOURCES restricts which image URLs can be processed

Usage Example

https://<your-domain>/unsafe/rs:fill:300:200/plain/https://example.com/image.jpg@webp

This resizes the image to 300x200 (fill mode) and converts to WebP format.

License

MIT — GitHub