traefik/docs/content/middlewares/http/replacepath.md
2023-03-20 15:38:08 +01:00

1.6 KiB

title description
Traefik ReplacePath Documentation In Traefik Proxy's HTTP middleware, ReplacePath updates paths before forwarding requests. Read the technical documentation.

ReplacePath

Updating the Path Before Forwarding the Request {: .subtitle }

Replace the path of the request URL.

Configuration Examples

# Replace the path with /foo
labels:
  - "traefik.http.middlewares.test-replacepath.replacepath.path=/foo"
# Replace the path with /foo
apiVersion: traefik.io/v1alpha1
kind: Middleware
metadata:
  name: test-replacepath
spec:
  replacePath:
    path: /foo
# Replace the path with /foo
- "traefik.http.middlewares.test-replacepath.replacepath.path=/foo"
"labels": {
  "traefik.http.middlewares.test-replacepath.replacepath.path": "/foo"
}
# Replace the path with /foo
labels:
  - "traefik.http.middlewares.test-replacepath.replacepath.path=/foo"
# Replace the path with /foo
http:
  middlewares:
    test-replacepath:
      replacePath:
        path: "/foo"
# Replace the path with /foo
[http.middlewares]
  [http.middlewares.test-replacepath.replacePath]
    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.