Traefik StripPrefix 中间件文档

StripPrefix（去除路径前缀）

stripPrefix 中间件会去除匹配的路径前缀，并将其存储到 X-Forwarded-Prefix 头中。

提示

当你的后端服务监听根路径 / 但需要在特定前缀下暴露时，请使用 StripPrefix 中间件。

配置示例

YAML 格式

# 去除 /foobar 和 /fiibar 前缀
http:
  middlewares:
    test-stripprefix:
      stripPrefix:
        prefixes:
          - "/foobar"
          - "/fiibar"

TOML 格式

# 去除 /foobar 和 /fiibar 前缀
[http.middlewares]
  [http.middlewares.test-stripprefix.stripPrefix]
    prefixes = ["/foobar", "/fiibar"]

Labels 格式

# 去除 /foobar 和 /fiibar 前缀
labels:
  - "traefik.http.middlewares.test-stripprefix.stripprefix.prefixes=/foobar,/fiibar"

Tags 格式

// 去除 /foobar 和 /fiibar 前缀
{
  "Tags" : [
    "traefik.http.middlewares.test-stripprefix.stripprefix.prefixes=/foobar,/fiibar"
  ]
}

Kubernetes 格式

# 去除 /foobar 和 /fiibar 前缀
apiVersion: traefik.io/v1alpha1
kind: Middleware
metadata:
  name: test-stripprefix
spec:
  stripPrefix:
    prefixes:
      - /foobar
      - /fiibar

配置选项

prefixes

字段	描述	默认值	必填
prefixes	要从请求 URL 中去除的前缀列表。如果你的后端服务提供静态资源（如图片或 JavaScript 文件），它可以使用 X-Forwarded-Prefix 头来构造相对 URL。	[]	否

---

在生产环境使用 Traefik OSS？

如果你在工作中使用 Traefik，可以考虑为其添加企业级 API 网关能力或获取 Traefik OSS 的商业支持。

• 观看我们的 API 网关演示视频
• 申请 24/7/365 OSS 支持