traefik/docs/content/middlewares/http/addprefix.md

61 lines
1.2 KiB
Markdown
Raw Permalink Normal View History

---
title: "Traefik AddPrefix Documentation"
description: "Learn how to implement the HTTP AddPrefix middleware in Traefik Proxy to updates request paths before being forwarded. Read the technical documentation."
---
# Add Prefix
Prefixing the Path
{: .subtitle }
2021-06-22 12:05:57 +00:00
![AddPrefix](../../assets/img/middleware/addprefix.png)
2021-02-11 13:34:04 +00:00
The AddPrefix middleware updates the path of a request before forwarding it.
## Configuration Examples
2023-05-10 13:28:05 +00:00
```yaml tab="Docker & Swarm"
2019-03-29 11:34:05 +00:00
# Prefixing with /foo
labels:
2019-09-23 15:00:06 +00:00
- "traefik.http.middlewares.add-foo.addprefix.prefix=/foo"
2019-03-29 11:34:05 +00:00
```
```yaml tab="Kubernetes"
2019-04-03 12:32:04 +00:00
# Prefixing with /foo
2023-03-20 14:38:08 +00:00
apiVersion: traefik.io/v1alpha1
2019-03-29 11:34:05 +00:00
kind: Middleware
metadata:
2019-04-03 12:32:04 +00:00
name: add-foo
2019-03-29 11:34:05 +00:00
spec:
2019-04-03 12:32:04 +00:00
addPrefix:
prefix: /foo
2019-03-29 11:34:05 +00:00
```
2019-10-15 15:34:08 +00:00
```yaml tab="Consul Catalog"
# Prefixing with /foo
- "traefik.http.middlewares.add-foo.addprefix.prefix=/foo"
```
2019-07-22 07:58:04 +00:00
```yaml tab="File (YAML)"
# Prefixing with /foo
http:
middlewares:
add-foo:
addPrefix:
prefix: "/foo"
```
```toml tab="File (TOML)"
# Prefixing with /foo
[http.middlewares]
[http.middlewares.add-foo.addPrefix]
prefix = "/foo"
```
## Configuration Options
2019-04-03 12:32:04 +00:00
### `prefix`
`prefix` is the string to add before the current path in the requested URL.
2021-02-11 13:34:04 +00:00
It should include a leading slash (`/`).