Сборка и настройка
Редиректы и заголовки
Файлы _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.