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

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

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

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

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

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

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

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

1.  Перейдите в раздел «App Platform» и выберите нужное приложение. 
    
2.  Откройте вкладку «Настройки». 
    
3.  В строке «Настройки веб-сервера» нажмите «Настроить». 
    
4.  Укажите нужные параметры и нажмите «Сохранить».  
    

![Настройка параметров веб-сервера](https://content.timeweb.com/assets/2815ee04-97b0-4fe9-b36f-8d9e3be40240.png?width=1078&height=1418)

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` секунд.