使用Traefik重写URL：微服务环境反向代理配置咨询

这问题我之前在项目里配置过好多次，刚好能给你讲清楚两种环境下的实现方法——不管是Kubernetes（预发布/生产）还是本地docker-compose，核心都是利用Traefik的**路径重写（Path Rewriting）**功能，让你的微服务只需要监听根路径/，完全不用关心外部访问的URL前缀。

一、本地Docker-Compose环境配置 #

在docker-compose里，我们通过给服务添加Traefik标签（labels）来定义路由和中间件。以你的orders服务为例，假设你希望外部通过http://localhost/orders（或自定义域名的/orders路径）访问它，而服务本身监听http://orders:8080/：

完整的docker-compose.yml片段 #

version: '3.8'

services:
  traefik:
    image: traefik:v2.10
    command:
      - "--api.insecure=true" # 本地调试用，生产环境请勿开启
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--entrypoints.web.address=:80"
    ports:
      - "80:80"
      - "8080:8080" # Traefik Dashboard端口，方便调试
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock"

  orders:
    image: your-orders-service-image:latest
    expose:
      - "8080"
    labels:
      - "traefik.enable=true"
      # 匹配所有以/orders开头的请求
      - "traefik.http.routers.orders.rule=PathPrefix(`/orders`)"
      # 绑定到web入口点
      - "traefik.http.routers.orders.entrypoints=web"
      # 定义路径重写中间件：去掉/orders前缀
      - "traefik.http.middlewares.orders-strip-prefix.stripprefix.prefixes=/orders"
      # 给路由应用这个中间件
      - "traefik.http.routers.orders.middlewares=orders-strip-prefix@docker"
      # 指定转发到orders服务的8080端口
      - "traefik.http.services.orders.loadbalancer.server.port=8080"

配置说明 #

• PathPrefix(/orders)：告诉Traefik，所有以/orders开头的请求都交由这个路由处理
• stripprefix.prefixes=/orders：中间件会自动把请求URL里的/orders前缀去掉，比如外部请求/orders/api/list，转发到orders服务时就变成了/api/list
• orders-strip-prefix@docker：@docker表示这个中间件是通过Docker Provider定义的，Traefik能自动识别并加载

二、Kubernetes（预发布/生产）环境配置 #

在K8s里，我们需要用Ingress资源（或Traefik专属的IngressRoute CRD）配置路由，同时配合Middleware CRD实现路径重写。

第一步：确保Traefik已加载所需CRDs #

如果你用Traefik官方Helm Chart安装，默认已经包含了Middleware、IngressRoute等CRD资源；如果是手动部署Traefik，需要先创建对应的CRD（可以从Traefik官方文档复制CRD的YAML内容）。

第二步：定义路径重写的Middleware #

创建一个Middleware资源，用来移除/orders前缀：

apiVersion: traefik.containo.us/v1alpha1
kind: Middleware
metadata:
  name: orders-strip-prefix
  namespace: your-namespace # 替换为你的服务所在命名空间
spec:
  stripPrefix:
    prefixes:
      - "/orders"
    forceSlash: false # 可选，根据服务需求调整是否强制保留末尾斜杠

执行kubectl apply -f middleware.yaml完成创建。

第三步：配置Ingress（或IngressRoute） #

方式1：标准Ingress资源

通过Traefik专属注解关联中间件：

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: orders-ingress
  namespace: your-namespace
  annotations:
    kubernetes.io/ingress.class: "traefik" # 指定使用Traefik作为Ingress控制器
    # 关联中间件，格式：<命名空间>-<中间件名>@kubernetescrd
    traefik.ingress.kubernetes.io/router.middlewares: "your-namespace-orders-strip-prefix@kubernetescrd"
spec:
  rules:
    - host: api.your-domain.com # 替换为你的实际域名
      http:
        paths:
          - path: "/orders"
            pathType: Prefix
            backend:
              service:
                name: orders-service # 替换为你的orders服务的Service名称
                port:
                  number: 8080 # 服务监听的端口

方式2：Traefik专属IngressRoute（更灵活）

用Traefik自定义CRD配置，语法更直观：

apiVersion: traefik.containo.us/v1alpha1
kind: IngressRoute
metadata:
  name: orders-ingressroute
  namespace: your-namespace
spec:
  entryPoints:
    - web # 生产环境建议用websecure（HTTPS）
  routes:
    - match: PathPrefix(`/orders`)
      kind: Rule
      services:
        - name: orders-service
          port: 8080
      middlewares:
        - name: orders-strip-prefix

配置说明 #

• stripPrefix中间件的作用和docker-compose环境完全一致：剥离请求前缀后转发给服务，让服务只需要处理根路径的请求
• 标准Ingress的注解里必须指定完整的中间件标识，确保Traefik能正确找到对应的资源

关键注意点 #

1. 版本兼容性：以上配置均基于Traefik v2+，v1版本的配置逻辑完全不同（比如在frontends里配置stripPrefix），别搞混了——我之前就因为没注意版本，折腾了好半天。
2. 服务内部链接：如果服务页面用的是相对路径（比如<a href="/api/list">），Traefik会自动处理路径跳转；如果是绝对路径，可能需要在服务里配置基础路径，或者用Traefik的replacePathRegex中间件替换响应中的路径（一般服务监听根路径的话，相对路径就足够了）。
3. 验证方法：配置完成后，可以用curl测试：

   curl http://api.your-domain.com/orders/api/list
   

   查看orders服务的日志，如果收到的是GET /api/list HTTP/1.1，说明路径重写已经生效。

内容的提问来源于stack exchange，提问作者alastairs