# Собственные модули В этом справочнике описаны собственные модули Angie, даны примеры конфигурации, перечислены их директивы и параметры, а также встроенные переменные. ## Основной модуль | [Основной модуль](https://angie.software//angie/docs/configuration/modules/core.md#core) | Управление служебными файлами, процессами и другими модулями Angie. | |--------------------------------------------------------------------------------------------|-----------------------------------------------------------------------| ## HTTP-модули | [HTTP](https://angie.software//angie/docs/configuration/modules/http/index.md#http-core) | Основная функциональность для обработки HTTP-запросов и ответов,
управления HTTP-сервером, соединениями и статическими файлами. | |--------------------------------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [Access](https://angie.software//angie/docs/configuration/modules/http/http_access.md#http-access) | Контроль доступа на основе IP-адресов и диапазонов CIDR. | | [ACME](https://angie.software//angie/docs/configuration/modules/http/http_acme.md#http-acme) | Автоматическое получение и обновление SSL-сертификатов
по протоколу ACME для HTTP-серверов. | | [Docker](https://angie.software//angie/docs/configuration/modules/http/http_docker.md#http-docker) | Динамическое обновление групп проксируемых серверов
по Docker-меткам контейнеров. | | [Addition](https://angie.software//angie/docs/configuration/modules/http/http_addition.md#http-addition) | Вставка заданного фрагмента до или после тела ответа. | | [API](https://angie.software//angie/docs/configuration/modules/http/http_api.md#http-api) | RESTful HTTP-интерфейс для получения базовой информации о веб-сервере и
его статистики в формате JSON,
а также управления группами проксируемых серверов. | | [Auth Basic](https://angie.software//angie/docs/configuration/modules/http/http_auth_basic.md#http-auth-basic) | Базовая HTTP-аутентификация для контроля доступа
по имени пользователя и паролю. | | [Auth Request](https://angie.software//angie/docs/configuration/modules/http/http_auth_request.md#http-auth-request) | Авторизация с помощью подзапроса к внешнему HTTP-сервису. | | [AutoIndex](https://angie.software//angie/docs/configuration/modules/http/http_autoindex.md#http-autoindex) | Автоматический листинг директорий без индексного файла. | | [Browser](https://angie.software//angie/docs/configuration/modules/http/http_browser.md#http-browser) (устарел) | Определение браузера на основе заголовка `User-Agent`. | | [Charset](https://angie.software//angie/docs/configuration/modules/http/http_charset.md#http-charset) | Настройка и преобразование кодировки ответа. | | [DAV](https://angie.software//angie/docs/configuration/modules/http/http_dav.md#http-dav) | Управление файлами на сервере по протоколу WebDAV. | | [Empty GIF](https://angie.software//angie/docs/configuration/modules/http/http_empty_gif.md#http-empty-gif) | Отдача однопиксельного прозрачного GIF. | | [FastCGI](https://angie.software//angie/docs/configuration/modules/http/http_fastcgi.md#http-fastcgi) | Проксирование запроса к FastCGI-серверу. | | [FLV](https://angie.software//angie/docs/configuration/modules/http/http_flv.md#http-flv) | Псевдо-стриминг файлов в формате Flash Video (FLV). | | [Geo](https://angie.software//angie/docs/configuration/modules/http/http_geo.md#http-geo) | Преобразование IP-адресов в заданные значения переменных. | | [GeoIP](https://angie.software//angie/docs/configuration/modules/http/http_geoip.md#http-geoip) | Получение данных об IP-адресах
на основе геолокации по базам MaxMind GeoIP. | | [gRPC](https://angie.software//angie/docs/configuration/modules/http/http_grpc.md#http-grpc) | Проксирование запроса к gRPC-серверу. | | [GunZIP](https://angie.software//angie/docs/configuration/modules/http/http_gunzip.md#http-gunzip) | Распаковка сжатых GZip-ответов для их модификации и в случаях,
когда клиент не поддерживает компрессию. | | [GZip](https://angie.software//angie/docs/configuration/modules/http/http_gzip.md#http-gzip) | Сжатие ответов методом GZip для экономии трафика. | | [GZip Static](https://angie.software//angie/docs/configuration/modules/http/http_gzip_static.md#http-gzip-static) | Отдача статических файлов, предварительно сжатых методом GZip. | | [Headers](https://angie.software//angie/docs/configuration/modules/http/http_headers.md#http-headers) | Изменение полей заголовка ответа. | | [HTTP2](https://angie.software//angie/docs/configuration/modules/http/http_v2.md#http-v2) | Обработка запросов по протоколу HTTP/2. | | [HTTP3](https://angie.software//angie/docs/configuration/modules/http/http_v3.md#http-v3) | Обработка запросов по протоколу HTTP/3. | | [Image Filter](https://angie.software//angie/docs/configuration/modules/http/http_image_filter.md#http-image-filter) ^[1](#id10) | Преобразование изображений. | | [Index](https://angie.software//angie/docs/configuration/modules/http/http_index.md#http-index) | Настройка индексных файлов,
обслуживающих запросы с косой чертой в конце (`/`). | | [Limit Conn](https://angie.software//angie/docs/configuration/modules/http/http_limit_conn.md#http-limit-conn) | Ограничение числа одновременных запросов (активных соединений)
для защиты от перегрузки. | | [Limit Req](https://angie.software//angie/docs/configuration/modules/http/http_limit_req.md#http-limit-req) | Ограничение частоты запросов
для защиты от перегрузки и подбора паролей. | | [Log](https://angie.software//angie/docs/configuration/modules/http/http_log.md#http-log) | Настройка журнала запросов для отслеживания обращений к ресурсам
с целью мониторинга и анализа. | | [Map](https://angie.software//angie/docs/configuration/modules/http/http_map.md#http-map) | Преобразование переменных на основе предопределенных пар "ключ-значение". | | [Metric](https://angie.software//angie/docs/configuration/modules/http/http_metric.md#http-metric) | Пользовательские числовые метрики в API статистики. | | [Memcached](https://angie.software//angie/docs/configuration/modules/http/http_memcached.md#http-memcached) | Получение ответов от Memcached-сервера. | | [Mirror](https://angie.software//angie/docs/configuration/modules/http/http_mirror.md#http-mirror) | Зеркалирование запросов на другие серверы. | | [MP4](https://angie.software//angie/docs/configuration/modules/http/http_mp4.md#http-mp4) | Псевдо-стриминг файлов в формате MP4. | | [Perl](https://angie.software//angie/docs/configuration/modules/http/http_perl.md#http-perl) ^[1](#id10) | Обработчики для расширения функциональности
путем задания дополнительной логики на языке Perl. | | [Prometheus](https://angie.software//angie/docs/configuration/modules/http/http_prometheus.md#http-prometheus) | Метрики сервера в формате, совместимом с Prometheus,
для мониторинга и сбора статистики. | | [Proxy](https://angie.software//angie/docs/configuration/modules/http/http_proxy.md#http-proxy) | Реверсивное проксирование запросов к другим HTTP-серверам. | | [Random Index](https://angie.software//angie/docs/configuration/modules/http/http_random_index.md#http-random-index) | Случайный выбор индексного файла для запросов,
оканчивающихся косой чертой (`/`). | | [RealIP](https://angie.software//angie/docs/configuration/modules/http/http_realip.md#http-realip) | Определение адреса и порта клиента
при работе за другим прокси-сервером. | | [Referer](https://angie.software//angie/docs/configuration/modules/http/http_referer.md#http-referer) | Валидация значений заголовка `Referer`. | | [Rewrite](https://angie.software//angie/docs/configuration/modules/http/http_rewrite.md#http-rewrite) | Модификация URI запроса, перенаправления, установка переменных
и выбор конфигурации по условию. | | [SCGI](https://angie.software//angie/docs/configuration/modules/http/http_scgi.md#http-scgi) | Проксирование запроса к SCGI-серверу. | | [Secure Link](https://angie.software//angie/docs/configuration/modules/http/http_secure_link.md#http-secure-link) | Создание защищенных ссылок с возможностью ограничения срока доступа. | | [Slice](https://angie.software//angie/docs/configuration/modules/http/http_slice.md#http-slice) | Разделение запроса на множество подзапросов к отдельным фрагментам
для лучшего кэширования больших ответов. | | [Split Clients](https://angie.software//angie/docs/configuration/modules/http/http_split_clients.md#http-split-clients) | Создание переменных для A/B-тестирования, канареечных релизов, шардинга
и других сценариев, требующих разделения по пропорциональным группам. | | [SSI](https://angie.software//angie/docs/configuration/modules/http/http_ssi.md#http-ssi) | Обработка команд SSI (Server Side Includes) в ответах. | | [SSL](https://angie.software//angie/docs/configuration/modules/http/http_ssl.md#http-ssl) | Настройка SSL/TLS для обработки запросов по протоколу HTTPS. | | [Stub Status](https://angie.software//angie/docs/configuration/modules/http/http_stub_status.md#http-stub-status) (устарел) | Глобальные счетчики соединений и запросов в текстовом формате. | | [Sub](https://angie.software//angie/docs/configuration/modules/http/http_sub.md#http-sub) | Поиск и замена фрагментов в теле ответа. | | [Upstream](https://angie.software//angie/docs/configuration/modules/http/http_upstream.md#http-upstream) | Настройка групп проксируемых серверов для балансировки нагрузки. | | [Upstream Probe](https://angie.software//angie/docs/configuration/modules/http/http_upstream_probe.md#http-upstream-probe) | Настройка активных проверок работоспособности
для групп проксируемых серверов. | | [UserID](https://angie.software//angie/docs/configuration/modules/http/http_userid.md#http-userid) | Выдача и обработка cookie с уникальным идентификатором клиента
для отслеживания сеансов и аналитики. | | [uWSGI](https://angie.software//angie/docs/configuration/modules/http/http_uwsgi.md#http-uwsgi) | Проксирование запроса к uWSGI-серверу. | | [XSLT](https://angie.software//angie/docs/configuration/modules/http/http_xslt.md#http-xslt) ^[1](#id10) | Преобразование XML-документов с помощью языка XSLT. | ## Потоковые модули | [Stream](https://angie.software//angie/docs/configuration/modules/stream/index.md#stream-core) | Основная функциональность потокового сервера
для балансировки протоколов TCP и UDP на уровне L4. | |----------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------| | [Access](https://angie.software//angie/docs/configuration/modules/stream/stream_access.md#stream-access) | Контроль доступа на основе IP-адресов и диапазонов CIDR. | | [ACME](https://angie.software//angie/docs/configuration/modules/stream/stream_acme.md#stream-acme) | Автоматическое получение и обновление SSL-сертификатов
по протоколу ACME для потоковых серверов. | | [Geo](https://angie.software//angie/docs/configuration/modules/stream/stream_geo.md#stream-geo) | Преобразование IP-адресов в заданные значения переменных. | | [GeoIP](https://angie.software//angie/docs/configuration/modules/stream/stream_geoip.md#stream-geoip) | Получение данных об IP-адресах
на основе геолокации по базам MaxMind GeoIP. | | [Limit Conn](https://angie.software//angie/docs/configuration/modules/stream/stream_limit_conn.md#stream-limit-conn) | Ограничение числа одновременных соединений
для защиты от перегрузки. | | [Log](https://angie.software//angie/docs/configuration/modules/stream/stream_log.md#stream-log) | Настройка журнала сессий для отслеживания обращений к ресурсам
с целью мониторинга и анализа. | | [Map](https://angie.software//angie/docs/configuration/modules/stream/stream_map.md#stream-map) | Преобразование переменных на основе предопределенных пар "ключ-значение". | | [MQTT Preread](https://angie.software//angie/docs/configuration/modules/stream/stream_mqtt_preread.md#stream-mqtt-preread) | Чтение идентификатора клиента и имени пользователя из соединения по
протоколу MQTT до момента принятия решения о балансировке. | | [Pass](https://angie.software//angie/docs/configuration/modules/stream/stream_pass.md#stream-pass) | Передача принятых соединений
напрямую в настроенный слушающий сокет. | | [Proxy](https://angie.software//angie/docs/configuration/modules/stream/stream_proxy.md#stream-proxy) | Настройка проксирования к другим серверам. | | [RDP Preread](https://angie.software//angie/docs/configuration/modules/stream/stream_rdp_preread.md#stream-rdp-preread) | Чтение cookie из соединения по протоколу RDP
до момента принятия решения о балансировке. | | [RealIP](https://angie.software//angie/docs/configuration/modules/stream/stream_realip.md#stream-realip) | Определение адреса и порта клиента
при работе за другим прокси-сервером. | | [Return](https://angie.software//angie/docs/configuration/modules/stream/stream_return.md#stream-return) | Отправка в ответ клиенту при его подключении
заданного значения без дальнейшего проксирования. | | [Set](https://angie.software//angie/docs/configuration/modules/stream/stream_set.md#stream-set) | Установка заданных значений переменных. | | [Split Clients](https://angie.software//angie/docs/configuration/modules/stream/stream_split_clients.md#stream-split-clients) | Создание переменных для A/B-тестирования, канареечных релизов, шардинга
и других сценариев, требующих разделения по пропорциональным группам. | | [SSL](https://angie.software//angie/docs/configuration/modules/stream/stream_ssl.md#stream-ssl) | Терминация протоколов SSL/TLS и DTLS. | | [SSL Preread](https://angie.software//angie/docs/configuration/modules/stream/stream_ssl_preread.md#stream-ssl-preread) | Извлечение информации из сообщения `ClientHello` без терминации
SSL/TLS и до момента принятия решения о балансировке. | | [Upstream](https://angie.software//angie/docs/configuration/modules/stream/stream_upstream.md#stream-upstream) | Настройка групп проксируемых серверов для балансировки нагрузки. | | [Upstream Probe](https://angie.software//angie/docs/configuration/modules/stream/stream_upstream_probe.md#stream-upstream-probe) | Настройка активных проверок работоспособности
для групп проксируемых серверов. | ## Почтовые модули | [Mail](https://angie.software//angie/docs/configuration/modules/mail/index.md#mail-core) ^[1](#id10) | Основная функциональность почтового прокси-сервера. | |------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------| | [Auth HTTP](https://angie.software//angie/docs/configuration/modules/mail/mail_auth_http.md#mail-auth-http) | Аутентификация пользователей и выбор сервера для последующего
проксирования с помощью HTTP-запросов к внешнему серверу. | | [IMAP](https://angie.software//angie/docs/configuration/modules/mail/mail_imap.md#mail-imap) | Поддержка протокола IMAP. | | [POP3](https://angie.software//angie/docs/configuration/modules/mail/mail_pop3.md#mail-pop3) | Поддержка протокола POP3. | | [Proxy](https://angie.software//angie/docs/configuration/modules/mail/mail_proxy.md#mail-proxy) | Настройка проксирования к другим серверам. | | [RealIP](https://angie.software//angie/docs/configuration/modules/mail/mail_realip.md#mail-realip) | Определение адреса и порта клиента
при работе за другим прокси-сервером. | | [SMTP](https://angie.software//angie/docs/configuration/modules/mail/mail_smtp.md#mail-smtp) | Поддержка протокола SMTP. | | [SSL](https://angie.software//angie/docs/configuration/modules/mail/mail_ssl.md#mail-ssl) | Поддержка протоколов SSL/TLS и StartTLS. | ## Модуль Google PerfTools | [Google PerfTools](https://angie.software//angie/docs/configuration/modules/google_perftools.md#google-perftools) | Отвечает за интеграцию с библиотекой Google Performance Tools для
профилирования и анализа производительности приложений. | |---------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------| ## Модули WASM | [WASM](https://angie.software//angie/docs/configuration/modules/wasm/index.md#wasm-core) ^[1](#id10) | Основная функциональность WASM, позволяющая запускать WASM-код в Angie. | |------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------| | [WAMR](https://angie.software//angie/docs/configuration/modules/wasm/wasm_wamr.md#wasm-wamr) | Интеграция с
[WebAssembly Micro Runtime](https://github.com/bytecodealliance/wasm-micro-runtime). | | [Wasmtime](https://angie.software//angie/docs/configuration/modules/wasm/wasm_wasmtime.md#wasm-wasmtime) | Интеграция со средой выполнения [Wasmtime](https://wasmtime.dev/). | ### Сноски * **[1]** В наших сборках эти модули собираются динамически и устанавливаются [отдельными пакетами](https://angie.software//angie/docs/installation/index.md#install-packages); см. подробности в описании каждого модуля.