nginx URL

rewrite URL and

Syntax

rewrite regex replacement [flag];

Parameters

ParametersDescriptionExamplesLevel
last rewrite New location rewrite ^/old/(.*)$ /new/$1 last; Common
break rewrite New rewrite ^/img/(.*)$ /data/images/$1 break; Common
redirect 302 rewrite ^/temp$ /new redirect; Common
permanent 301 rewrite ^/old$ /new permanent; Common
return ( rewrite ) return 301 https://$host$request_uri; Common

Examples

URL

rewrite ^/(.*)/$ /$1 permanent;
/about/ → /about

location /blog {
    rewrite ^/blog/post-(\d+)$ /articles/$1 permanent;
}
/blog/post-123 → /articles/123

www

server {
    server_name example.com;
    return 301 https://www.example.com$request_uri;
}
return rewrite

API

rewrite ^/api/v1/(.*)$ /api/current/$1 last;
, URL

Common Errors

rewriterewrite, last break
Parametersrewrite Parameters, ?

Tips

Related Commands