MQTT Preread#

Permite extraer identificadores de cliente y nombres de usuario de los paquetes CONNECT para Message Queuing Telemetry Transport (MQTT) versiones 3.1.1 y 5.0.

Cuando se compila desde el código fuente, este módulo no se compila por defecto; debe habilitarse con la opción de compilación --with-stream_mqtt_preread_module.

En paquetes e imágenes de nuestros repositorios, el módulo está incluido en la compilación.

Ejemplo de configuración#

Elegir un servidor en un grupo por ID de cliente:#

stream {

    mqtt_preread on;

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

Directivas#

mqtt_preread#

Sintaxis

mqtt_preread on | off;

Predeterminado

mqtt_preread off;

Contexto

stream, server

Controla la extracción de información de los paquetes CONNECT durante la fase de prelectura. Si el parámetro está habilitado (on), las variables listadas a continuación se rellenan en el contexto donde se especifica.

Variables integradas#

Para una descripción detallada de la semántica de los valores, consulte la especificación del protocolo MQTT versiones 3.1.1 y 5.0.

$mqtt_preread_clientid#

Identificador único de cliente.

$mqtt_preread_username#

Nombre de usuario opcional.