Traefik 入手及简单配置

20次阅读

共计 4008 个字符,预计需要花费 11 分钟才能阅读完成。

Traefik 入手及简单配置
Traefik 与 nginx 一样,是一款反向代理的工具,至于使用他原因基于以下几点

漂亮的 dashboard 界面
可基于容器 label 进行配置
新添服务简单,不用像 nginx 一样复杂配置,并且不用频繁重启
对 prometheus 和 k8s 的集成
尝试一下 …

接下来讲一下它的基本功能以及文件配置
安装
下载二进制文件,指定配置文件,直接执行可以启动。
./traefik -c traefik.toml
当然,你也可以通过 docker 启动,参考 Traefik Get Started。
另外,如果需要使用 docker 启动,需要所有的服务都在一个 network 中,或者设置 traefik 的 network 为 host。
启动成功后,可以访问 localhost:8080 访问 Dashboard 页面。
问题

每当有配置改动需要重启时,只能杀了进程,然后启动,导致服务有短暂的暂停
补充一下,每当使用 docker 新添一个服务时,不需要更改配置,或者更改部分配置时,如 file provider,traefik 会监听配置文件变化并自动重启。但是需要修改 https 的证书或者日志的路径时,需要手动重启。所以需要手动重启的时候并不是很多。

当配置文件修改后,会有语法错误,无法向 nginx -t 一样检查是否配置文件有问题

日志
[accessLog]

# Sets the file path for the access log. If not specified, stdout will be used.
# Intermediate directories are created if necessary.
#
# Optional
# Default: os.Stdout
#
filePath = “./traefik-access.json”

# Format is either “json” or “common”.
#
# Optional
# Default: “common”
#
format = “json”
日志文件配置为 json 格式,方便调试。同时,强烈推荐 jq,一款 linux 下解析 json 的工具。
以下是两个常用的命令,统计某个站点的请求以及响应时间。不过最好建议有专门的日志系统去处理,可以获取更完善的,更定制化的信息。另外,traefik 无法查看请求的 body。
# 筛选特定站点的请求
cat traefik-access.json | jq ‘select(.[“RequestHost”] == “shici.xiange.tech”) | {RequestPath, RequestHost, DownstreamStatus, “request_User-Agent”, OriginDuration}’

# 筛选大于 300ms 的接口
cat traefik-access.json | jq ‘select(.[“RequestHost”] == “shici.xiange.tech” and .OriginDuration > 300000000) | {RequestPath, RequestHost, DownstreamStatus,
“request_User-Agent”, OriginDuration, DownstreamContentSize}’
prometheus + grafana
jq 虽然可以分析日志,但是适合做日志的统计以及更细化的分析。
Prometheus 作为时序数据库,可以用来监控 traefik 的日志,支持更加灵活的查询,报警以及可视化。traefik 默认设置 prometheus 作为日志收集工具。另外可以使用 grafana 做为 prometheus 的可视化工具。
某个服务的平均响应时间

PromQL 为
sum(traefik_backend_request_duration_seconds_sum{backend=”$backend”}) / sum(traefik_backend_requests_total{backend=”$backend”}) * 1000
某个服务响应时长大于 300ms 的请求的个数
TODO
统计请求数大于 10000 的服务
TODO
entryPoint
http
http 配置在 entryPoints 中,暴露出 80 端口。开启 gzip 压缩,使用 compress = true 来配置。
[entryPoints]
[entryPoints.http]
address = “:80”
compress = true

# 如果配置了此项,会使用 307 跳转到 https
[entryPoints.http.redirect]
entryPoint = “https”
考虑到隐私以及安全,不对外公开的服务可以配置 Basic Auth,Digest Auth 或者 WhiteList,或者直接搭建 VPN,在内网内进行访问。如在我服务器上 xiange.tech 对外公开,xiange.me 只能通过 VPN 访问。
更多文档查看 Traefik entrypoints。
https
使用 Let’s Encrypt 安装证书后,在 entryPoints.https.tls.certificats 中指定证书位置。
[entryPoints]
[entryPoints.https]
address = “:443”
compress = true

[[entryPoints.https.tls.certificates]]
certFile = “/etc/letsencrypt/live/xiange.tech/fullchain.pem”
keyFile = “/etc/letsencrypt/live/xiange.tech/privkey.pem”
另外,traefik 默认开启 http2。
other
另外,如果需要暴露其它的端口出去,如 consul 的 8500,类似于 nginx 的 listen 指令。
可以设置
[entryPoints]
[entryPoints.consul]
address = “:8500”
Docker
traefik 会监听 docker.sock,根据容器的 label 进行配置。容器的端口号需要暴露出来,但是不需要映射到 Host。因为 traefik 可以通过 docker.sock 找到 container 的 IP 地址以及端口号,无需使用 docker-proxy 转发到 Host。
version: ‘3’
services:
frontend:
image: your-frontend-server-image
labels:
– “traefik.frontend.rule=Host:frontend.xiange.tech”

api:
image: your-api-server-image
expose: 80
labels:
# 同域配置,/api 走 server
– “traefik.frontend.rule=Host:frontend.xiange.tech;PathPrefix:/api”
如何给一个服务配置多个域名
labels:
– “traefik.prod.frontend.rule=Host:whoami.xiange.tech”
– “traefik.another.frontend.rule=Host:who.xiange.tech”
– “traefik.dev.frontend.rule=Host:whoami.xiange.me”
如何把前端和后端配置在统一域名
services:
frontend:
image: your-frontend-server-image
labels:
– “traefik.frontend.rule=Host:frontend.xiange.tech”

api:
image: your-api-server-image
expose: 80
labels:
– “traefik.frontend.rule=Host:frontend.xiange.tech;PathPrefix:/api”
部署时,如果项目代码有更新,如何当新服务 start 后,再去 drop 掉旧服务
TODO
负载均衡
如果使用 docker,对一个容器进行扩展后,traefik 会自动做负载均衡,而 nginx 需要手动干预。
version: ‘3’
services:
whoami:
image: emilevauge/whoami
labels:
– “traefik.frontend.rule=Host:whoami.xiange.tech”
手动扩展为 3 个实例,可以自动实现负载均衡。实现效果可以直接访问 whoami.xiange.tech,每次通过 WRR 策略分配到不同的容器处理,可以通过 Hostname 和 IP 字段看出。
docker-compose up whoami=3
手动配置
当然,以上反向代理配置都是基于 docker,那如何像 nginx 一样配置呢。如把 consul.xiange.me 转发到 8500 这个端口。可以利用 traefik 的 file provider。
[file]
[backends]
# consul 是服务的名字,也可以叫张三,也可以叫李四
[backends.consul]
[backends.consul.servers]
[backends.consul.servers.website]
url = “http://0.0.0.0:8500”
weight = 1

[frontends]
[frontends.consul]
entryPoints = [“http”]
backend = “consul”
[frontends.consul.routes]
# website 是路由的名字,也可以叫阿猫,也可以叫阿狗
[frontends.consul.routes.website]
rule = “Host:consul.xiange.me”

# 可以配置多个域名
[frontends.consul.routes.website2]
rule = “Host:config.xiange.me”

正文完
 0