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

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

Базовую функциональность управления служебными файлами, процессами и другими модулями Angie PRO обеспечивает модуль core.

HTTP-модули#

Модуль http обеспечивает базовую функциональность HTTP-сервера. В дополнение к нему доступны следующие модули:

access

Позволяет контролировать доступ на основе IP-адресов, диапазонов CIDR и других условий.

acme

Реализует поддержку протокола ACME.

addition

Позволяет добавлять текст в ответы от прокси-серверов.

api

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

auth_basic

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

auth_request

Позволяет делегировать авторизацию внешнему HTTP-сервису.

autoindex

Автоматически создает список файлов в каталогах, которые не содержат индексного файла.

browser

Позволяет обрабатывать запросы на основе User-Agent браузера.

charset

Позволяет изменять кодировку текста в HTTP-заголовках и теле ответа.

dav

Реализует поддержку протокола WebDAV.

empty_gif

Позволяет создавать пустые GIF-изображения.

fastcgi

Реализует поддержку протокола FastCGI.

flv

Обеспечивает поддержку потоковой передачи видео в формате Flash Video (FLV) через HTTP.

geoip

Позволяет использовать базы данных GeoIP для контроля доступа или настройки контента на основе геолокации.

geo

Позволяет определять географическую принадлежность клиентов на основе их IP-адресов.

grpc

Реализует поддержку протокола gRPC.

gunzip

Автоматически распаковывает HTTP-контент, закодированный в gzip, перед его передачей клиенту.

gzip

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

gzip_static

Позволяет предварительно сжимать статические файлы, что улучшает производительность сервера.

headers

Манипулирует HTTP-заголовками в запросах и ответах, позволяя их настроить.

image_filter

Позволяет изменять и обрабатывать изображения в форматах JPEG, PNG и GIF.

index

Указывает, какой файл будет использоваться в качестве индексного при доступе к каталогу.

js

Позволяет задавать обработчики на njs — подмножестве языка JavaScript.

limit_conn

Ограничивает количество одновременных подключений клиентов, чтобы предотвратить перегрузку сервера.

limit_req

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

log

Ведет журнал HTTP-запросов и ответов для мониторинга и анализа.

map

Позволяет динамически сопоставлять переменные на основе предопределенных пар ключ-значение.

memcached

Обеспечивает интеграцию с сервером Memcached для кэширования ответов на запросы.

mirror

Позволяет настраивать зеркалирование запросов на другие серверы.

mp4

Реализует поддержку потоковой передачи видео в формате MPEG-4 через HTTP.

perl

Добавляет выполнение Perl-скриптов для обработки запросов.

prometheus

Публикует метрики сервера в формате, совместимом с Prometheus.

proxy

Позволяет проксировать запросы к другим HTTP-серверам.

random_index

Настраивает случайный выбор индексного файла при доступе к каталогу.

realip

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

referer

Позволяет настраивать доступ к ресурсам в зависимости от значения заголовка Referer.

rewrite

Позволяет переписывать HTTP-запросы и ответы, что полезно для манипуляций с URL-адресами и перенаправлений.

scgi

Поддерживает обмен данными между Angie и SCGI-серверами.

secure_link

Позволяет создавать защищенные ссылки, которые автоматически истекают после определенного времени или количества запросов.

slice

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

split_clients

Позволяет распределять клиентов на группы на основе хэша или списка.

ssi

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

ssl

Реализует поддержку протокола SSL/TLS.

stub_status

Предоставляет доступ к информации о состоянии сервера, такой как активные подключения, запросы в секунду и другое, через простой HTTP-интерфейс.

sub

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

upstream

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

userid

Генерирует и управляет уникальными идентификаторами для клиентов, облегчая отслеживание сеансов и аналитику.

uwsgi

Обеспечивает коммуникацию между Angie и uWSGI-серверами.

v2

Реализует поддержку протокола HTTP/2.

v3

Реализует поддержку протокола HTTP/3.

xslt

Добавляет поддержку преобразования XML-документов с использованием таблиц стилей XSLT.

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

Модуль stream обеспечивает базовую функциональность потокового сервера. В дополнение к нему доступны следующие модули:

access

Позволяет контролировать доступ на основе IP-адресов, диапазонов CIDR и других условий.

geoip

Позволяет использовать базы данных GeoIP для контроля доступа или настройки контента на основе геолокации.

geo

Позволяет определять географическую принадлежность клиентов на основе их IP-адресов.

js

Позволяет задавать обработчики на njs — подмножестве языка JavaScript.

limit_conn

Ограничивает количество одновременных подключений клиентов, чтобы предотвратить перегрузку сервера.

log

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

map

Позволяет динамически сопоставлять переменные на основе предопределенных пар ключ-значение.

mqtt_preread

Позволяет извлекать идентификатор клиента и имя пользователя из пакетов MQTT.

proxy

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

realip

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

return

Позволяет возвращать заданный ответ на запрос клиента.

set

Позволяет устанавливать значения переменных.

split_clients

Позволяет распределять клиентов на группы на основе хэша или списка.

ssl_preread

Позволяет извлекать информацию из сообщения ClientHello без терминирования SSL/TLS.

ssl

Реализует поддержку протокола SSL/TLS.

upstream

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

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

Модуль mail обеспечивает базовую функциональность почтового сервера. В дополнение к нему доступны следующие модули:

auth_http

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

imap

Реализует поддержку протокола IMAP.

pop3

Реализует поддержку протокола POP3.

proxy

Позволяет проксировать запросы к другим почтовым серверам.

realip

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

smtp

Реализует поддержку протокола SMTP.

ssl

Реализует поддержку протокола SSL/TLS.

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

google_perftools

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