2016-02-29 20:27:09 +03:00
< p align = "center" >
2017-03-31 07:29:03 +03:00
< img src = "docs/img/traefik.logo.png" alt = "Træfik" title = "Træfik" / >
2016-02-29 20:27:09 +03:00
< / p >
2015-09-13 20:34:05 +03:00
2017-05-18 23:36:10 +03:00
[![Build Status SemaphoreCI ](https://semaphoreci.com/api/v1/containous/traefik/branches/master/shields_badge.svg )](https://semaphoreci.com/containous/traefik)
2016-03-22 19:25:57 +03:00
[![Docs ](https://img.shields.io/badge/docs-current-brightgreen.svg )](https://docs.traefik.io)
2016-12-23 16:18:04 +03:00
[![Go Report Card ](https://goreportcard.com/badge/containous/traefik )](http://goreportcard.com/report/containous/traefik)
2016-09-30 16:04:37 +03:00
[![ ](https://images.microbadger.com/badges/image/traefik.svg )](https://microbadger.com/images/traefik)
2016-03-15 18:50:14 +03:00
[![License ](https://img.shields.io/badge/license-MIT-blue.svg )](https://github.com/containous/traefik/blob/master/LICENSE.md)
2018-06-12 18:04:04 +03:00
[![Join the chat at https://slack.traefik.io ](https://img.shields.io/badge/style-register-green.svg?style=social&label=Slack )](https://slack.traefik.io)
2016-02-18 12:25:59 +03:00
[![Twitter ](https://img.shields.io/twitter/follow/traefikproxy.svg?style=social )](https://twitter.com/intent/follow?screen_name=traefikproxy)
2015-09-22 17:07:49 +03:00
2018-03-22 14:34:03 +03:00
Træfik is a modern HTTP reverse proxy and load balancer that makes deploying microservices easy.
Træfik integrates with your existing infrastructure components ([Docker](https://www.docker.com/), [Swarm mode ](https://docs.docker.com/engine/swarm/ ), [Kubernetes ](https://kubernetes.io ), [Marathon ](https://mesosphere.github.io/marathon/ ), [Consul ](https://www.consul.io/ ), [Etcd ](https://coreos.com/etcd/ ), [Rancher ](https://rancher.com ), [Amazon ECS ](https://aws.amazon.com/ecs ), ...) and configures itself automatically and dynamically.
2018-05-09 18:48:03 +03:00
Pointing Træfik at your orchestrator should be the _only_ configuration step you need.
2016-03-22 19:25:57 +03:00
2017-08-10 18:29:32 +03:00
---
2017-09-11 20:10:04 +03:00
. ** [Overview ](#overview )** .
**[Features](#features)** .
**[Supported backends](#supported-backends)** .
**[Quickstart](#quickstart)** .
**[Web UI](#web-ui)** .
**[Test it](#test-it)** .
**[Documentation](#documentation)** .
. ** [Support ](#support )** .
**[Release cycle](#release-cycle)** .
**[Contributing](#contributing)** .
**[Maintainers](#maintainers)** .
**[Plumbing](#plumbing)** .
**[Credits](#credits)** .
2017-08-10 18:29:32 +03:00
---
2016-03-22 19:25:57 +03:00
## Overview
2018-03-22 14:34:03 +03:00
Imagine that you have deployed a bunch of microservices with the help of an orchestrator (like Swarm or Kubernetes) or a service registry (like etcd or consul).
Now you want users to access these microservices, and you need a reverse proxy.
2016-03-22 19:25:57 +03:00
2018-03-22 14:34:03 +03:00
Traditional reverse-proxies require that you configure _each_ route that will connect paths and subdomains to _each_ microservice.
In an environment where you add, remove, kill, upgrade, or scale your services _many_ times a day, the task of keeping the routes up to date becomes tedious.
2016-03-22 19:25:57 +03:00
2018-03-22 14:34:03 +03:00
**This is when Træfik can help you!**
2016-03-22 19:25:57 +03:00
2018-03-22 14:34:03 +03:00
Træfik listens to your service registry/orchestrator API and instantly generates the routes so your microservices are connected to the outside world -- without further intervention from your part.
2016-03-22 19:25:57 +03:00
2018-03-22 14:34:03 +03:00
**Run Træfik and let it do the work for you!**
_(But if you'd rather configure some of your routes manually, Træfik supports that too!)_
2016-03-22 19:25:57 +03:00
![Architecture ](docs/img/architecture.png )
2015-10-06 00:22:12 +03:00
## Features
2018-03-22 14:34:03 +03:00
- Continuously updates its configuration (No restarts!)
- Supports multiple load balancing algorithms
2018-03-26 15:12:03 +03:00
- Provides HTTPS to your microservices by leveraging [Let's Encrypt ](https://letsencrypt.org ) (wildcard certificates support)
2017-08-25 21:40:03 +03:00
- Circuit breakers, retry
2017-08-25 22:32:03 +03:00
- High Availability with cluster mode (beta)
2018-03-22 14:34:03 +03:00
- See the magic through its clean web UI
- Websocket, HTTP/2, GRPC ready
- Provides metrics (Rest, Prometheus, Datadog, Statsd, InfluxDB)
- Keeps access logs (JSON, CLF)
2018-06-11 12:46:03 +03:00
- Fast
2018-03-22 14:34:03 +03:00
- Exposes a Rest API
- Packaged as a single binary file (made with :heart: with go) and available as a [tiny ](https://microbadger.com/images/traefik ) [official ](https://hub.docker.com/r/_/traefik/ ) docker image
## Supported Backends
2018-03-30 12:18:03 +03:00
- [Docker ](https://docs.traefik.io/configuration/backends/docker ) / [Swarm mode ](https://docs.traefik.io/configuration/backends/docker#docker-swarm-mode )
- [Kubernetes ](https://docs.traefik.io/configuration/backends/kubernetes )
- [Mesos ](https://docs.traefik.io/configuration/backends/mesos ) / [Marathon ](https://docs.traefik.io/configuration/backends/marathon )
- [Rancher ](https://docs.traefik.io/configuration/backends/rancher ) (API, Metadata)
2018-04-11 15:20:53 +03:00
- [Azure Service Fabric ](https://docs.traefik.io/configuration/backends/servicefabric )
2018-03-30 12:18:03 +03:00
- [Consul Catalog ](https://docs.traefik.io/configuration/backends/consulcatalog )
- [Consul ](https://docs.traefik.io/configuration/backends/consul ) / [Etcd ](https://docs.traefik.io/configuration/backends/etcd ) / [Zookeeper ](https://docs.traefik.io/configuration/backends/zookeeper ) / [BoltDB ](https://docs.traefik.io/configuration/backends/boltdb )
- [Eureka ](https://docs.traefik.io/configuration/backends/eureka )
- [Amazon ECS ](https://docs.traefik.io/configuration/backends/ecs )
- [Amazon DynamoDB ](https://docs.traefik.io/configuration/backends/dynamodb )
- [File ](https://docs.traefik.io/configuration/backends/file )
- [Rest ](https://docs.traefik.io/configuration/backends/rest )
2017-08-10 18:29:32 +03:00
2016-09-20 15:49:43 +03:00
## Quickstart
2015-09-28 19:25:41 +03:00
2018-03-22 14:34:03 +03:00
To get your hands on Træfik, you can use the [5-Minute Quickstart ](http://docs.traefik.io/#the-trfik-quickstart-using-docker ) in our documentation (you will need Docker).
2015-09-28 19:25:41 +03:00
2018-03-22 14:34:03 +03:00
Alternatively, if you don't want to install anything on your computer, you can try Træfik online in this great [Katacoda tutorial ](https://www.katacoda.com/courses/traefik/deploy-load-balancer ) that shows how to load balance requests between multiple Docker containers.
2015-09-28 19:25:41 +03:00
2018-03-22 14:34:03 +03:00
If you are looking for a more comprehensive and real use-case example, you can also check [Play-With-Docker ](http://training.play-with-docker.com/traefik-load-balancing/ ) to see how to load balance between multiple nodes.
2017-08-10 18:29:32 +03:00
2015-10-13 19:05:50 +03:00
## Web UI
2017-04-18 23:12:17 +03:00
You can access the simple HTML frontend of Træfik.
2015-10-13 19:05:50 +03:00
![Web UI Providers ](docs/img/web.frontend.png )
![Web UI Health ](docs/img/traefik-health.png )
2018-03-22 14:34:03 +03:00
## Documentation
You can find the complete documentation at [https://docs.traefik.io ](https://docs.traefik.io ).
A collection of contributions around Træfik can be found at [https://awesome.traefik.io ](https://awesome.traefik.io ).
## Support
To get community support, you can:
2018-06-12 18:04:04 +03:00
- join the Træfik community Slack channel: [![Join the chat at https://slack.traefik.io ](https://img.shields.io/badge/style-register-green.svg?style=social&label=Slack )](https://slack.traefik.io)
2018-03-22 14:34:03 +03:00
- use [Stack Overflow ](https://stackoverflow.com/questions/tagged/traefik ) (using the `traefik` tag)
If you need commercial support, please contact [Containo.us ](https://containo.us ) by mail: < mailto:support @ containo . us > .
2015-09-13 20:34:05 +03:00
2018-03-22 14:34:03 +03:00
## Download
2015-09-13 20:34:05 +03:00
2018-03-22 14:34:03 +03:00
- Grab the latest binary from the [releases ](https://github.com/containous/traefik/releases ) page and run it with the [sample configuration file ](https://raw.githubusercontent.com/containous/traefik/master/traefik.sample.toml ):
2015-09-13 20:34:05 +03:00
2015-10-06 00:22:12 +03:00
```shell
2016-05-30 12:37:12 +03:00
./traefik --configFile=traefik.toml
2015-09-13 20:34:05 +03:00
```
2015-09-14 15:38:21 +03:00
2018-03-22 14:34:03 +03:00
- Or use the official tiny Docker image and run it with the [sample configuration file ](https://raw.githubusercontent.com/containous/traefik/master/traefik.sample.toml ):
2015-09-13 20:34:05 +03:00
2015-10-06 00:22:12 +03:00
```shell
2016-04-07 16:36:48 +03:00
docker run -d -p 8080:8080 -p 80:80 -v $PWD/traefik.toml:/etc/traefik/traefik.toml traefik
2015-09-13 20:34:05 +03:00
```
2018-03-22 14:34:03 +03:00
- Or get the sources:
2015-09-22 11:50:33 +03:00
2015-10-06 00:22:12 +03:00
```shell
2016-02-24 18:43:39 +03:00
git clone https://github.com/containous/traefik
2015-09-22 11:50:33 +03:00
```
2018-03-22 14:34:03 +03:00
## Introductory Videos
2017-08-10 18:29:32 +03:00
2018-03-22 14:34:03 +03:00
Here is a talk given by [Emile Vauge ](https://github.com/emilevauge ) at [GopherCon 2017 ](https://gophercon.com/ ).
You will learn Træfik basics in less than 10 minutes.
2017-08-10 18:29:32 +03:00
2018-03-22 14:34:03 +03:00
[![Traefik GopherCon 2017 ](https://img.youtube.com/vi/RgudiksfL-k/0.jpg )](https://www.youtube.com/watch?v=RgudiksfL-k)
2016-05-13 18:32:39 +03:00
2018-03-22 14:34:03 +03:00
Here is a talk given by [Ed Robinson ](https://github.com/errm ) at [ContainerCamp UK ](https://container.camp ) conference.
You will learn fundamental Træfik features and see some demos with Kubernetes.
2017-08-10 18:29:32 +03:00
2018-03-22 14:34:03 +03:00
[![Traefik ContainerCamp UK ](https://img.youtube.com/vi/aFtpIShV60I/0.jpg )](https://www.youtube.com/watch?v=aFtpIShV60I)
2017-06-30 18:35:26 +03:00
2018-03-22 14:34:03 +03:00
## Maintainers
2017-06-30 18:35:26 +03:00
2018-03-22 14:34:03 +03:00
[Information about process and maintainers ](MAINTAINER.md )
2017-06-30 18:35:26 +03:00
2017-08-10 18:29:32 +03:00
## Contributing
2018-03-22 14:34:03 +03:00
If you'd like to contribute to the project, refer to the [contributing documentation ](CONTRIBUTING.md ).
2017-08-10 18:29:32 +03:00
Please note that this project is released with a [Contributor Code of Conduct ](CODE_OF_CONDUCT.md ).
2018-03-22 14:34:03 +03:00
By participating in this project, you agree to abide by its terms.
2017-08-10 18:29:32 +03:00
2018-03-22 14:34:03 +03:00
## Release Cycle
2017-08-10 18:29:32 +03:00
2018-03-22 14:34:03 +03:00
- We release a new version (e.g. 1.1.0, 1.2.0, 1.3.0) every other month.
- Release Candidates are available before the release (e.g. 1.1.0-rc1, 1.1.0-rc2, 1.1.0-rc3, 1.1.0-rc4, before 1.1.0)
- Bug-fixes (e.g. 1.1.1, 1.1.2, 1.2.1, 1.2.3) are released as needed (no additional features are delivered in those versions, bug-fixes only)
2016-07-05 22:02:14 +03:00
2018-03-22 14:34:03 +03:00
Each version is supported until the next one is released (e.g. 1.1.x will be supported until 1.2.0 is out)
2017-08-10 18:29:32 +03:00
2018-03-22 14:34:03 +03:00
We use [Semantic Versioning ](http://semver.org/ )
2017-08-10 18:29:32 +03:00
## Plumbing
- [Oxy ](https://github.com/vulcand/oxy ): an awesome proxy library made by Mailgun folks
- [Gorilla mux ](https://github.com/gorilla/mux ): famous request router
- [Negroni ](https://github.com/urfave/negroni ): web middlewares made simple
- [Lego ](https://github.com/xenolf/lego ): the best [Let's Encrypt ](https://letsencrypt.org ) library in go
2016-04-27 01:02:03 +03:00
## Credits
2017-04-24 16:34:12 +03:00
Kudos to [Peka ](http://peka.byethost11.com/photoblog/ ) for his awesome work on the logo ![logo ](docs/img/traefik.icon.png ).
2018-03-22 14:34:03 +03:00
Traefik's logo is licensed under the Creative Commons 3.0 Attributions license.
2017-04-24 16:34:12 +03:00
Traefik's logo was inspired by the gopher stickers made by Takuya Ueda (https://twitter.com/tenntenn).
2018-03-22 14:34:03 +03:00
The original Go gopher was designed by Renee French (http://reneefrench.blogspot.com/).