> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lampac.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Middleware Pipeline Lampac NextGen

> Подробная схема цепочки middleware Lampac NextGen: от ForwardedHeaders до Controllers, WAF, accsdb и RCH-эндпоинтов.

Цепочка middleware Lampac NextGen формируется в `Startup.Configure` и определяет порядок обработки каждого HTTP-запроса: от приема соединения и проксирования заголовков до проверки безопасности, авторизации и вызова контроллеров. Некоторые компоненты включаются условно в зависимости от `init.conf`.

На этой странице приведена полная последовательность middleware, описание каждого этапа и особенности жизненного цикла конфигурации.

## Полная цепочка middleware

<Steps>
  <Step title="ForwardedHeaders">
    Обработка заголовков от reverse proxy (`X-Forwarded-For`, `X-Forwarded-Proto`, `X-Forwarded-Host`). Корректирует схему, хост и IP клиента.
  </Step>

  <Step title="BaseMod">
    Базовая модификация запроса: установка культуры, обработка служебных заголовков, подготовка контекста для последующих middleware.
  </Step>

  <Step title="ModHeaders">
    Дополнительная обработка и нормализация HTTP-заголовков, требуемых модулями.
  </Step>

  <Step title="RequestInfo">
    Сбор метаданных запроса: тайминги, счетчики, идентификация маршрута. Данные используются статистикой (`/stats/request`) и логированием.
  </Step>

  <Step title="/nws WebSocket">
    При необходимости маппинг WebSocket-эндпоинта `/nws` (NativeWebSocket). Проходит через WAF перед передачей в обработчик WebSocket.
  </Step>

  <Step title="Routing">
    ASP.NET Core Routing: определение контроллера и действия по маршруту запроса.
  </Step>

  <Step title="Compression / Staticache">
    Сжатие ответа (Gzip/Brotli) и кеширование статических ответов через Staticache для анонимных запросов.
  </Step>

  <Step title="Ранний UseModule">
    Подписка на событие `EventListener.Middleware` для модулей, которым требуется ранний доступ к конвейеру (например, для перехвата или модификации запроса до основной обработки).
  </Step>

  <Step title="ProxyImg">
    Проксирование изображений и медиа: `/proxy/`, `/proxyimg`, M3U8/MPD/DASH. Обработка через NetVips и потоковые прокси.
  </Step>

  <Step title="StaticFiles">
    Отдача статических файлов из `wwwroot/`: SISI UI, виджеты, JS-плагины, статистика.
  </Step>

  <Step title="WAF">
    Web Application Firewall: геоблокировка (`countryAllow`), белый список IP (`whiteIps`), защита от брутфорса (`bruteForceProtection`), лимиты запросов (`limit_map`). Если запрос не проходит проверку, возвращается ошибка 403.
  </Step>

  <Step title="Authorization">
    ASP.NET Core Authorization: проверка политик доступа, настроенных для отдельных маршрутов.
  </Step>

  <Step title="Accsdb">
    Проверка учетных записей и сроков действия (`accsdb`). Если включено, запросы без валидного аккаунта блокируются. Поддерживает формат `user:YYYY-MM-DD` и подробный JSON-массив `users`.
  </Step>

  <Step title="Поздний UseModule">
    Второй этап вызова `UseModule` для модулей, которым требуется доступ после авторизации и WAF.
  </Step>

  <Step title="Лимиты, статистика, контроллеры, RCH">
    Финальные middleware: лимитирование запросов, сбор статистики (`openstat`), маппинг контроллеров (`MapControllers`), RCH-эндпоинты (`/rch/result`, `/rch/gzresult`) и WebSocket `/ws`.
  </Step>
</Steps>

## Упрощенная схема

```text theme={null}
ForwardedHeaders
    → BaseMod
    → ModHeaders
    → RequestInfo
    → [/nws WebSocket]
    → Routing
    → Compression / Staticache
    → Ранний UseModule (EventListener.Middleware)
    → ProxyImg
    → StaticFiles
    → WAF
    → Authorization
    → Accsdb
    → Поздний UseModule
    → Лимиты / Статистика / Controllers / RCH
```

<Note>
  Точный порядок и наличие отдельных middleware зависит от `init.conf` и флага `BaseModule.Middlewares`. Например, WAF и Accsdb можно отключить, а `/nws` маппируется только при активном использовании WebSocket.
</Note>

## Жизненный цикл конфигурации

Конфигурация Lampac работает без перезапуска сервера. За это отвечает `CoreInit` в проекте `Shared`.

<Steps>
  <Step title="Первоначальная загрузка">
    При первом обращении к `CoreInit` загружается `init.conf` (и при наличии `init.yaml`). Значения из `base.conf` используются как fallback для отсутствующих параметров.
  </Step>

  <Step title="Фоновый watcher">
    `CoreInit` запускает фоновый цикл с интервалом примерно **1 секунда**, который отслеживает время изменения файлов конфигурации.
  </Step>

  <Step title="Обновление при изменении">
    При обнаружении изменения вызывается `updateConf`, обновляется `CurrentConf`, рассылается событие `EventListener.UpdateInitFile`, и модули перечитывают свои секции (например, через `ModuleInvoke.Init`).
  </Step>

  <Step title="Резервные копии">
    Перед применением новой конфигурации создается резервная копия в каталоге **`database/backup/init/`**. Также записывается файл `current.conf` с актуальным состоянием.
  </Step>
</Steps>

<Note>
  Благодаря горячей перезагрузке вы можете менять порты, включать или отключать модули, редактировать WAF-листы и лимиты без остановки сервера. Изменения применяются в течение 1 секунды после сохранения файла.
</Note>