MQTT Preread#

Позволяет извлекать идентификатор клиента и имя пользователя из пакетов CONNECT протокола Message Queuing Telemetry Transport (MQTT) версий 3.1.1 и 5.0.

При сборке из исходного кода модуль необходимо включить с помощью параметра сборки ‑‑with‑stream_mqtt_preread_module. В пакетах и образах из наших репозиториев модуль включен в сборку.

Пример конфигурации#

Выбор сервера в группе по идентификатору клиента:#

stream {

    mqtt_preread on;

    upstream mqtt {
        hash $mqtt_preread_clientid;
        # ...
    }
}

Директивы#

mqtt_preread#

Синтаксис	`mqtt_preread` on \| off;
По умолчанию	`mqtt_preread off;`
Контекст	stream, server

Управляет извлечением информации из пакета CONNECT на этапе предварительного чтения. Если параметр включен (on), то в контексте, где он задан, заполняются перечисленные ниже переменные.

Встроенные переменные#

Подробное описание семантики значений см. в спецификации протокола MQTT версий 3.1.1 и 5.0.

`$mqtt_preread_clientid`#

Уникальный идентификатор клиента.

`$mqtt_preread_username`#

Необязательное имя пользователя.