traefik
## 简介
traefik是一款开源的反向代理与负载均衡工具。软件定位是做负载均衡器，提供好用的负载均衡服务，不要老拿它跟nginx对比。它最大的优点是能够与常见的微服务系统直接整合，可以实现自动化动态配置。
目前支持：Docker, Swarm, Mesos/Marathon, Mesos, Kubernetes, Consul, Etcd, Zookeeper, BoltDB, Rest API等等后端模型。
#### ME为什么选择traefik？
```
Golang编写，单文件部署，与系统无关；
热加载配置文件；
内置Web UI，管理相对方便；
```
功能特点：
```
It's fast
No dependency hell, single binary made with go
Rest API
Multiple backends supported: Docker, Swarm, Kubernetes, Marathon, Mesos, Consul, Etcd, and more to come
Watchers for backends, can listen for changes in backends to apply a new configuration automatically
Hot-reloading of configuration. No need to restart the process
Graceful shutdown http connections
Circuit breakers on backends
Round Robin, rebalancer load-balancers
Rest Metrics
Tiny official docker p_w_picpath included
SSL backends support
SSL frontend support (with SNI)
Clean AngularJS Web UI
Websocket support
HTTP/2 support
Retry request if network error
Let's Encrypt support (Automatic HTTPS with renewal)
High Availability with cluster mode
```
### 安装部署：
#### 规划服务路径
#### 服务主路径
```
cd /etc/traefik/
```
#### ssl 证书存放路径
```
mkdir -p /etc/traefik/ssl
```
#### 配置文件存放路径
```
mkdir -p /etc/traefik/config
```
#### 日志存放路径
```
mkdir -p /etc/traefik/log
```
#### 源码包安装：
```
测试版本：v1.2.3
```
```
软件下载地址：https://github.com/containous/traefik/releases/tag/v1.2.3
```
软件下载到服务器后，加压，修改权限，探后启动服务；
```
chmod 755 traefik
```
#### 启动服务
traefik go 语言编写，启动服务比较简单，指定一下配置文件即可，
```
./traefik -c ./config/traefik.toml
```
#### 默认没有配置文件，需要自己根据官网参考文件进行整理，下面我根据官网信息，进行整理优化了一个主配置文件。
```
[root@trarfik-test config]# more traefik.toml
##开启debug 模式，Default,false
debug = true
##日志级别, "DEBUG", "INFO", "WARN", "ERROR", "FATAL", "PANIC"
logLevel = "INFO"
##Traefik 服务日志，如果不配置，日志将屏幕输出；
#traefikLogsFile = "/etc/traefik/log/traefik.log"
##成功访问日志
accessLogsFile = "/etc/traefik/log/access.log"
##与后端连接保持时间，避免反复与后端服务建立连接，Default,"2s"
ProvidersThrottleDuration = 5
###控制最大空闲连接数，使用net/http模块，试过设置为0 ，则不限制，如果看到'too many open files' 报错，建议修改系统层`ulimit`值
，Default: 200
maxIdleConnsPerHost = 60000
###如果设置为true，将使用后端服务SSL证书。注意:这禁用中间人***的检测只能用于后端网络安全。Default: false
#insecureSkipVerify = true
###配置默认监听端口
###配置服务默认监听端口，如果想改变监听端口，可以进行单独配置
defaultEntryPoints = ["http", "https"]
[entryPoints]
[entryPoints.http]
address = ":80"
compress = true
[entryPoints.https]
address = ":443"
compress = true
###ssl 证书配置
[entryPoints.https.tls]
`entryPoints`.`https`.`tls`.`certificates`
certFile = "/etc/traefik/ssl/www.ptengine.cn.crt"
keyFile = "/etc/traefik/ssl/www.ptengine.cn.key"
## 管理界面监听端口
[web]
address = ":8800"
##设置 REST API 为只读模式
ReadOnly = false
##启用详细信息输出，会在管理界面下方打印一些错误信息，提供参考；
[web.statistics]
RecentErrors = 10
## To enable Traefik to export internal metrics to Prometheus
[web.metrics.prometheus]
Buckets=[0.1,0.3,1.2,5.0]
### webui基本认证配置
### 密码可以编码在MD5、SHA1和BCrypt:您可以使用htpasswd生成
### 用户可以直接在toml指定文件,或间接通过引用一个外部文件;如果两个,两个并存,外部文件内容优先
### 测试配置实例
### 用户名/密码: 测试和test2:test2码:测试:测试和test2:test2
[web.auth.basic]
users = ["test:$apr1$H6uskkkW$IgXLP6ewTrSuBkTrqE8wj/", "test2:$apr1$d9hr9HBB$4HxwgUir3HP4EsggP/QNo0"]
### 指定配置文件
usersFile = "/path/to/.htpasswd"
###配置文件扩展，可以加载监视文件内容
[file]
##不支持监听目录，监听文件名要写死
filename = "/etc/traefik/config/rules.toml"
### 监视文件变更
watch = true
##发送请求重试
[retry]
##默认只向后端请求一次，不重试，
attempts = 3
```
使用上面的配置文件启动服务，会监听3个端口， 80：http ，443：https ，8800：api ，上面的配置文件我开启了debug 模式，实际生产环境不需要。服务启动后即可访问，api 管理界面查看一下基础信息。
#### 浏览器访问地址：
```
http://localhost:8800
```
#### 使用curl 访问api 接口获取信息
```
/api/providers: GET providers
/api/providers/{provider}: GET or PUT provider
/api/providers/{provider}/backends: GET backends
/api/providers/{provider}/backends/{backend}: GET a backend
/api/providers/{provider}/backends/{backend}/servers: GET servers in a backend
/api/providers/{provider}/backends/{backend}/servers/{server}: GET a server in a backend
/api/providers/{provider}/frontends: GET frontends
/api/providers/{provider}/frontends/{frontend}: GET a frontend
/api/providers/{provider}/frontends/{frontend}/routes: GET routes in a frontend
/api/providers/{provider}/frontends/{frontend}/routes/{route}: GET a route in a frontend
```
#### 查看API接口 信息，可以显示，
```
[root@trarfik-test ~]# curl -s "http://localhost:8800/health"|jq
{
"pid": 23955,
"uptime": "4m19.415827181s",
"uptime_sec": 259.415827181,
"time": "2017-04-21 10:38:44.925762492 +0800 CST",
"unixtime": 1492742324,
"status_code_count": {},
"total_status_code_count": {
"304": 3,
"404": 2,
"429": 6
},
"count": 0,
"total_count": 11,
"total_response_time": "11.553372ms",
"total_response_time_sec": 0.011553372000000001,
"average_response_time": "1.050306ms",
"average_response_time_sec": 0.001050306,
"recent_errors": [
...............
]
}
```
#### 查看配置信息接口：
```
[root@trarfik-test ~]# curl -s "http://localhost:8800/api"|jq
{
"file": {
"backends": {
"test1": {
"servers": {
"server1": {
"url": "http://172.16.100.70:80",
"weight": 1
},
"server2": {
"url": "http://172.16.100.71:80",
"weight": 1
}
},
"circuitBreaker": {
"expression": "NetworkErrorRatio() > 0.5"
},
"loadBalancer": {
"method": "drr"
},
"maxConn": {
"amount": 10,
"extractorFunc": "request.host"
}
}
},
"frontends": {
"test1": {
"entryPoints": [
"http",
"https"
],
"backend": "test1",
"routes": {
"service1": {
"rule": "Host:test.ptmind.com;"
}
},
"passHostHeader": true,
"priority": 10
}
}
}
}
```
### DOCKER 方式启动
Docker 启动需要先准备一下配置文件，将配置文件挂载到容器内部，另外注意下，api 管理端口。
```
docker run -d -p 8080:8080 -p 80:80 -v $PWD/traefik.toml:/etc/traefik/traefik.toml traefik
```
### 域名反向代理配置实例演示
#### 监听域名
```
test.ptmind.com
pttest.ptmind.com
```
#### 后端轮训站点：
```
172.16.100.70：80
172.16.100.71：80
```
#### 安全考虑：
```
显示单个客户端请求链接数；
后端不稳定停止转发轮训；
```
配置信息如下：
```
[root@trarfik-test config]# more rules.toml
##后端配置
#[backends]
##发送请求重试
#[retry]
###默认只向后端请求一次，不重试，
attempts = 3
[backends.testptmindcom]
##后端网络错误率>0.5 停止转发；
[backends.testptmindcom.circuitbreaker]
expression = "NetworkErrorRatio() > 0.5"
##轮训方式，method=drr（加权轮训调度）default：wrr（队列轮转算法）
[backends.testptmindcom.LoadBalancer]
method = "drr"
##安全限制，单个主机连接数大于指定值，会提示“max connections reached”
[backends.testptmindcom.maxconn]
amount = 10
extractorfunc = "request.host"
##第一台后端节点
[backends.testptmindcom.servers.server1]
url = "http://172.16.100.70:80"
weight = 1
##第二台后端节点
[backends.testptmindcom.servers.server2]
url = "http://172.16.100.71:80"
weight = 1
```
## 前端配置
```
[frontends]
#定义一个接入点的名字
[frontends.testptmindcom]
passHostHeader = true
priority = 10
##定义调用后端名称
backend = "testptmindcom"
##前端监听域名,可以监听多域名
[frontends.testptmindcom.routes.service]
rule = "Host:test.ptmind.com,pttest.ptmind.com;"
```
#### 验证配置信息：
[root@trarfik-test ~]# curl http://localhost:8800/api|jq
```
{
"file": {
"backends": {
"testptmindcom": {
"servers": {
"server1": {
"url": "http://172.16.100.70:80",
"weight": 1
},
"server2": {
"url": "http://172.16.100.71:80",
"weight": 1
}
},
"circuitBreaker": {
"expression": "NetworkErrorRatio() > 0.5"
},
"loadBalancer": {
"method": "drr"
},
"maxConn": {
"amount": 10,
"extractorFunc": "request.host"
}
}
},
"frontends": {
"testptmindcom": {
"entryPoints": [
"http",
"https"
],
"backend": "testptmindcom",
"routes": {
"service": {
"rule": "Host:test.ptmind.com,pttest.ptmind.com;"
}
},
"passHostHeader": true,
"priority": 10
}
}
}
}
```
### 注意：
1：traefik 可以热加载配置文件，不用每次都重启服务，在修改主配置文件选项或着修改域名监听端口时，需要重启服务；
2：一组配置内， "backends": "frontends" 名称要统一；
3：注意观察实例中的名称配置；
### 参考文档
https://docs.traefik.io/toml/
http://docs.traefik.io/toml/#retry-configuration
