Настройка веб-сервера

App Platform автоматически настраивает веб-сервер при создании приложения. При необходимости вы можете изменить параметры обработки запросов и ответов: настроить редиректы, HTTP-заголовки, включить сжатие данных.

Набор доступных параметров зависит от типа приложения. Для frontend-приложений также можно настроить обработку несуществующих путей, а для backend- и Docker-приложений — ограничить размер тела запроса и время ожидания заголовков ответа.

Настройки веб-сервера применяются к доменам, привязанным к приложению.

Настройка веб-сервера

Чтобы изменить настройки веб-сервера:

1. Перейдите в раздел «App Platform» и выберите нужное приложение. 

2. Откройте вкладку «Настройки». 

3. В строке «Настройки веб-сервера» нажмите «Настроить». 

4. Укажите нужные параметры и нажмите «Сохранить».  

5. После сохранения настроек запустится деплой приложения.

Общие параметры

Для всех типов приложений доступна настройка редиректов, HTTP-заголовков и сжатия.

Редиректы

Редиректы позволяют перенаправлять запросы с одного пути или домена на другой. Для одного приложения можно добавить не более 10 редиректов.

Для настройки редиректа укажите:

• тип — path или host; 

• исходный путь или домен в поле Source; 

• целевой путь или домен в поле Destination; 

• код ответа в поле Code.

Доступны следующие коды ответа:

• 301 — постоянный редирект; 

• 302 — временный редирект; 

• 307 — временный редирект с сохранением метода и тела запроса; 

• 308 — постоянный редирект с сохранением метода и тела запроса.

Редирект по пути

Для редиректа по пути выберите тип path. Значения Source и Destination должны начинаться с /, например /old и /new.

При настройке учитывайте ограничения:

• исходный и целевой пути не должны совпадать; 

• в путях нельзя указывать параметры запроса после ? и фрагменты после #; 

• параметры исходного запроса сохраняются при редиректе.

Например, при редиректе с /old на /new запрос к /old?source=mail будет перенаправлен на /new?source=mail.

Редирект по домену

Для редиректа по домену выберите тип host. Исходный и целевой домены можно выбрать только среди доменов, привязанных к приложению.

Заголовки

Вы можете добавить, заменить или удалить HTTP-заголовки в ответах веб-сервера. Для одного приложения можно настроить не более 10 правил.

Для каждого заголовка выберите тип:

• set — задать новое значение заголовка или заменить существующее; 

• add — добавить еще одно значение заголовка; 

• delete — удалить заголовок из ответа.

Для типов set и add укажите имя и значение заголовка. Для типа delete укажите только имя.

Для одного имени заголовка нельзя:

• создать несколько правил типа set; 

• одновременно использовать разные типы — например, set и add или add и delete.

Несколько правил типа add для одного заголовка разрешены.

Сжатие

Сжатие уменьшает объем данных, которые веб-сервер передает клиенту, и может ускорить загрузку приложения.

Чтобы включить сжатие, выберите один или несколько алгоритмов:

• gzip; 

• zstd.

Параметры frontend-приложений

Для frontend-приложений дополнительно доступна настройка SPA Fallback.

SPA Fallback

SPA Fallback определяет, какой файл приложение будет возвращать при обращении к несуществующему пути.

Если опция включена, веб-сервер вернет файл /index.html.

Если опция выключена и в сборке есть файл /404.html, веб-сервер вернет его. Если файла нет, откроется пустая страница с кодом ответа 404.

Параметры backend- и Docker-приложений

Для backend-приложений, а также приложений, развернутых с помощью Dockerfile, Docker Compose или образа из Docker Hub, дополнительно доступна настройка ограничения размера тела запроса и таймаута ожидания заголовков ответа.

Максимальный размер тела запроса

Параметр ограничивает размер тела входящего HTTP-запроса. Например, с его помощью можно ограничить размер загружаемых файлов.

Укажите число больше 0. Значение рассчитывается в КБ, единицу измерения вводить не нужно.

Максимально допустимый размер тела запроса — 1 048 576 КБ, что эквивалентно 1 ГБ.

Если тело запроса превышает установленное ограничение, веб-сервер отклонит запрос до его передачи приложению.

Таймаут ожидания заголовков ответа

Параметр определяет, сколько времени веб-сервер будет ждать заголовки ответа от приложения.

Укажите число больше 0. Значение рассчитывается в миллисекундах, единицу измерения вводить не нужно. Например, чтобы задать таймаут в одну секунду, укажите 1000.

Максимально допустимый таймаут — 120 000 миллисекунд, то есть 120 секунд.