Current stable version: 1.5.3
fabio is a fast, modern, zero-conf load balancing HTTP(S) and TCP router for deploying applications managed by consul.
Register your services in consul, provide a health check and fabio will start routing traffic to them. No configuration required. Deployment, upgrading and refactoring has never been easier.
fabio is developed and maintained by Frank Schroeder.
It supports (Full feature list)
- TLS termination with dynamic certificate stores
- Raw TCP proxy
- TCP+SNI proxy for full end-to-end TLS without decryption
- HTTPS upstream support
- Websockets and SSE
- Dynamic reloading without restart
- Traffic shaping for "blue/green" deployments,
- Circonus, Graphite and StatsD/DataDog metrics
Watch Kelsey Hightower demo Consul, Nomad, Vault and fabio at HashiConf EU 2016.
The full documentation is on the Wiki.
# go 1.8 or higher is required go get github.com/fabiolb/fabio (>= go1.8) brew install fabio (OSX/macOS stable) brew install --devel fabio (OSX/macOS devel) docker pull fabiolb/fabio (Docker) https://github.com/fabiolb/fabio/releases (pre-built binaries)
Register your service in consul.
Make sure that each instance registers with a unique ServiceID and a service name without spaces.
Register a health check in consul as described here.
Make sure the health check is passing since fabio will only watch services which have a passing health check.
host/pathprefix it serves, e.g.:
# HTTP/S examples urlprefix-/css # path route urlprefix-i.com/static # host specific path route urlprefix-mysite.com/ # host specific catch all route urlprefix-/foo/bar strip=/foo # path stripping (forward '/bar' to upstream) urlprefix-/foo/bar proto=https # HTTPS upstream urlprefix-/foo/bar proto=https tlsskipverify=true # HTTPS upstream and self-signed cert # TCP examples urlprefix-:3306 proto=tcp # route external port 3306
Make sure the prefix for HTTP routes contains at least one slash (
See the full list of options in the Documentation.
Start fabio without a config file (assuming a running consul agent on
localhost:8500) Watch the log output how fabio picks up the route to your service. Try starting/stopping your service to see how the routing table changes instantly.
Send all your HTTP traffic to fabio on port
9999. For TCP proxying see TCP proxy.
- Frank Schroeder @magiconair
Contributions up to 14 Apr 2017 before 38f73da
MIT Licensed Copyright (c) 2017 eBay Software Foundation. All rights reserved.
Contributions after 14 Apr 2017 starting with 38f73da
MIT Licensed Copyright (c) 2017 Frank Schroeder. All rights reserved.
See LICENSE for details.