ReplacePath

Updating the Path Before Forwarding the Request

Replace the path of the request URL.

Configuration Examples

Docker & Swarm

  1. # Replace the path with /foo
  2. labels:
  3.   - "traefik.http.middlewares.test-replacepath.replacepath.path=/foo"

Kubernetes

  1. # Replace the path with /foo
  2. apiVersion: traefik.io/v1alpha1
  3. kind: Middleware
  4. metadata:
  5.   name: test-replacepath
  6. spec:
  7.   replacePath:
  8.     path: /foo

Consul Catalog

  1. # Replace the path with /foo
  2. - "traefik.http.middlewares.test-replacepath.replacepath.path=/foo"

File (YAML)

  1. # Replace the path with /foo
  2. http:
  3.   middlewares:
  4.     test-replacepath:
  5.       replacePath:
  6.         path: "/foo"

File (TOML)

  1. # Replace the path with /foo
  2. [http.middlewares]
  3.   [http.middlewares.test-replacepath.replacePath]
  4.     path = "/foo"

Configuration Options

General

The ReplacePath middleware will:

  • replace the actual path with the specified one.
  • store the original path in a X-Replaced-Path header.

path

The path option defines the path to use as replacement in the request URL.