Docker varnish image used within EMGAG environments. Originally based on newsdev/docker-varnish (not available anymore), but updated to recent varnish versions (4.1 and 6.0), added some additional vmods and support for additional configuration.
Shipped modules (vmods):
- varnish-modules: Official varnish vmod collection (cookie,header,saintmode,softpurge,tcp,var,vsthrottle,xkey)
- libvmod-dynamic: Dynamic backend director
- libvmod-digest: HMAC, hash and base64 functions
- libvmod-geoip: GeoIP lookup support
Note: Only 6.0 and 4.1 are versions supported by varnish and still maintained in this repo.
Based on Debian Stretch:
Based on Debian Jessie:
From varnish-cache.org: Varnish Cache is a web application accelerator also known as a caching HTTP reverse proxy. You install it in front of any server that speaks HTTP and configure it to cache the contents. Varnish Cache is really, really fast. It typically speeds up delivery with a factor of 300 - 1000x, depending on your architecture.
By default, varnish reads /etc/varnish/default.vcl on startup. Either copy your VCL file in your Dockerfile
FROM emgag/varnish:6.0
COPY default.vcl /etc/varnish/default.vcl
or mount a volume containing the varnish configuration to /etc/varnish, e.g with a docker-compose file:
version: '3'
services:
varnish:
image: emgag/varnish:6.0
volumes:
- ./varnish:/etc/varnish
ports:
- "80:80"
Following environment variables can be used to customize the behaviour of the container:
- VARNISH_CONFIG (default:
/etc/varnish/default.vcl): The VCL file read on startup. - VARNISH_DAEMON_OPTS: Additional command line arguments for
varnishd. - VARNISH_LISTEN (default:
:80): The TCP port to listen for incoming client connections. Make sure to also expose the new port if this value is modified. - VARNISH_MANAGEMENT_LISTEN (default:
127.0.0.1:6082): The TCP port to listen for management connections. See varnish documentation about management interface authentication to setup a PSK. - VARNISH_STORAGE (default:
malloc,100m): The cache backend and its configuration
View license information for the software contained in this image.
If you have any problems with or questions about this image, please contact us through a GitHub issue.
You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.
Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.