# MQTT Preread Позволяет извлекать идентификатор клиента и имя пользователя из пакетов `CONNECT` протокола Message Queuing Telemetry Transport (MQTT) версий [3.1.1](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718028) и [5.0](https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Toc3901033). При [сборке из исходного кода](https://angie.software//angie/docs/installation/sourcebuild.md#sourcebuild) модуль необходимо включить с помощью [параметра сборки](https://angie.software//angie/docs/installation/sourcebuild.md#configure) `--with-stream_mqtt_preread_module`. В пакетах и образах из [наших репозиториев](https://angie.software//angie/docs/installation/index.md#install-packages) модуль включен в сборку. ## Пример конфигурации ### Выбор сервера в группе по идентификатору клиента: ```nginx stream { mqtt_preread on; upstream mqtt { hash $mqtt_preread_clientid; # ... } } ``` ## Директивы ### mqtt_preread | [Синтаксис](https://angie.software//angie/docs/configuration/configfile.md#configfile) | `mqtt_preread` `on` | `off`; | |------------------------------------------------------------------------------------------|--------------------------------| | По умолчанию | `mqtt_preread off;` | | [Контекст](https://angie.software//angie/docs/configuration/configfile.md#configfile) | stream, server | Управляет извлечением информации из пакета `CONNECT` на этапе [предварительного чтения](https://angie.software//angie/docs/configuration/processing.md#stream-sessions). Если параметр включен (`on`), то в контексте, где он задан, заполняются перечисленные ниже переменные. ## Встроенные переменные Подробное описание семантики значений см. в спецификации протокола MQTT версий [3.1.1](http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718031) и [5.0](https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Toc3901033). ### `$mqtt_preread_clientid` Уникальный идентификатор клиента. ### `$mqtt_preread_username` Необязательное имя пользователя.