webp_server_go

This is a Server based on Golang, which allows you to serve WebP images on the fly. It will convert jpg,jpeg,png files by default, this can be customized by editing the config.json..

currently supported image format: JPEG, PNG, BMP, GIF(static image for now)

e.g When you visit https://a.com/1.jpg，it will serve as image/webp without changing the URL.

For Safari and Opera users, the original image will be used.

Compare to n0vad3v/webp_server

Size

webp_server with node_modules: 43M
webp-server(go) single binary: 15M

Performance

It's basically between ExpressJS and Fiber, much faster than the http package of course.

Convenience

webp_server: Clone the repo -> npm install -> run with pm2
webp-server(go): Download a single binary -> Run

General Usage Steps

Regarding the IMG_PATH section in config.json. If you are serving images at https://example.com/pics/tsuki.jpg and your files are at /var/www/image/pics/tsuki.jpg, then IMG_PATH shall be /var/www/image. EXHAUST_PATH is cache folder for output webp images, with EXHAUST_PATH set to /var/cache/webp in the example above, your webp image will be saved at /var/cache/webp/pics/tsuki.jpg.1582558990.webp.

1. Download or build the binary

Download the webp-server from release page.

Wanna build your own binary? Check out build section

2. config file

Create a config.json as follows to face your need, default convert quality is 80%.

{
	"HOST": "127.0.0.1",
	"PORT": "3333",
	"QUALITY": "80",
	"IMG_PATH": "/path/to/pics",
	"EXHAUST_PATH": "/path/to/exhaust",
	"ALLOWED_TYPES": ["jpg","png","jpeg"]
}

3. Run

Run the binary like this: ./webp-server --config /path/to/config.json, for prefetch mode, add --prefech.

Prefetch mode will pre-convert all the images in the IMG_PATH on initial start up.

screen or tmux

Use screen or tmux to avoid being terminated. Let's take screen for example

screen -S webp
./webp-server --config /path/to/config.json

(Use Ctrl-A-D to detach the screen with webp-server running.)

systemd

Don't worry, we've got you covered!

Download webp-server to /opt/webps/webp-server, and create a config file to /opt/webps/config.json, then,

cp webps.service /lib/systemd/system/
systemctl daemon-reload
systemctl enable webps.service
systemctl start webps.service

4. Nginx proxy_pass

Let Nginx to proxy_pass http://localhost:3333/;, and your webp-server is on-the-fly

WordPress example

location ^~ /wp-content/uploads/ {
        proxy_pass http://127.0.0.1:3333;
}

Advanced usage

show help

./webp-server --help
Usage of ./webp-server:
  -child
        is child process
  -config string
        /path/to/config.json. (Default: ./config.json) (default "config.json")
  -dump-config
        Print sample config.json
  -dump-systemd
        Print sample systemd service file.
  -jobs int
        Prefetch thread, default is all. (default 8)
  -prefetch
        Prefetch and convert image to webp
  -prefork
        use prefork

Prefetch

Prefetch will convert all your images to webp. Don't worry, Webp server will start, you don't have to wait until prefetch completes.

./webp-server -prefetch

If you want to control threads to use while prefetching, add -jobs=4. By default, it will utilize all your CPU cores.

# use 4 cores
./webp-server -prefetch -jobs=4

dump config.json

The standard config.json will show on your screen. You many want to use > to redirect to a file.

./webp-server -dump-config

dump systemd service file

The standard systemd service file will show on your screen. You many want to use > to redirect to a file.

./webp-server -dump-systemd

Build your own binaries

Install latest version of golang, enable go module, clone the repo, and then...

make

Due to the limitations of webp module, you can't cross compile this tool. But the binary will work instantly on your platform and arch

TODO

This version doesn't support header-based-output, which means Safari users will not see the converted webp images, this should be fixed in later releases.
Multi platform support.
A better way to supervise the program.
Get rid of render-blocking effect on first render.
Prefetch on server initialization.
Custom exhaust path.
Multiple listen address.

License

WebP Server is under the GPLv3. See the LICENSE file for details.

README.md Unescape Escape