StripPrefixRegex
Remove the matching prefixes from the URL path.
Docker
Kubernetes
apiVersion: traefik.containo.us/v1alpha1
kind: Middleware
name: test-stripprefixregex
spec:
stripPrefixRegex:
regex:
- "/foo/[a-z0-9]+/[0-9]+/"
Consul Catalog
Marathon
"labels": {
}
File (YAML)
http:
middlewares:
test-stripprefixregex:
stripPrefixRegex:
regex:
File (TOML)
Configuration Options
The StripPrefixRegex middleware strips the matching path prefix and stores it in a X-Forwarded-Prefix
header.
Tip
Use a stripPrefixRegex
middleware if your backend listens on the root path () but should be exposed on a specific prefix.
regex
For instance, /products
also matches /products/shoes
and /products/shirts
.
If your backend is serving assets (e.g., images or JavaScript files), it can use the X-Forwarded-Prefix
header to properly construct relative URLs. Using the previous example, the backend should return /products/shoes/image.png
(and not /images.png
, which Traefik would likely not be able to associate with the same backend).
Tip
Regular expressions and replacements can be tested using online tools such as Go Playground or the .
When defining a regular expression within YAML, any escaped character needs to be escaped twice: example\.com
needs to be written as .