Traefik 它是一种开源边缘路由器，可以作为整个平台的入口(网关)，按照逻辑规则，处理路由的要求。

优点：

1. 发现自动服务
2. 原生兼容所有主要集群技术，例如 Kubernetes、Docker、Docker Swarm、AWS、Mesos、Marathon，而且可以同时处理多个。
3. 单独配置文件无需维护和同步，实时自动更新，无需重新启动，连接不会中断
4. 美的融合 dashboard 界面

Traefik 配置分为两部分：

• 全动态路由配置(动态配置)，从Provider获取*，*该系统定义了如何处理请求。该配置可改变无缝热负荷，无任何请求中断或连接丢失。
• 启动配置(静态配置)，设置与Provider连接并定义Traefik 侦听入口点。

在 Traefik 定义静态配置选项有三种不同的方法：相互排斥（即您只能同时使用一种）：

1. 在配置文件中
2. 在命令行参数中
3. 作为环境变量

启动时，Traefik 搜索以下位置的名称traefik.yml（或traefik.yaml或traefik.toml）的文件：

• /etc/traefik/
• $XDG_CONFIG_HOME/
• $HOME/.config/
• .(工作目录)

可以使用configFile参数覆盖它

traefik --configFile=foo/bar/myconfigfile.yml 

可以使用 traefik --help 获取参数

常见参数：

