Go Makefile Shell
Failed to load latest commit information.
.github Added .github/ISSUE_TEMPLATE.md (optional) Feb 1, 2018
admin fix tests Feb 2, 2018
assert Issue #119: Transparent response body compression Oct 28, 2016
build build: remove tools for old release process Feb 6, 2018
cert Issue #434: use DNS compatible name for common name in cert Feb 6, 2018
config Merge branch 'master' into fcgi-handler May 31, 2018
demo fix demo server to handle redirect opts Dec 5, 2017
docs Merge branch 'fcgi-handler' of https://github.com/Gufran/fabio Jun 10, 2018
exit log caught signal and reaction Dec 10, 2017
logger log: add leveled logging Oct 9, 2017
metrics Replace github.com/magiconair/go-metrics-statsd with upstream lib again Jul 27, 2018
noroute refactor code Dec 16, 2017
proxy Fix test compile Jul 27, 2018
registry "strict" health-checking Feb 19, 2018
route Issue #506: reverse domain names before sorting Jun 10, 2018
uuid PR #292: Add unique request id May 16, 2017
vendor Replace github.com/magiconair/go-metrics-statsd with upstream lib again Jul 27, 2018
.dockerignore Work on testing May 16, 2018
.gitignore Work on testing May 16, 2018
.goreleaser.yml build: fix checksum name file Feb 9, 2018
CHANGELOG.md Update CHANGELOG Jun 10, 2018
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md Jun 25, 2017
CONTRIBUTING.md Updated CONTRIBUTING.md (optional) Feb 1, 2018
Dockerfile build: make docker build work with goreleaser Dec 21, 2017
Dockerfile-test Parameterize docker-test and make var names unambiguous. May 16, 2018
LICENSE Revert copyright date for eBay contributions. May 8, 2017
Makefile Use docker-test for releases May 16, 2018
NOTICES.txt Replace github.com/magiconair/go-metrics-statsd with upstream lib again Jul 27, 2018
README.md Update README.md Jun 15, 2018
classmarkets.png Add classmarkets logo Jun 29, 2017
ebay.png Add eBay and eCG logos Apr 13, 2017
ecg.png Add eBay and eCG logos Apr 13, 2017
fabio.png Add logo to readme Feb 11, 2016
fabio.properties Fix the regex of the example proxy.gzip.contenttype Mar 18, 2018
fabio.svg Add SVG logo Apr 6, 2017
main.go Merge branch 'fcgi-handler' of https://github.com/Gufran/fabio Jun 10, 2018
mytaxi.png Add mytaxi.de logo May 26, 2017
rootwarn_unix.go add note to re-consider root warning for containers Feb 2, 2018
rootwarn_windows.go fix 1.5.7 windows build Feb 11, 2018


Release License MIT Codeship CI Status Downloads Docker Pulls magiconair Docker Pulls fabiolb Backers on Open Collective Sponsors on Open Collective

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 powers some of the largest websites in The Netherlands (marktplaats.nl), Australia (gumtree.com.au) and Italy (www.kijiji.it). It delivers 23.000 req/sec every day since Sep 2015 without problems.

It integrates with Consul, Vault, Amazon ELB, Amazon API Gateway and more.

It supports (Full feature list)

Watch Kelsey Hightower demo Consul, Nomad, Vault and fabio at HashiConf EU 2016.

The full documentation is on fabiolb.net

Getting started

  1. Install from source, binary, Docker or Homebrew.

    # go 1.9 or higher is required
    go get github.com/fabiolb/fabio                     (>= go1.9)
    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)
  2. Register your service in consul.

    Make sure that each instance registers with a unique ServiceID and a service name without spaces.

  3. Register a health check in consul as described here.

    By default fabio only watches services which have a passing health check, unless overriden with registry.consul.service.status.

  4. Register one urlprefix- tag per host/path prefix 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.

  1. 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.

  2. Send all your HTTP traffic to fabio on port 9999. For TCP proxying see TCP proxy.

  3. Done



This project exists thanks to all the people who contribute. [Contribute].


Thank you to all our backers! 🙏 [Become a backer]


Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]


  • 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.

Stargazers over Time

Stargazers over time