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

DarthSim 1ab981ef11 Fix BMP with <8 BPP vor 3 Jahren
.circleci 59a1db3dc2 Fix autorelease vor 3 Jahren
.github 7285c3bd7d Add Github action to notify imgproxy-helm about updates (#634) vor 4 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 16c0d91d47 Add ETag buster vor 3 Jahren
cookies d8bedfd930 Polish cookies passthrough vor 3 Jahren
docker 995eecd264 Use numeric user in Dockerfile vor 3 Jahren
docs 3e87bd683c Offsets for replicated watermarks 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 6 Jahren
ierrors b98919ead4 Better downloading error reporting cause vor 3 Jahren
imagedata abbfb61ce6 Add option to pass through incoming cookies in the image request. vor 3 Jahren
imagemeta 7709b74a5e Bump version vor 3 Jahren
imagetype 2ae2a539fe Escape quotes in content disposition vor 3 Jahren
imath 2ea1466d96 Global refactoring vor 4 Jahren
logger 7709b74a5e Bump version 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 c2ea40b240 Detect deprecated basic URL format vor 3 Jahren
processing 3e87bd683c Offsets for replicated watermarks 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 91e0ee6be7 Fix ETag+S3 vor 3 Jahren
version 7e5587ae69 Bump version vor 3 Jahren
vips 1ab981ef11 Fix BMP with <8 BPP vor 3 Jahren
.dockerignore bda7e1e53d Use golang:1-alpine3.10 for docker build vor 5 Jahren
.gitignore 77d7e8f4c3 Update .gitignore vor 5 Jahren
.golangci.yml 2ea1466d96 Global refactoring vor 4 Jahren
BENCHMARK.md cee746a1ee Update BENCHMARK.md (#505) vor 4 Jahren
CHANGELOG.md 1ab981ef11 Fix BMP with <8 BPP vor 3 Jahren
LICENSE 0c006ce61e Initial commit vor 8 Jahren
NOTICE e781ea2019 Add CGIF to NOTICE vor 3 Jahren
README.md 7cdb89c68b Fix link to Alexander Madyankin's github (#699) vor 3 Jahren
app.json 1934025bc7 Fix logo in app.json vor 6 Jahren
cgo_symbolizer.go 82c6718edb Combine new & old build contraints format vor 3 Jahren
go.mod 94f37677c1 Update deps vor 3 Jahren
go.sum 94f37677c1 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 6 Jahren
landing.go 8f062a43ee Fix typo in response header name (#693) vor 3 Jahren
lefthook.yml 749924b2bd Add lefthook vor 6 Jahren
logo.svg f0bd65aabf Optimize logo vor 6 Jahren
main.go 0f7b8790ce Proper cli command detection vor 3 Jahren
netlify.toml 46e655e1ba Netlify docs vor 4 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 b5863c808b Move metrics.StartRequest to middleware && Fix Datadog 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">

CircleCI branch Docker Docker Pulls Gitter

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

imgproxy can be used to provide a fast and secure way to replace all the image resizing code of your web application (like calling ImageMagick or GraphicsMagick, or using libraries), while also being able to resize everything on the fly, fast and easy. imgproxy is also indispensable when handling lots of image resizing, especially when images come from a remote source.

imgproxy does one thing — resizing remote images — and does it well. It works great when you need to resize multiple images on the fly to make them match your application design without preparing a ton of cached resized images or re-doing it every time the design changes.

imgproxy is a Go application, ready to be installed and used in any Unix environment — also ready to be containerized using Docker.

See this article for a good intro and all the juicy details! 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 uses probably the most efficient image processing library there is, called libvips. It is screaming fast and has a very low memory footprint; with it, we can handle the processing for a massive amount of images on the fly.

imgproxy also uses native Go's net/http routing for the best HTTP networking support.

You can see benchmarking results and comparison with some well-known alternatives in our benchmark report.

Security

Massive processing of remote images is a potentially dangerous thing, security-wise. There are many attack vectors, so it is a good idea to consider attack prevention measures first. Here is how imgproxy can help:

  • imgproxy checks image type and "real" dimensions when downloading, so the image will not be fully downloaded if it has an unknown format or the dimensions are too big (there is a setting for that). That is how imgproxy protects you from so called "image bombs" like those described at https://www.bamsoftware.com/hacks/deflate.html.

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

  • imgproxy supports authorization by an HTTP header. That prevents using imgproxy directly by an attacker but allows to use it through a CDN or a caching server — just 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.