Traefik 新手入门：如何高效添加自定义中间件（Middleware）技能

7次阅读

没有评论

共计 2128 个字符，预计需要花费 6 分钟才能阅读完成。

Traefik 作为一款现代化的反向代理和负载均衡工具，其核心优势在于动态配置和中间件（Middleware）机制。中间件允许我们在请求到达后端服务前或响应返回客户端前，对流量进行各种处理，极大地扩展了 Traefik 的功能范围。

常见的使用场景包括：

请求修改：添加、删除或修改请求头，例如添加 X-Forwarded-For。
认证：集成 Basic Auth、OAuth 等认证机制。
限流：控制请求速率，防止服务被滥用。
重定向：将 HTTP 请求重定向到 HTTPS。

对于新手来说，掌握中间件的添加方法，是解锁 Traefik 高级功能的第一步。

Traefik 支持两种配置方式：静态配置和动态配置。

静态配置：通常用于定义 Traefik 自身的运行参数，例如日志级别、入口点等。静态配置在 Traefik 启动时加载，修改后需要重启服务才能生效。
动态配置：用于定义路由、服务、中间件等，支持热更新，无需重启 Traefik。动态配置可以通过多种方式实现，例如文件、Docker 标签、Kubernetes Ingress 注解等。

对于中间件的添加，动态配置 是更优的选择，原因如下：

灵活性：可以随时添加、修改或删除中间件，无需中断服务。
可维护性：配置与代码分离，便于管理。
生态友好：与 Docker、Kubernetes 等云原生工具集成更好。

下面以 Docker 为例，介绍如何动态添加中间件。

确保你已经安装了 Docker 和 Traefik。Traefik 的 Docker 镜像可以通过以下命令拉取：

docker pull traefik:v2.6

创建一个名为 traefik.yml 的文件，用于定义中间件。以下是一个添加自定义请求头的中间件示例：

http:
  middlewares:
    add-header:
      headers:
        customResponseHeaders:
          X-Custom-Header: "Hello, Traefik!"

这个中间件会在响应中添加一个名为 X-Custom-Header 的头部，值为 Hello, Traefik!。

创建一个 docker-compose.yml 文件，配置 Traefik 服务：

version: '3'

services:
  traefik:
    image: traefik:v2.6
    ports:
      - "80:80"
      - "8080:8080"  # Dashboard
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./traefik.yml:/etc/traefik/traefik.yml
    command:
      - --api.insecure=true
      - --providers.docker
      - --providers.file.filename=/etc/traefik/traefik.yml

运行以下命令启动 Traefik：

docker-compose up -d

访问 Traefik 的 Dashboard（默认地址为 http://localhost:8080），在中间件部分可以看到刚刚定义的 add-header 中间件。

以下是一个完整的中间件示例，用于修改请求头：

http:
  middlewares:
    modify-request:
      headers:
        customRequestHeaders:
          X-Original-Path: "{{.Request.Header.Get \"X-Original-Path\"}}"
          X-New-Header: "Modified by Traefik"

这个中间件会：