跳转到主要内容

traefik-gateway-dashboard

本文为dashboard用法，基础用法请参考：traefik-gateway

重要bug提醒：截止至2023-06-22,如果动态创建的服务发现，少于1个中间件，则会出错，既需要保证整个项目至少要有一个中间件。可以随便写一个，但是必须要有一个。

三个镜像

  • traefik
    • push swr.cn-south-1.myhuaweicloud.com/vp-whdev/all-in-devops/traefik:202306051
内置插件：rewritebody
内置插件：rewriteHeaders

更新日志：2023-06-26

修改内置插件偶尔会失效的问题

  • 动态服务发现

    • swr.cn-south-1.myhuaweicloud.com/vp-whdev/all-in-devops/traefik-service-discovery:202306051

    更新日志：2023-06-21：

    • 打包dashboard面板到一个服务，无需再部署dashboard
    • 增加服务监控

  • dashboard面板:

    • swr.cn-south-1.myhuaweicloud.com/vp-whdev/all-in-devops/traefik-service-discovery-dashboard-front:stage

    更新日志：2023-06-21

    • dashboard面板已经集成到动态服务发现,无需部署

安装部署说明

  • 部署: traefik
# 建议服务名：traefik-gateway
# 端口开放
# 80，http端口
# 443,https端口
# 8080,traefik自带的dashboard端口，可以不开放
  • 部署traefik-service-discovery
# 服务名必须为 traefik-service-discovery


# 端口开放
# 8080，非必须

# 环境变量
spring.profiles.active = mysqlProd
# mysqlProd，使用mysql数据库,prod，使用sqlite数据库
# 如果使用sqlite数据库，需要注意数据库持久化路径，容器目录/data,容器初始化时会自动复制初始化数据库文件。
# sqlite不支持服务监控

app.datasource.host =
app.datasource.name=
app.datasource.password =
app.datasource.username =
  • 数据库初始化脚本
CREATE TABLE `traefik_gateway_config` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键id',
  `route_name` varchar(255) DEFAULT NULL COMMENT '路由名称',
  `access_path` varchar(255) DEFAULT NULL COMMENT '访问路径',
  `service_type` int(2) DEFAULT NULL COMMENT '后端服务类型: 1:http 2:tcp 3:udp',
  `service_address` varchar(255) DEFAULT NULL COMMENT '后端服务地址',
  `middleware` text COMMENT '中间件',
  `status` int(255) DEFAULT NULL COMMENT '启用/禁用状态: 0:禁用 1:启用',
  `deleted` int(255) DEFAULT '0' COMMENT '删除状态: 0:不删除 1:删除',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC COMMENT='网关配置';

