Skip to main content

RedirectRegex

The RedirectRegex redirects a request using regex matching and replacement.

tip

Regular expressions and replacements can be tested using online tools such as Go Playground or the Regex101.
When defining a regular expression within YAML, any escaped character needs to be escaped twice: example\.com needs to be written as example\\.com.


Configuration Example

Redirect with domain replacement
apiVersion: traefik.io/v1alpha1
kind: Middleware
metadata:
name: test-redirectregex
spec:
redirectRegex:
regex: ^http://localhost/(.*)
replacement: http://mydomain/${1}

Configuration Options

FieldDescriptionDefaultRequired
regexThe regex option is the regular expression to match and capture elements from the request URL.""Yes
permanentEnable a permanent redirection.falseNo
replacementThe replacement option defines how to modify the URL to have the new target URL..
$1x is equivalent to ${1x}, not ${1}x (see Regexp.Expand), so use ${1} syntax.
""No