Traefik CN 创建 Skill 全流程指南：从基础配置到生产环境避坑

4次阅读

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

在微服务架构中，传统反向代理（如 Nginx/HAProxy）面临三大挑战：

配置僵化 ：每次服务变更需手动修改配置并重启
缺乏服务感知 ：无法自动发现容器 /Kubernetes 服务
维护成本高 ：SSL 证书、路由规则等需人工管理

Traefik 作为云原生边缘路由器，通过动态配置和自动服务发现机制完美解决这些问题。其核心优势体现在：

实时配置热更新 ：监控服务变化自动生效，无需重启
多平台支持 ：原生集成 Docker/Kubernetes/Consul 等服务发现
声明式配置 ：通过 Label 或 YAML 定义路由规则

特性	Nginx	HAProxy	Traefik
动态配置	需 Reload	需 Reload	实时生效
服务发现	需第三方工具	有限支持	原生支持
中间件链	复杂 Rewrite	有限支持	声明式组合
监控指标	需插件扩展	内置	原生 Prometheus 集成

（示意图：EntryPoint 接收请求 → Router 匹配规则 → Service 转发到后端）

创建 docker-compose.yml 文件：

version: '3'

services:
  reverse-proxy:
    image: traefik:v2.6
    ports:
      - "80:80"
      - "443:443"
      # 启用管理界面
      - "8080:8080"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./traefik.yml:/etc/traefik/traefik.yml
    command:
      - "--api.insecure=true"  # 生产环境应配置认证
      - "--providers.docker=true"

  whoami:
    image: containous/whoami
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.whoami.rule=Host(`whoami.example.com`)"
      - "traefik.http.routers.whoami.entrypoints=web"

关键参数说明：

providers.docker：启用 Docker 服务发现
api.insecure：管理接口（生产环境需配置 TLS）
labels：定义路由规则（Host 匹配 + EntryPoint 绑定）

创建 traefik.yml 定义全局配置：

entryPoints:
  web:
    address: ":80"
  websecure:
    address: ":443"

providers:
  docker:
    exposedByDefault: false  # 显式启用服务

api:
  dashboard: true
  insecure: true  # 仅限测试环境

实现请求头修改 + 路径前缀剥离：

# docker-compose.yml 片段
labels:
  - "traefik.http.middlewares.add-header.headers.customHeader=X-Custom-Value"
  - "traefik.http.middlewares.strip-prefix.stripprefix.prefixes=/api"
  - "traefik.http.routers.myapp.middlewares=add-header,strip-prefix"

使用 Let’s Encrypt 自动签发证书：

# traefik.yml 追加内容
certificatesResolvers:
  myresolver:
    acme:
      email: your@email.com
      storage: acme.json
      httpChallenge:
        entryPoint: web

然后在服务标签中启用：

labels:
  - "traefik.http.routers.mysite.tls.certresolver=myresolver"
  - "traefik.http.routers.mysite.entrypoints=websecure"

限制每秒 100 个请求：

labels:
  - "traefik.http.middlewares.limit.ratelimit.average=100"
  - "traefik.http.middlewares.limit.ratelimit.burst=50"
  - "traefik.http.routers.myapp.middlewares=limit"

按权重分流流量：

# v1 服务 (90% 流量)
labels:
  - "traefik.http.services.myapp.loadbalancer.server.weight=90"

# v2 服务 (10% 流量)
labels:
  - "traefik.http.services.myapp-canary.loadbalancer.server.weight=10"

启用 Prometheus 指标采集：

# traefik.yml
metrics:
  prometheus:
    entryPoint: web

将 Docker Label 配置转换为 IngressRoute CRD：

apiVersion: traefik.containo.us/v1alpha1
kind: IngressRoute
metadata:
  name: myroute
spec:
  entryPoints:
    - web
  routes:
  - match: Host(`example.com`) && PathPrefix(`/api`)
    kind: Rule
    services:
    - name: myservice
      port: 80
    middlewares:
    - name: auth-header