Skip to content
Consul Load-Balancing made simple
Go Other
  1. Go 97.8%
  2. Other 2.2%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Added .github/ISSUE_TEMPLATE.md (optional) Feb 1, 2018
admin ui: Remove duplicate destination column Jun 3, 2019
assert Issue #119: Transparent response body compression Oct 28, 2016
auth Improved basic auth htpasswd file refresh #604 (#610) Apr 4, 2019
build minor transition updates (#745) Jan 24, 2020
cert Safely handle missing cert from Vault KV store (#710) Oct 14, 2019
config Add HTTP method and path to trace span operation name (#715) Jan 29, 2020
demo fix demo server to handle redirect opts Dec 5, 2017
docs Issue 554 Added compiled glob matching using LRU Cache (#615) Jan 29, 2020
exit log caught signal and reaction Dec 10, 2017
logger log: add leveled logging Oct 9, 2017
metrics metrics/circonus: Adding support for sending to a local circonus agent Nov 20, 2018
noroute refactor code Dec 16, 2017
proxy Add HTTP method and path to trace span operation name (#715) Jan 29, 2020
registry Issue 554 Added compiled glob matching using LRU Cache (#615) Jan 29, 2020
route Feat: Pass encoded characters in path unchanged (#489) Feb 2, 2020
trace Add HTTP method and path to trace span operation name (#715) Jan 29, 2020
uuid PR #292: Add unique request id May 16, 2017
vendor Cleanup vendor folder and modules Oct 11, 2019
.dockerignore Work on testing May 16, 2018
.gitignore add missing dependency Aug 16, 2018
.goreleaser.yml minor transition updates (#745) Jan 24, 2020
.travis.yml only deploy once per build (#747) Jan 28, 2020
CHANGELOG.md Update Changelog for v1.5.13 Nov 19, 2019
CODE_OF_CONDUCT.md more small documentation updates Jan 22, 2020
CONTRIBUTING.md Updated CONTRIBUTING.md (optional) Feb 1, 2018
Dockerfile Update Dockerfile to go1.13.4 Nov 18, 2019
Dockerfile-goreleaser update goreleaser config Oct 11, 2019
LICENSE minor transition updates (#745) Jan 24, 2020
Makefile only deploy once per build (#747) Jan 28, 2020
NOTICES.txt Bundle UI assets (#643) May 6, 2019
README.md switch back to travis CI (#744) Jan 24, 2020
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.iml Issue 611 Added Custom API Driven Back end (#614) Apr 4, 2019
fabio.png Add logo to readme Feb 11, 2016
fabio.properties Add HTTP method and path to trace span operation name (#715) Jan 29, 2020
fabio.svg Add SVG logo Apr 6, 2017
go.mod Cleanup vendor folder and modules Oct 11, 2019
go.sum Cleanup vendor folder and modules Oct 11, 2019
main.go Preserve table state by storing buffer table in fixed strings. Fixes #… Jan 30, 2020
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
tools.go Bundle UI assets (#643) May 6, 2019

README.md

Release License MIT Travis CI Status Downloads Docker Pulls fabiolb


Notes

  1. If you are confused about the commit order for the v1.5.11 release please check the Release Notes for an explanation.

  2. The 1.5.11 tag was wrongly pointing to commit 0297494e9a00f87d3e387b8c6ff0408c2f5db6a0 instead of commit 446fbba59da42ed73df67c3d738b9945dbf0790a. I have updated the v1.5.11 tag to point to the correct version and created v1.5.11-wrong tag to point to the old (wrong) version.


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 The Fabio Authors.

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

Author and Founder

Maintainers

Contributors

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

License

  • 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-2019 Frank Schroeder. All rights reserved.

See LICENSE for details.

Stargazers over Time

Stargazers over time

You can’t perform that action at this time.