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

Sergey Alexandrovich 0ad85b456b Update CHANGELOG.md vor 6 Jahren
.circleci 4edf226cf8 Run tests in circle vor 6 Jahren
docs 05f6412329 Update docs vor 6 Jahren
examples cca6bdaf06 Update Elixir example (#77) vor 6 Jahren
vendor b66b27bef9 Errors reporting vor 6 Jahren
.dockerignore 2f7eeb9466 Add Dockerfile and .dockerignore to .dockerignore vor 6 Jahren
.gitignore 7c7add8dc1 Enable s3 transport scheme vor 6 Jahren
CHANGELOG.md 0ad85b456b Update CHANGELOG.md vor 6 Jahren
Dockerfile 2c0b538eb5 GIF output support vor 6 Jahren
Gopkg.lock b66b27bef9 Errors reporting vor 6 Jahren
Gopkg.toml ceec679c81 Back to net/http because of fasthttps incompatibiliti with almost everything vor 6 Jahren
LICENSE 0c006ce61e Initial commit vor 8 Jahren
README.md e023c3874d Big badges vor 6 Jahren
app.json 06662561fa Make kay and salt optional in app.json vor 6 Jahren
cmyk_profile.go 070346d155 Fix processing of CMYK without embedded profile vor 7 Jahren
config.go e8845f671b Limit GIF frames to being processed vor 6 Jahren
crypt.go 9114f28c75 Multiple key/salt pairs support vor 6 Jahren
crypt_test.go 9114f28c75 Multiple key/salt pairs support vor 6 Jahren
download.go 917357616e Deprecate IMGPROXY_MAX_SRC_DIMENSION vor 6 Jahren
errors.go 776f57d003 Predefine static errors vor 6 Jahren
errors_reporting.go b66b27bef9 Errors reporting vor 6 Jahren
etag.go ceec679c81 Back to net/http because of fasthttps incompatibiliti with almost everything vor 6 Jahren
gcs_transport.go 00b690e93d Version IDs for S3 and generations for GCS vor 6 Jahren
gzip.go 34a61d287f fasthttp; Optimized memory allocation vor 6 Jahren
heroku.yml d7cc247439 Deploy to Heroku with Docker (#50) vor 7 Jahren
image_types.h c5adf1b3a5 Rename processing options constants and move them to processing_options.go vor 6 Jahren
logo.svg 1e2ee1df22 Logo vor 7 Jahren
main.go 962b4c8f44 Bump version vor 6 Jahren
main_test.go 6b7551213f Tests vor 6 Jahren
newrelic.go dd85087e6a Prometheus metrics vor 6 Jahren
presets.go 6b7551213f Tests vor 6 Jahren
presets_test.go 6b7551213f Tests vor 6 Jahren
process.go e8845f671b Limit GIF frames to being processed vor 6 Jahren
processing_options.go c3852d683d Optimal and correct DPR support vor 6 Jahren
processing_options_test.go 9114f28c75 Multiple key/salt pairs support vor 6 Jahren
prometheus.go 08c9077fe4 Don;t launch Prometheus server if Prometheus binding is not provided vor 6 Jahren
s3transport.go 00b690e93d Version IDs for S3 and generations for GCS vor 6 Jahren
server.go c03a9c69c3 Move health response before semaphore vor 6 Jahren
timer.go dd85087e6a Prometheus metrics vor 6 Jahren
utils.go 8c4a561b9e Focus point gravity vor 6 Jahren
vips.h 5985747aa6 Put vips error when something is not supported just in case vor 6 Jahren
watermark_data.go 3d98a943a4 Watermark vor 6 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 MicroBadger Size Docker Pulls

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.

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.

Documentation

  1. Getting started
  2. Installation
  3. Configuration
  4. Generating the URL
  5. Watermark
  6. Presets
  7. Serving local files
  8. Serving files from Amazon S3
  9. Serving files from Google Cloud Storage
  10. New Relic
  11. Prometheus
  12. Image formats support
  13. About processing pipeline
  14. Health check

Author

Sergey "DarthSim" Alexandrovich

Many thanks to Roman Shamin for the awesome logo.

Great bunch of kudos goes to John Cupitt who develops libvips and helps me to optimize its usage under the hood of imgproxy.

License

imgproxy is licensed under the MIT license.

See LICENSE for the full license text.