CREATE TABLE `global_middleware` (
  `id` int(11) NOT NULL AUTO_INCREMENT COMMENT '主键id',
  `global_middleware` longtext COMMENT '全局中间件',
  PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC COMMENT='全局中间件';
  • traefik-service-discovery-dashboard-fron
# 2023-06-21,本服务已经集成到traefik-service-discovery，不需要部署
# 端口开放:80
# 访问路径/front/
  • 负载均衡配置
路径 服务 说明 备注
/ traefik 网站根目录 必须
/traefik-dashboard/ traefik traefik内置的dashboard 非必须，如果没有配置网站根目录则需要
/traefikconfig-dashboard/ traefik traefik动态路由dashboard 非必须，如果没有配置网站根目录则需要
/traefik-service-discovery/ traefik 动态路由api 非必须，如果没有配置网站根目录则需要

首页不是从根目录开始

如果你的首页不是从根目录开始，则需要做一些单独的配置，实现原理为，将dashboard需要用到的3个路径处理为所需要的目录。

复制下面的配置文件，挂载到traefik-gatewy的容器路径

# 使用k8s集群时，建议使用配置映射卷

./index-not-root.yaml:/etc/traefik/conf.d/conf2/index-not-root.yaml

需要在负载均衡加入配置

路径 服务 说明 备注
/minio/ traefik 业务路由入口 必须
/_minio/ traefik 面板路由入口 如果配置了下面三个路径，则是非必须
/_minio/traefik-dashboard/ traefik traefik内置的dashboard 非必须，如果没有配置面板入口则需要
/_minio/traefikconfig-dashboard/ traefik 动态路由dashboard 非必须，如果没有配置面板入口则需要
/_minio/traefik-service-discovery/ traefik 动态路由api 非必须，如果没有配置面板入口则需要 

http:
  routers:
    # 首页不是根目录
    index-not-root:
    # 注意路由匹配前缀，填写你的实际路径，为了保证一致性，建议本服务使用 _ 开头
    # 注意中间件中的路径前缀，应该和路由路径一致，
    # 注意重写header的前缀，应该和路由路径一致。
    # 根据本路由规则，可以看出是将服务又重定向到traefik-gateway,即多了一层不必要的代理，会带来性能损失。
    # 由此，这个额外的路由，只应该用于处理traefik控制面板
    # 真正的服务不应该由此处理，而应该直接指向到traefik-gateway
    # 既你需要配置面板路由路径，应该与你的服务路径，使用不通的名称
    # 本次使用的是 _minio ,请将本文的_minio 替换为你需要的
      # rule: "PathPrefix(`/_minio/`)" 
    # 2023-06-22,：只处理dashboard相关的3个路径，以开启面板，业务路由在面板进行配置，以解决多了一层代理问题   
      rule: "PathPrefix(`/_minio/traefik-dashboard/`) || PathPrefix(`/_minio/traefikconfig-dashboard/`) || PathPrefix(`/_minio/traefik-service-discovery/`)"  
      service: index-not-root
      middlewares:
        - stripPrefix-index-not-root
        - rewritebody-index-not-root
        - rewriteHeaders-index-not-root
  services:
    index-not-root:
      loadBalancer:
        servers:
          - url: http://traefik-gateway:80    # 部署的traefik主程序必须叫这个名字或者修改为实际部署的名字
  middlewares:
  # 去除前缀  
    stripPrefix-index-not-root:
      stripPrefix:
        prefixes:
          - "/_minio/"
  # 正文路径改写
    rewritebody-index-not-root:
      plugin:
        plugin-rewritebody:                   # 要和静态配置文件的插件名称对应上
          rewrites:
            - regex: "/traefik-service-discovery/api/"
              replacement: "/_minio/traefik-service-discovery/api/"
            - regex: "/traefik-dashboard/api"
              replacement: "/_minio/traefik-dashboard/api"
            - regex: "/_minio/dashboard/"
              replacement: "/_minio/traefik-dashboard/dashboard/"
  # Header重定向改写
    rewriteHeaders-index-not-root:
      plugin:
        plugin-rewriteHeaders:                # 要和静态配置文件的插件名称对应上
          rewrites:
            - header: "Location"
              regex: "/_minio/dashboard/"
              replacement: "/_minio/traefik-dashboard/dashboard/"

插件使用

插件参考网址

middlewares:
# 删除路径前前缀，traefik默认会把整个URL路径全部传过来，会导致与后端路径不一致，需要进行路径删除处理
  stripPrefix-traefikconfig-dashboard:
    stripPrefix:
      prefixes:
        - "/traefikconfig-dashboard/"

# 增加路径前缀，对应与后端服务，即使在填写URL路径，traefik也不会处理后端路径，会导致与后端路径不一致，需要增加实际路径
  addPrefixFront-traefikconfig-dashboard:
    addPrefix:
      prefix: "/front/"

# 正文路径改写，由于某些情况下服务没有使用相对路径，需要对在页面写死的路径进行正则替换
  rewritebody-traefikconfig-dashboard:
      plugin:
        plugin-rewritebody: # 要和静态配置文件的插件名称对应上，本镜像仅能使用这个名字
          rewrites:
            - regex: "/api/"
              replacement: "/traefik-service-discovery/api/"   

# 基础身份验证
  basicAuth-traefikconfig-dashboard:
      basicAuth:
        removeHeader: true
        users:
          - "admin:" # 在线生成 http://www.jsons.cn/htpasswd/


# 发送到后端时修改header,例如后端限制了域名
  headers-peisong:
    headers:
      customRequestHeaders:
        host: "peisong.gxzszs.cn"

# 重写 header，对响应的head进行处理，例如写死的重定向
  rewriteHeaders-peisong:
    plugin:
      plugin-rewriteHeaders: # 要和静态配置文件的插件名称对应上，本镜像仅能使用这个名字
        rewrites:
          - header: "Location"
            regex: "peisong.gxzszs.cn"
            replacement: "peisong.gxfusui.com"
          - header: "Location"
            regex: "http://peisong.gxfusui.com/plugin.php"
            replacement: "/plugin.php"
回到顶部