超好用的图片处理工具,可配合minio实现如阿里云的图片处理查询

DarthSim ff75f9589b Update badges in README vor 3 Jahren
.github 5483efe27c Release with GH actions vor 3 Jahren
.lefthook 8e69236b6b Always run tests on push vor 5 Jahren
bufpool 7709b74a5e Bump version vor 3 Jahren
bufreader 7709b74a5e Bump version vor 3 Jahren
config df818706c2 IMGPROXY_HEALTH_CHECK_PATH config vor 3 Jahren
cookies d8bedfd930 Polish cookies passthrough vor 3 Jahren
docker 7e3b838c45 Use native Go in Docker build vor 3 Jahren
docs df818706c2 IMGPROXY_HEALTH_CHECK_PATH config vor 3 Jahren
errorreport 7709b74a5e Bump version vor 3 Jahren
etag 16c0d91d47 Add ETag buster vor 3 Jahren
examples 5ed71c6b60 Merge branch 'master' into version/3 vor 4 Jahren
heroku 6ce4201bb0 Add build arg to Heroku Dockerfile vor 5 Jahren
ierrors b98919ead4 Better downloading error reporting cause vor 3 Jahren
imagedata ec02fc53a5 IMGPROXY_MAX_REDIRECTS config (#797) vor 3 Jahren
imagemeta 175cb8c41b Fix transparrency in loaded ICO vor 3 Jahren
imagetype 2ae2a539fe Escape quotes in content disposition vor 3 Jahren
imath 7a968d5fed Crop between scale-on-load and scale vor 3 Jahren
logger a8293461e6 Write logs to STDOUT instead of STDERR vor 3 Jahren
memory 82c6718edb Combine new & old build contraints format vor 3 Jahren
metrics b5863c808b Move metrics.StartRequest to middleware && Fix Datadog vor 3 Jahren
options fff164f45a Add zoom option vor 3 Jahren
processing fff164f45a Add zoom option vor 3 Jahren
reuseport 82c6718edb Combine new & old build contraints format vor 3 Jahren
router e43c24c544 Start requiest timer in router vor 3 Jahren
security 7709b74a5e Bump version vor 3 Jahren
structdiff 70840467d0 format_quality processing option vor 3 Jahren
testdata 2ea1466d96 Global refactoring vor 4 Jahren
transport 3c44af8d4e Fix and improve S3 transport vor 3 Jahren
version d57a268d01 Bump version vor 3 Jahren
vips 175cb8c41b Fix transparrency in loaded ICO vor 3 Jahren
.dockerignore 7e3b838c45 Use native Go in Docker build vor 3 Jahren
.gitignore b75b6cb5a2 Add robots.txt and sitemap.txt vor 3 Jahren
.golangci.yml 2ea1466d96 Global refactoring vor 4 Jahren
BENCHMARK.md cee746a1ee Update BENCHMARK.md (#505) vor 4 Jahren
CHANGELOG.md 29b52da173 Update changelog vor 3 Jahren
LICENSE 0c006ce61e Initial commit vor 7 Jahren
NOTICE e781ea2019 Add CGIF to NOTICE vor 3 Jahren
README.md ff75f9589b Update badges in README vor 3 Jahren
app.json 1934025bc7 Fix logo in app.json vor 5 Jahren
build-docs-sitemap.sh b75b6cb5a2 Add robots.txt and sitemap.txt vor 3 Jahren
cgo_symbolizer.go 82c6718edb Combine new & old build contraints format vor 3 Jahren
cloudbuild.yaml 3997a0fea0 Configure cloudbuild logging vor 3 Jahren
go.mod 154c8768e6 Update deps vor 3 Jahren
go.sum 154c8768e6 Update deps vor 3 Jahren
healthcheck.go 1d3706d56c Fix health command when path prefix is set vor 3 Jahren
heroku.yml 6ce4201bb0 Add build arg to Heroku Dockerfile vor 5 Jahren
landing.go 8f062a43ee Fix typo in response header name (#693) vor 3 Jahren
lefthook.yml 749924b2bd Add lefthook vor 5 Jahren
logo.svg f0bd65aabf Optimize logo vor 5 Jahren
main.go 0f7b8790ce Proper cli command detection vor 3 Jahren
netlify.toml b75b6cb5a2 Add robots.txt and sitemap.txt vor 3 Jahren
pprof.go 82c6718edb Combine new & old build contraints format vor 3 Jahren
processing_handler.go b5863c808b Move metrics.StartRequest to middleware && Fix Datadog vor 3 Jahren
processing_handler_test.go 749d29bf44 Stabilize etag tests vor 3 Jahren
server.go df818706c2 IMGPROXY_HEALTH_CHECK_PATH config vor 3 Jahren

README.md

imgproxy

<img align="right" width="200" height="200" title="imgproxy logo"

 src="https://cdn.rawgit.com/DarthSim/imgproxy/master/logo.svg">

GH Test GH Lint Docker Docker Pulls Gitter

imgproxy is a fast and secure standalone server for resizing and converting remote images. The guiding principles behind imgproxy are security, speed, and simplicity.

imgproxy is able to quickly and easily resize images on the fly, and it's well-equipped to handle a large amount of image resizing. imgproxy is a fast, secure replacement for all the image resizing code inside your web application (such as resizing libraries, or code that calls ImageMagick or GraphicsMagic). It's also an indispensable tool for processing images from a remote source. With imgproxy, you don’t need to repeatedly prepare images to fit your design every time it changes.

To get an even better introduction, and to dive deeper into the nitty gritty details, check out this article: imgproxy: Resize your images instantly and securely

Sponsored by Evil Martians

Simplicity

"No code is better than no code."

imgproxy only includes the must-have features for image processing, fine-tuning and security. Specifically,

  • It would be great to be able to rotate, flip and apply masks to images, but in most of the cases, it is possible — and is much easier — to do that using CSS3.
  • It may be great to have built-in HTTP caching of some kind, but it is way better to use a Content-Delivery Network or a caching proxy server for this, as you will have to do this sooner or later in the production environment.
  • It might be useful to have everything built in — such as HTTPS support — but an easy way to solve that would be just to use a proxying HTTP server such as nginx.

Speed

imgproxy takes advantage of probably the most efficient image processing library out there – libvips. It’s scary fast and comes with a very low memory footprint. Thanks to libvips, we can readily and extemporaneously process a massive amount of images.

imgproxy uses Go’s raw (no wrappers) native net/http package to omit any overhead while processing requests and provides the best possible HTTP support.

You can take a look at some benchmarking results and compare imgproxy with some well-known alternatives in our benchmark report.

Security

In terms of security, the massive processing of remote images is a potentially dangerous endeavor. There are a number of possible attack vectors, so it’s a good idea to take an approach that considers attack prevention measures as a priority. Here’s how imgproxy does this:

  • imgproxy checks the image type and its “real” dimensions when downloading. The image will not be fully downloaded if it has an unknown format or if the dimensions are too big (you can set the max allowed dimensions). This is how imgproxy protects from so called "image bombs”, like those described in this doc.

  • imgproxy protects image URLs with a signature, so an attacker cannot enact a denial-of-service attack by requesting multiple image resizes.

  • imgproxy supports authorization by HTTP header. This prevents imgproxy from being used directly by an attacker, but allows it to be used via a CDN or a caching server — simply by adding a header to a proxy or CDN config.

Usage

Check out our 📑 Documentation.

Author

Sergey "DarthSim" Alexandrovich

Special thanks

Many thanks to:

License

imgproxy is licensed under the MIT license.

See LICENSE for the full license text.

Security Contact

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.