Skip to content

Fast image resizing backend based on libvips, mozjpeg and pngquant

License

Notifications You must be signed in to change notification settings

ultimate-guitar/reImage

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

72 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

reImage

Features

  1. No os.exec call of pngquant or mozjpeg. Only bindings to libraries.
  2. Using libvips for fast image resizing
  3. Docker container uses libvips compiled with mozjpeg instead of libjpeg-turbo. MozJPEG makes tradeoffs that are intended to benefit Web use cases and focuses solely on improving encoding, so it's best used as part of a Web encoding workflow.
  4. png images are optimized with libimagequant (backend library of pngquant)

Install steps

  1. Deploy it with Docker
  2. Configure frontend
  3. Enjoy!

Deploy

  1. Pull docker container: docker pull larrabee/reimage:1.2.5
  2. Run it with docker run -d -p 7075:7075 larrabee/reimage:1.2.5 or use docker-compose config:
version: '2.2'
services:
  reImage:
    image: larrabee/reimage:1.2.5
    restart: always
    ports:
      - "7075:7075"  

Configure frontend

This is basic Nginx config for online resizing with nginx cache.

http {
    proxy_cache_path /var/www/resize_cache levels=1:2 
    keys_zone=resized_img:64m inactive=48h max_size=5G use_temp_path=off;

    server {
        listen       80;
        server_name  example.com;
        root /var/www/example.com/;

        location /img/ {
           location ~* \.(jpg|jpeg|png|ico)(\@[0-9xX]+)$ {
             proxy_pass http://localhost:7075; #Node with running image resizer
             proxy_set_header X-RESIZE-SCHEME "http";
             proxy_set_header X-RESIZE-BASE "example.com";
             #Nginx cache. Optional
             proxy_cache_valid  200 48h;
             proxy_cache_valid  404 400 5m;
             proxy_cache_valid 500 502 503 504 10s;
             add_header X-Cache-Status $upstream_cache_status;
             proxy_cache resized_img;
           }
        }
    }
}

Required options:

  1. Replace localhost:7075 with your hostname and port if you ran resizer in different node.
  2. Set X-RESIZE-SCHEME "http" if your image server with original images run over http (by default use https).
  3. Set you image server hostname here: X-RESIZE-BASE "example.com"

Optional:

  1. Set X-RESIZE-QUALITY header if you want to override quality settings. Default value: 80, allowed values: 1-100
  2. Set X-RESIZE-COMPRESSION header if you want to override compression settings. Default value: 6, allowed values: 0-9

Enjoy!

Benchmark

See benchmark Wiki page

LICENSE

MIT