Nginx rewrite: перенаправить URL по правилу

Категория: Nginx · Обновлено:

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.