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

Viktor Sokolov aeed1eef55 Removed old stream.go 1 ヶ月 前
.devcontainer e14e054471 DownloadSync/DownloadAsync (#1480) 1 ヶ月 前
.github a95c0bcd66 Use clang-format-20 on CI 2 ヶ月 前
.lefthook aa91342686 IMG-33: adds simple integration tests for image.Load() (#1462) 2 ヶ月 前
assets d74ba05dcd New logo 4 ヶ月 前
asyncbuffer d38720a0b8 Wrap asyncbuffer and imageDataAsyncBuffer errors 1 ヶ月 前
bufreader c95725b12f Don't use io.ReadFull in io.Reader wrappers 1 ヶ月 前
config 2236bd8170 IMG-23: replace an old imagetype with the new one (#1482) 1 ヶ月 前
cookies 3550042a16 Apply new errors processing to more code parts 7 ヶ月 前
docker 4d487c2503 Update base Docker image 2 ヶ月 前
docs 92d88fbfbd Docs were moved to https://github.com/imgproxy/imgproxy-docs 1 年間 前
errorreport 6b7b3e9179 Replace `*ierrors.Error` with actual data type in Sentry and Honeybadger integrations 7 ヶ月 前
etag f7a13c99de IMG-13: separate http.Headers from ImageData (#1475) 2 ヶ月 前
examples e4bf5e93fb add javascript example for truncated signature (#163) 1 年間 前
gliblog 7111083649 Use clang-format style in C files 2 年 前
handlers 31b31b5059 guard clause SetIsFallbackImage 1 ヶ月 前
headerwriter 31b31b5059 guard clause SetIsFallbackImage 1 ヶ月 前
heroku 5b8c8f2516 Move Docker images to GitHub Container Registry 11 ヶ月 前
httpheaders 56342b404b Added existing TTL check to SetIsFallbackImage 1 ヶ月 前
httprange 95e7584c9a chore: fix some typos in comments (#1272) 1 年間 前
ierrors 15bd00b221 IMG-51: router -> server ns, handlers ns, added error to handler ret val (#1494) 1 ヶ月 前
imagedata 3f205451c7 Use imagefetcher.WrapError in wrapDownloadError 1 ヶ月 前
imagefetcher e14e054471 DownloadSync/DownloadAsync (#1480) 1 ヶ月 前
imagemeta 09a25f8966 IMG-23: Replace imagemeta with imagedetect (#1483) 1 ヶ月 前
imagetype f23cf5b2f9 Merge branch 'master' into version/4 1 ヶ月 前
imath d47eeee6ad IMG-44: move skip to processing, remove imath.Min/Max (#1485) 1 ヶ月 前
integration aa91342686 IMG-33: adds simple integration tests for image.Load() (#1462) 2 ヶ月 前
ioutil c95725b12f Don't use io.ReadFull in io.Reader wrappers 1 ヶ月 前
k6 7f9ec5a5bd k6: Check that body size is not NaN before metering it 1 年間 前
logger 46ba23a775 Sort log keys by both priority and name; Add priority for "source" key 1 ヶ月 前
memory 82c6718edb Combine new & old build contraints format 3 年 前
monitoring 697c2ddcd6 IMG-52: rename metrics to monitoring (#1498) 1 ヶ月 前
options 2236bd8170 IMG-23: replace an old imagetype with the new one (#1482) 1 ヶ月 前
processing 08d20d46e6 Merge branch 'master' into version/4 1 ヶ月 前
reuseport 15bd00b221 IMG-51: router -> server ns, handlers ns, added error to handler ret val (#1494) 1 ヶ月 前
security d47eeee6ad IMG-44: move skip to processing, remove imath.Min/Max (#1485) 1 ヶ月 前
server f46ff196cb StreamHandler 1 ヶ月 前
structdiff 0bf347b1fe Refactor `structdiff` package 7 ヶ月 前
svg d47eeee6ad IMG-44: move skip to processing, remove imath.Min/Max (#1485) 1 ヶ月 前
testdata aa91342686 IMG-33: adds simple integration tests for image.Load() (#1462) 2 ヶ月 前
testutil efbea5fde5 New imagedata interface (#1471) 2 ヶ月 前
transport dd3b430f87 transport isolated, imagefetcher introduced (#1465) 2 ヶ月 前
version 07b5842191 Bump version 2 ヶ月 前
vips 697c2ddcd6 IMG-52: rename metrics to monitoring (#1498) 1 ヶ月 前
.air.toml 01439f43b0 IMG-37: improve OSS .devcontainer (#1460) 2 ヶ月 前
.clang-format 7111083649 Use clang-format style in C files 2 年 前
.dockerignore 7e3b838c45 Use native Go in Docker build 3 年 前
.gitignore aa91342686 IMG-33: adds simple integration tests for image.Load() (#1462) 2 ヶ月 前
.gitmodules aa91342686 IMG-33: adds simple integration tests for image.Load() (#1462) 2 ヶ月 前
.golangci.yml 43bd1d73e1 Migrate to golangci-lint v2 6 ヶ月 前
BENCHMARK.md 40aaf353ac Replace old benchmark results with a link to the blog article with new results 1 年間 前
CHANGELOG.md f50176f95b TIFF supports color profiles 1 ヶ月 前
LICENSE 0c006ce61e Initial commit 8 年 前
NOTICE d1c607bdc1 Add Highway to NOTICE 1 年間 前
README.md 24a57f9e9a Update thanks 4 ヶ月 前
SECURITY.md 947d65cf29 Create SECURITY.md (#1080) 2 年 前
app.json 5b8c8f2516 Move Docker images to GitHub Container Registry 11 ヶ月 前
build-docs-sitemap.sh b75b6cb5a2 Add robots.txt and sitemap.txt 3 年 前
errors.go 15bd00b221 IMG-51: router -> server ns, handlers ns, added error to handler ret val (#1494) 1 ヶ月 前
fix_path.go 30f744e116 Try to fix path if signature is invalid 3 年 前
go.mod 3d14c85de3 IMG-13: http.Header, *ImageData -> ImageData (#1473) 2 ヶ月 前
go.sum 3d14c85de3 IMG-13: http.Header, *ImageData -> ImageData (#1473) 2 ヶ月 前
healthcheck.go aaaf1c706d Normalize IMGPROXY_PATH_PREFIX and IMGPROXY_HEALTH_CHECK_PATH 2 年 前
heroku.yml 6ce4201bb0 Add build arg to Heroku Dockerfile 6 年 前
lefthook.yml fa3b1d9c71 Exclude x.com from lychee check 7 ヶ月 前
logo.svg f0bd65aabf Optimize logo 6 年 前
main.go 4706416d5b Pass context.Background() to server.Shutdown() 1 ヶ月 前
pprof.go 82c6718edb Combine new & old build contraints format 3 年 前
processing_handler.go 8ba3e85913 stream.go replaced with handlers/stream 1 ヶ月 前
processing_handler_test.go 15bd00b221 IMG-51: router -> server ns, handlers ns, added error to handler ret val (#1494) 1 ヶ月 前

README.md

imgproxy logo

Website | Blog | Documentation | imgproxy Pro

Docker Bluesky X X Discord

CI


imgproxy is a fast and secure standalone server for resizing, processing, and converting 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

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 flip images, apply masks, or round corners, but in most cases, it is possible — and is much easier — to do that using CSS.
  • 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, again, an easy way to solve that would be just to use a proxying HTTP server, a load balancer, or a CDN.

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 contact us at security@imgproxy.net. We will coordinate the fix and disclosure.