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

DarthSim 68fd0491e1 Require Go 1.11 in go.mod 5 年 前
.circleci aab48b0e76 Fix CircleCI; Bump Go version in CircleCI 5 年 前
.lefthook 83c00a9e2b Fix git hooks 5 年 前
docker 03e755988b Correct path name and rearrange to make the build more efficient 6 年 前
docs 5efed836dd Typo 6 年 前
examples d3371e95b7 adds truncated signature example for PHP (#131) 6 年 前
heroku 6ce4201bb0 Add build arg to Heroku Dockerfile 6 年 前
.dockerignore 2f7eeb9466 Add Dockerfile and .dockerignore to .dockerignore 6 年 前
.gitignore 71e720c625 Ignore .tmp 6 年 前
.golangci.yml aa2e8bd90e Better linter settings + linting errors fix 5 年 前
BENCHMARK.md c5263b1752 Add benchmark results 6 年 前
CHANGELOG.md e6deed2b0a Bump version 6 年 前
LICENSE 0c006ce61e Initial commit 8 年 前
README.md c5263b1752 Add benchmark results 6 年 前
app.json 1934025bc7 Fix logo in app.json 6 年 前
bufpool.go aa2e8bd90e Better linter settings + linting errors fix 5 年 前
c_strings.go fa224981af Extract Vips stuff into vips.go and CString stuff into c_strings.go 6 年 前
cmyk_profile.go ed795675be Refactored logging; Syslog support 6 年 前
config.go aa2e8bd90e Better linter settings + linting errors fix 5 年 前
crypt.go 2209063ce3 Token => signature 6 年 前
crypt_test.go 9114f28c75 Multiple key/salt pairs support 6 年 前
download.go aa2e8bd90e Better linter settings + linting errors fix 5 年 前
errors.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
errors_reporting.go 12b59c3796 Better Sentry support 6 年 前
etag.go 3d13e6afb2 Back to net/http 6 年 前
fs_transport.go 8870d8dbd1 Simple filesystem transport 6 年 前
gcs_transport.go aa2e8bd90e Better linter settings + linting errors fix 5 年 前
go.mod 68fd0491e1 Require Go 1.11 in go.mod 5 年 前
go.sum f7aede3b6c Use github.com/apache/thrift instead of git.apache.org/thrift.git 5 年 前
gzippool.go 6007f1a99b Reset gzip encoder on put to pool 6 年 前
heic.go 69594894a0 Fix lint issues 6 年 前
heroku.yml 6ce4201bb0 Add build arg to Heroku Dockerfile 6 年 前
ico_data.go 4bd7b72c7a Fix lint 5 年 前
image_type.go 2a92243e47 Add Content-Disposition filename customization 6 年 前
landing.go 337bb38a16 Favicon dummy handler & hello message at the root 6 年 前
lefthook.yml 749924b2bd Add lefthook 6 年 前
listen_no_reuseport.go c76696caf7 SO_REUSEPORT support 6 年 前
listen_reuseport.go c76696caf7 SO_REUSEPORT support 6 年 前
log.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
log_formatter.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
logo.svg f0bd65aabf Optimize logo 6 年 前
main.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
main_test.go 3ae859162f Get rid of init() in config.go 6 年 前
newrelic.go 3d13e6afb2 Back to net/http 6 年 前
pprof.go 518607f259 Require pprof build tag to enable net/pprof 6 年 前
presets.go 6b7551213f Tests 6 年 前
presets_test.go ee54296249 Fix options rewrite 6 年 前
process.go 53805e482a DRY some calculations 5 年 前
processing_handler.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
processing_options.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
processing_options_test.go 1cbc4eb973 More verbose path parsing errors 6 年 前
prometheus.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
router.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
s3transport.go d5b7e2aa13 Lint with golangci-lint; Fix linter issues; Add Go 1.12 to CircleCI 6 年 前
server.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
svg.go 4f2f20c089 improve svg format detection (#135) 6 年 前
syslog.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
timer.go 16784fb1e2 New logging; JSON and structured log formats 5 年 前
utils.go 53805e482a DRY some calculations 5 年 前
vips.c e3c461bc8a Watermarking with vips_composite 5 年 前
vips.go f30e065a96 Disable vector (orc causes random segfaults) 5 年 前
vips.h f30e065a96 Disable vector (orc causes random segfaults) 5 年 前
watermark_data.go 8cef2ee3b2 Better watermarking 6 年 前
webp.go aa2e8bd90e Better linter settings + linting errors fix 5 年 前

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.

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.

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
  15. Memory usage tweaks

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.