Nginx rewrite: перенаправить URL по правилу
rewrite меняет URI по регулярному выражению и может вернуть редирект. Директива работает в server и location, поддерживает захваты $1, $2 и флаги last, break, redirect, permanent. Для простых постоянных редиректов обычно проще return 301, но rewrite нужен для правил с шаблоном.
Переписать путь и вернуть 301
upstream backend {
server 127.0.0.1:9002;
}
server {
listen 80;
server_name example.com;
rewrite ^/old/(.*)$ /new/$1 permanent;
rewrite ^/blog/([0-9]+)/?$ /posts/$1 last;
location /posts/ {
proxy_pass http://backend;
proxy_set_header Host $host;
}
}permanent возвращает 301, redirect — 302. last заново ищет location по новому URI, break остаётся в текущем location и не перезапускает поиск. ^/old/(.*)$ захватывает остаток пути в $1; запрос /old/a получит /new/a.
Rewrite в server выполняется до выбора location. Если правило в location, учитывайте, что last может снова попасть в тот же location и зациклиться. Для редиректа на другой домен используйте return 301 https://example.com$request_uri; — это быстрее и понятнее.
Query-параметры сохраняются, если в замене нет ?; добавление ? в конец отбрасывает старые аргументы. Не используйте if для редиректов: if в Nginx имеет неочевидное поведение, а return и rewrite покрывают большинство задач.
Проверяйте правила через curl -I, а не только nginx -t: ошибка в захвате или порядке location видна только в ответе. Для отладки включите rewrite_log on; в server (уровень notice), но не оставляйте его на production без необходимости.
Документация: ngx_http_rewrite_module, return.