--accesslog： 设置访问日志(默认值:false）  --api： 启用 api/仪表板。(默认值:false）  --certificatesresolvers.<name>： (默认值:false）  --entrypoints.<name>： 定义入口点。（默认值：false）  --log： Traefik 日志设置。（默认值：false）  --pilot.dashboard： 启用仪表板 Traefik Pilot。（默认值：true）  --ping: 启用ping。（默认值：false）  --providers.docker： 使用默认设置启用 Docker 后端。（默认值：false） 

常见的环境变量有(和参数一样，只是大写，加上TRAEFIK_前缀）：

TRAEFIK_ACCESSLOG： 设置访问日志(默认值:false）  TRAEFIK_API： 启用 api/仪表板。(默认值:false）  TRAEFIK_CERTIFICATESRESOLVERS_<NAME>： (默认值:false）  TRAEFIK_ENTRYPOINTS_<NAME>： 定义入口点。（默认值：false）  TRAEFIK_LOG： Traefik 日志设置。（默认值：false）  TRAEFIK_PILOT_DASHBOARD： 启用仪表板 Traefik Pilot。（默认值：true）  TRAEFIK_PING: 启用ping。（默认值：false）  TRAEFIK_PROVIDERS_DOCKER： 使用默认设置启用 Docker 后端。（默认值：false） 

version: '3'  services:   reverse-proxy:     # 官方的 Traefik 2.0 Docker 镜像     image: traefik     # 开启 web UI 并且告诉 Traefik 监听 Docker     command:       - "--entrypoints.http.address=:80"       - "--entrypoints.https.address=:443"       - "--api=true"       - "--api.insecure=true"       - "--api.dashboard=true"       - "--api.debug=false"       - "--ping=true"       - "--providers.docker=true"       - "--providers.docker.watch=true"       - "--providers.docker.exposedbydefault=false"       - "-providers.docker.endpoint=unix:///var/run/docker.sock"
      - "--providers.docker.swarmMode=false"
      - "--providers.docker.useBindPortIP=false"
      - "--providers.docker.network=traefik"
      - "--providers.file=true"
      - "--providers.file.watch=true"
      - "--providers.file.directory=/etc/traefik/config"
      - "--providers.file.debugloggeneratedtemplate=true"
    ports:
      # HTTP 端口
      - "30080:80"
      # Web UI 端口(通过 --api.insecure=true 启用)
      - "38080:8080"
    volumes:
      # 这样 Traefik 可以监听 Docker 事件
      - /var/run/docker.sock:/var/run/docker.sock
      - /opt/traefik/config:/etc/traefik/config

EntryPoints 是 Traefik 的网络入口点。它们定义将接收请求的端口（无论是 HTTP 还是 TCP）

部署中指定，可以是启动命令参数：

command:
	- "--entrypoints.http.address=:80"

静态配置文件中：

entryPoints:
  http:
   address: ":80"

• endpoint必需*，*默认=“unix:///var/run/docker.sock”
• useBindPortIP可选，默认=false，Traefik 将请求路由匹配到容器的 IP/端口。设置useBindPortIP=true，Traefik 使用附加到容器绑定的 IP/端口，而不是其内部网络 IP/端口。当与traefik.http.services.<name>.loadbalancer.server.port标签结合使用时（告诉 Traefik 将请求路由匹配到特定端口），Traefik 会尝试在 port 上找到绑定traefik.http.services.<name>.loadbalancer.server.port。如果找不到这样的绑定，Traefik 会回退到容器的内部网络 IP，但仍然使用traefik.http.services.<name>.loadbalancer.server.port标签中设置的IP/端口 。
• exposedByDefault可选*，默认=true。*默认情况下Traefik 公开容器。如果设置为false，traefik.enable=true则从生成的路由配置中忽略没有标签的容器。
• network可选，默认=“”定义用于连接到所有容器的默认 docker 网络。可以使用traefik.docker.network标签在每个容器的基础上覆盖此选项。
• defaultRule*可选，默认=Host({ { normalize .Name }})。*如果标签未定义任何规则，则该选项定义要应用于容器的路由规则。
• swarmMode*可选，默认=false。*启用 Swarm 模式（而不是独立的 Docker）。
• swarmModeRefreshSeconds*可选，默认值=15。*定义群模式的轮询间隔（以秒为单位）。
• httpClientTimeout*可选，默认=0。*定义 HTTP 连接的客户端超时（以秒为单位）。如果它的值为0，则不设置超时。
• watch*可选，默认=true。*监听 Docker Swarm 事件。

# 在 labels 中指定
traefik.http.middlewares.中间件名称.中间件类型=

# 指定路由入口点，http为traefik启动时定义的端口
"traefik.http.routers.自定义路由名称.entrypoints=http"

# 定义路由规则，监听来自于域名的请求，Host中用`符号
"traefik.http.routers.自定义路由名称.rule=Host(`www.domain.com`)"

# 设置路由引用中间件
"traefik.http.routers.自定义路由名称.middlewares=中间件名称" 

# 指定路由后端为哪个service，多个service时需要具体指定路由到哪个
"traefik.http.routers.自定义路由名称.service=服务名" 

 ## 用于docker服务发现与负载均衡，自动发现指定端口的服务，作为后端服务
 ## 如果容器expose了单个端口，则 Traefik 使用此端口进行私有通信
 ## 如果一个容器 expose了多个端口，或者没有暴露任何端口，那么你必须使用标签手动指定 Traefik 应该使用哪个端口进行通信

"traefik.http.services.自定义服务名.loadbalancer.server.port=应用端口"

version: '3'
services:
  wg-easy:
    image: weejewel/wg-easy
    container_name: wg-easy
    environment:
      - WG_HOST=18.183.2.23
      - WG_DEFAULT_DNS=114.114.114.114,8.8.4.4
    ports:
      - "51820:51820/udp"
    sysctls:
      - net.ipv4.ip_forward=1
      - net.ipv4.conf.all.src_valid_mark=1
    cap_add:
      - NET_ADMIN
      - SYS_MODULE
    labels:

      # 启用 traefik 动态配置
      - "traefik.enable=true"

      # 设置trafik 网络
      - "traefik.docker.network=traefik"

      ## 定义名为 auth-user 的 基本认证 中间件，密码使用htpasswd生成，$作为转义字符
      - "traefik.http.middlewares.auth-users.basicauth.users=admin:$$apr1$$WArvArno$$CUyHO2J8dg6BQNUbhTiwA."   

      # 定义名为 wg-easy 的路由，该路由在入口点 Web（端口80）上侦听
      - "traefik.http.routers.wg-easy.entrypoints=http"

      ## 设置wg-easy路由入口点 引用中间件auth-users
      - "traefik.http.routers.wg-easy.middlewares=auth-users" 
      
      ## 定义此 wg-easy 路由规则，监听来自于域名为he.simple11618.xyz的请求，将其路由到服务
      - "traefik.http.routers.wg-easy.rule=Host(`he.simple11618.xyz`)"

      ## 将请求转发到容器上的端口，需要使用路由器上的service参数引用服务负载均衡器端口定义
      ## 默认转发到expose的第一个端口，多端口需要单独指定
      - "traefik.http.services.my-service.loadbalancer.server.port=51821"


    networks:
      - traefik

networks:
  traefik:
    external: true