Представляем Livops 2.0! ПромокодCEOдарит 8 000 сумов на ваш счёт.Что нового
Сборка и настройка / Редиректы и заголовки

Сборка и настройка

Редиректы и заголовки

Файлы _redirects, _headers, vercel.json и netlify.toml для статических сайтов — что работает и что нет.

Редиректами (redirect) и HTTP-заголовками статического сайта вы управляете через файлы. Файлы должны лежать в корне результата сборки (например, public/_redirects → dist/_redirects). vercel.json и netlify.toml могут лежать и в корне проекта: у собираемого сайта они сами переносятся в релиз (если в результате сборки нет файла с тем же именем).

Файлы читаются при каждом запросе, поэтому изменения вступают в силу сразу после завершения деплоя.

_redirects

Каждая строка: откуда куда [статус]. Строка, начинающаяся с #, — комментарий.

# старые страницы
/old-page        /new-page         301
/blog/:slug      /news/:slug       301
/docs/*          /help/:splat      302

# SPA или внутренняя перезапись (rewrite)
/app/*           /app/index.html   200

# редирект на внешний адрес
/telegram        https://example.com/contact  302

# страницы нет
/private/*       /404              404
  • откуда должно начинаться с /.
  • Если статус не указан — 301.
  • Допустимые статусы: 200 (перезапись внутри сайта), 301, 302, 307, 308, 404. Строка с другим статусом отбрасывается.
  • :имя — один сегмент пути. * в конце захватывает всё остальное и в цели становится :splat.
  • Срабатывает первое подходящее правило.
  • ! после статуса принимается, но особого значения не имеет.
  • Строка запроса сохраняется: /old?utm_source=tg → /new?utm_source=tg. Если у цели есть свой ?..., остаётся он.

_headers

Строка с путём, под ней — строки Имя: значение, начинающиеся с отступа:

/*
  X-Frame-Options: DENY
  Referrer-Policy: strict-origin-when-cross-origin

/assets/*
  Cache-Control: public, max-age=31536000, immutable

:имя и * в пути работают так же, как в _redirects.

vercel.json

Для сайта, переехавшего с Vercel, читаются три ключа из vercel.json:

{
  "redirects": [
    { "source": "/old", "destination": "/new", "permanent": true }
  ],
  "rewrites": [
    { "source": "/app/:path*", "destination": "/app/index.html" }
  ],
  "headers": [
    {
      "source": "/assets/(.*)",
      "headers": [{ "key": "Cache-Control", "value": "public, max-age=31536000" }]
    }
  ]
}
  • redirects: если есть statusCode — используется он; иначе permanent: false — 307, в противном случае 308.
  • rewrites превращаются в правило со статусом 200.
  • :имя*, :имя+ или (.*) в конце понимаются как *. Только в конце.
  • cleanUrls не нужен: запрос /about и так отдаёт about.html. trailingSlash игнорируется.
  • Правила vercel.json проверяются после правил _redirects и _headers.

netlify.toml

Для сайта, переехавшего с Netlify, читаются [[redirects]] и [[headers]] из netlify.toml:

[[redirects]]
  from = "/old"
  to = "/new"
  status = 301

[[redirects]]
  from = "/app/*"
  to = "/app/index.html"
  status = 200

[[headers]]
  for = "/assets/*"
  [headers.values]
    Cache-Control = "public, max-age=31536000, immutable"
  • В from, to и for :имя и * работают так же, как в _redirects; допустимые статусы те же.
  • Если status не указан — 301.
  • Правило с conditions (страна, язык, роль) пропускается. Раздел [build] здесь не читается.
  • Правила netlify.toml проверяются после _redirects, _headers и vercel.json.

Ограничения

  • Каждый файл — до 1000 строк и 64 KB.
  • Rewrite (прокси) на другой сайт не поддерживается. Цель правила 200 или 404 должна начинаться с /; правило 200 на https://... отбрасывается. На внешний адрес можно перенаправить только с 301/302/307/308.
  • Следующие заголовки задать нельзя (они молча отбрасываются): Set-Cookie, Location, Content-Length, Content-Encoding, Transfer-Encoding, Connection.

404 и SPA

  • Если в результате сборки есть 404.html, он отдаётся с настоящим статусом 404.
  • Если обнаружено приложение с клиентским роутером (React Router, Vue Router и т. п.), на запросы страниц без расширения файла отдаётся index.html. Отсутствующее изображение или скрипт всё равно вернут 404.

Есть вопрос? — @livops_uz