Rewrites

Rewrites отдают контент по другому пути или с другого сервера, не меняя URL в адресной строке браузера. В отличие от редиректов, пользователь не видит изменения адреса.

Типы rewrites

Тип	Описание	Пример
Внутренний	Отдаёт файл по другому пути в рамках проекта	`/app` → `/index.html`
Внешний (прокси)	Проксирует запрос на внешний сервер	`/api/*` → `https://api.example.com/:splat`

Создание rewrite

Откройте проект → Settings → Routing Rules
Выберите окружение в правом верхнем углу
Перейдите на вкладку Rewrites
Нажмите Добавить rewrite
Заполните поля:
- Исходный путь — входящий URL (например, /api/*)
- Путь назначения — куда проксировать
- Внешний — включите для проксирования на внешний сервер
Выберите окружения и нажмите Добавить

Внутренние rewrites

Внутренние rewrites отдают файлы вашего проекта по другим путям. Это полезно для SPA (Single Page Applications) и “чистых” URL.

SPA fallback

Для SPA-приложений все маршруты должны вести на index.html:

/* → /index.html

Запрос	Результат
`/dashboard`	Отдаётся `/index.html`
`/user/123`	Отдаётся `/index.html`
`/settings`	Отдаётся `/index.html`

Чистые URL

/blog/:slug → /blog/:slug.html

Запрос	Результат
`/blog/hello`	Отдаётся `/blog/hello.html`
`/blog/world`	Отдаётся `/blog/world.html`

Внешние rewrites (прокси)

Внешние rewrites проксируют запросы на другой сервер. URL в браузере не меняется, но контент приходит с внешнего источника.

Прокси API

/api/* → https://api.example.com/:splat (внешний)

Запрос	Проксируется на
`/api/users`	`https://api.example.com/users`
`/api/products/123`	`https://api.example.com/products/123`

Прокси с дополнительными заголовками

При создании внешнего rewrite можно добавить заголовки, которые будут отправляться на внешний сервер:

{
  "X-API-Key": "your-secret-key",
  "Authorization": "Bearer token"
}

Эти заголовки не видны клиенту — они добавляются только к запросу на внешний сервер.

Паттерны путей

Wildcard

/old/* → /new/:splat

Запрос	Результат
`/old/page`	`/new/page`
`/old/a/b/c`	`/new/a/b/c`

Именованные параметры

/user/:id/profile → /profiles/:id

Запрос	Результат
`/user/123/profile`	`/profiles/123`

Комбинация

/v1/:resource/* → https://api.example.com/v2/:resource/:splat

Запрос	Проксируется на
`/v1/users/123`	`https://api.example.com/v2/users/123`
`/v1/products/list`	`https://api.example.com/v2/products/list`

Опция Force

Как и редиректы, rewrites по умолчанию не применяются, если файл существует.

Force выключен
Force включён

Правило: /page → /index.html

Файл /page.html существует?
├─ Да  → Отдаётся /page.html
└─ Нет → Отдаётся /index.html

Правило: /page → /index.html (force)

Всегда отдаётся /index.html

Безопасность внешних rewrites

ONREZA применяет защиту от SSRF-атак (Server-Side Request Forgery):

Блокируются запросы к приватным IP-адресам (10.x.x.x, 192.168.x.x, 127.0.0.1)
Блокируются запросы к внутренним сервисам
Разрешены только HTTP и HTTPS протоколы

Порядок обработки

Rewrites проверяются после редиректов. Если для URL сработал редирект, rewrite не применяется.

Запрос → Проверка редиректов → Проверка rewrites → Отдача контента

Типичные сценарии

API Gateway

/api/* → https://api.example.com/:splat

Все API-запросы проксируются на отдельный сервер.

Микрофронтенды

/app1/* → https://app1.example.com/:splat
/app2/* → https://app2.example.com/:splat

Разные части приложения на разных серверах.

A/B тестирование

/landing → https://variant-b.example.com/landing

Показ альтернативной версии страницы.

Legacy API

/api/v1/* → https://old-api.example.com/:splat
/api/v2/* → https://new-api.example.com/:splat

Постепенная миграция между версиями API.

Serverless functions

/functions/* → https://functions.example.com/:splat

Проксирование на платформу serverless-функций.

Отладка

Если rewrite не работает:

Проверьте порядок правил — редиректы имеют приоритет над rewrites
Проверьте тип rewrite — для внешнего URL должен быть включён флаг “Внешний”
Проверьте URL назначения — для внешних rewrites требуется полный URL с протоколом
Проверьте доступность — внешний сервер должен быть доступен

Проверьте конфигурацию в Project → Settings → Routing Rules.

Лимиты

Параметр	Лимит
Правил на окружение	1000
Длина паттерна пути	500 символов
Длина URL назначения	2000 символов
Proxy headers на правило	50

См. также

Обзор правил роутинга — общая информация
Редиректы — HTTP перенаправления
Заголовки — кастомные HTTP-заголовки