Встроенные модули#

В этом справочнике описаны собственные модули Angie, даны примеры конфигурации, перечислены их директивы и параметры, а также встроенные переменные.

Основной модуль#

Модуль Core — управление служебными файлами, процессами и другими модулями Angie.

HTTP-модули#

Модуль HTTP — базовая функциональность HTTP-сервера.

В дополнение к нему доступны следующие модули:

Access

Контроль доступа на основе IP-адресов и диапазонов CIDR.

ACME

Автоматическое получение SSL-сертификатов по протоколу ACME.

Addition

Вставка заданного фрагмента до или после тела ответа.

API

RESTful HTTP-интерфейс для получения базовой информации о веб-сервере и его статистики в формате JSON, а также управления группами проксируемых серверов.

Auth Basic

Базовая HTTP-аутентификация для контроля доступа по имени пользователя и паролю.

Auth Request

Авторизация с помощью подзапроса к внешнему HTTP-сервису.

AutoIndex

Автоматический листинг директорий без индексного файла.

Browser (устарел)

Определение браузера на основе заголовка User-Agent.

Charset

Настройка и преобразование кодировки ответа.

DAV

Управление файлами на сервере по протоколу WebDAV.

Empty GIF

Отдача однопиксельного прозрачного GIF.

FastCGI

Проксирование запроса к FastCGI-серверу.

FLV

Псевдо-стриминг файлов в формате Flash Video (FLV).

Geo

Преобразование IP-адресов в заданные значения переменных.

GeoIP

Получение данных об IP-адресах на основе геолокации по базам MaxMind GeoIP.

gRPC

Проксирование запроса к gRPC-серверу.

GunZIP

Распаковка сжатых GZip-ответов для их модификации и в случаях, когда клиент не поддерживает компрессию.

GZip

Сжатие ответов методом GZip для экономии трафика.

GZip Static

Отдача статических файлов, предварительно сжатых методом GZip.

Headers

Изменение полей заголовка ответа.

HTTP2

Обработка запросов по протоколу HTTP/2.

HTTP3

Обработка запросов по протоколу HTTP/3.

Image Filter

Преобразование изображений.

Index

Настройка индексных файлов, обслуживающих запросы с косой чертой в конце (/).

JS

Обработчики для расширения функциональности путем задания дополнительной логики на njs, подмножестве языка JavaScript.

Limit Conn

Ограничение числа одновременных запросов (активных соединений) для защиты от перегрузки.

Limit Req

Ограничение частоты запросов для защиты от перегрузки и подбора паролей.

Log

Настройка журнала запросов для отслеживания обращений к ресурсам с целью мониторинга и анализа.

Map

Преобразование переменных на основе предопределенных пар «ключ-значение».

Memcached

Получение ответов от Memcached-сервера.

Mirror

Зеркалирование запросов на другие серверы.

MP4

Псевдо-стриминг файлов в формате MP4.

Perl

Обработчики для расширения функциональности путем задания дополнительной логики на языке Perl.

Prometheus

Метрики сервера в формате, совместимом с Prometheus, для мониторинга и сбора статистики.

Proxy

Реверсивное проксирование запросов к другим HTTP-серверам.

Random Index

Случайный выбор индексного файла для запросов, оканчивающихся косой чертой (/).

RealIP

Определение адреса и порта клиента при работе за другим прокси-сервером.

Referer

Валидация значений заголовка Referer.

Rewrite

Модификация URI запроса, перенаправления, установка переменных и выбор конфигурации по условию.

SCGI

Проксирование запроса к SCGI-серверу.

Secure Link

Создание защищенных ссылок с возможностью ограничения срока доступа.

Slice

Разделение запроса на множество подзапросов к отдельным фрагментам для лучшего кэширования больших ответов.

Split Clients

Создание переменных для A/B-тестирования, канареечных релизов, шардинга и других сценариев, требующих разделения по пропорциональным группам.

SSI

Обработка команд SSI (Server Side Includes) в ответах.

SSL

Настройка SSL/TLS для обработки запросов по протоколу HTTPS.

Stub Status (устарел)

Глобальные счетчики соединений и запросов в текстовом формате.

Sub

Поиск и замена фрагментов в теле ответа.

Upstream

Настройка групп проксируемых серверов для балансировки нагрузки.

UserID

Выдача и обработка cookie с уникальным идентификатором клиента для отслеживания сеансов и аналитики.

uWSGI

Проксирование запроса к uWSGI-серверу.

XSLT

Преобразование XML-документов с помощью языка XSLT.

Потоковые модули#

Модуль Stream — обеспечивает базовую функциональность потокового сервера для балансировки протоколов TCP и UDP на уровне L4.

В дополнение к нему доступны следующие модули:

Access

Контроль доступа на основе IP-адресов и диапазонов CIDR.

Geo

Преобразование IP-адресов в заданные значения переменных.

GeoIP

Получение данных об IP-адресах на основе геолокации по базам MaxMind GeoIP.

JS

Обработчики для расширения функциональности путем задания дополнительной логики на njs, подмножестве языка JavaScript.

Limit Conn

Ограничение числа одновременных соединений для защиты от перегрузки.

Log

Настройка журнала сессий для отслеживания обращений к ресурсам с целью мониторинга и анализа.

Map

Преобразование переменных на основе предопределенных пар «ключ-значение».

MQTT Preread

Чтение идентификатора клиента и имени пользователя из соединения по протоколу MQTT до момента принятия решения о балансировке.

Proxy

Настройка проксирования к другим серверам.

RealIP

Определение адреса и порта клиента при работе за другим прокси-сервером.

Return

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

Set

Установка заданных значений переменных.

Split Clients

Создание переменных для A/B-тестирования, канареечных релизов, шардинга и других сценариев, требующих разделения по пропорциональным группам.

SSL

Терминирование протоколов SSL/TLS и DTLS.

SSL Preread

Извлечение информации из сообщения ClientHello без терминирования SSL/TLS и до момента принятия решения о балансировке.

Upstream

Настройка групп проксируемых серверов для балансировки нагрузки.

Почтовые модули#

Модуль Mail — базовая функциональность почтового прокси-сервера.

В дополнение к нему доступны следующие модули:

Auth HTTP

Аутентификация пользователей и выбор сервера для последующего проксирования с помощью HTTP-запросов к внешнему серверу.

IMAP

Поддержка протокола IMAP.

POP3

Поддержка протокола POP3.

Proxy

Настройка проксирования к другим серверам.

RealIP

Определение адреса и порта клиента при работе за другим прокси-сервером.

SMTP

Поддержка протокола SMTP.

SSL

Поддержка протоколов SSL/TLS и StartTLS.

Прочие модули#

Google PerfTools

Интеграция с библиотекой Google Performance Tools для профилирования и анализа производительности приложений.