MQTT Explorer

MQTT Explorer ist ein grafischer MQTT-Client für Desktop und Browser. Er ermöglicht es dir, MQTT-Nachrichten zu überwachen, zu analysieren und zu debuggen.

Installation

Füge das folgende Template in deine docker-compose.yml ein und führe anschließend ei23 dc aus.

Mosquitto erforderlich

MQTT Explorer benötigt einen MQTT-Broker. Standardmäßig wird Mosquitto mit dem ei23-Skript installiert.

Template

  mqtt-explorer:
    image: sapk/mqtt-explorer
    container_name: mqtt-explorer
    restart: unless-stopped
    ports:
      - "4004:4004"

Erster Start

Nach dem Start erreichst du MQTT Explorer unter http://[IP]:4004
Klicke auf + um eine neue Verbindung zu erstellen
Gib die IP-Adresse deines MQTT-Brokers ein (z.B. mosquitto oder 192.168.1.x)
Standard-Port: 1883

Verbindung konfigurieren

Feld	Wert
Host	`mosquitto` (Docker) oder IP-Adresse
Port	`1883`
Username	Dein MQTT-Username
Password	Dein MQTT-Passwort

Features

Echtzeit-Überwachung - Alle MQTT-Nachrichten live sehen
Topic-Baum - Übersichtliche Hierarchie aller Topics
Nachrichten senden - Manuell Nachrichten publishen
Statistiken - Nachrichtenhistorie und Grafiken
Filter - Suche nach Topics und Nachrichten
Export - Nachrichten als JSON exportieren

MQTT mit Home Assistant

Home Assistant nutzt MQTT für viele Integrationen:

Beispiel-Topics

Topic	Beschreibung
`homeassistant/#`	Home Assistant Discovery
`zigbee2mqtt/#`	Zigbee2MQTT Geräte
`rtl_433/#`	433MHz Sensoren
`esphome/#`	ESPHome Geräte

Home Assistant Discovery

ESPHome und Zigbee2MQTT nutzen Home Assistant Discovery:

# Automatisch konfigurierte Geräte erscheinen unter:
homeassistant/sensor/[device_name]/config

MQTT mit ESPHome

ESPHome kommuniziert standardmäßig über die Home Assistant API, kann aber auch MQTT nutzen:

mqtt:
  broker: 192.168.1.x
  username: mqtt_user
  password: !secret mqtt_password

Debuggen mit MQTT Explorer

So findest du Probleme mit MQTT:

Öffne MQTT Explorer
Filtere nach dem relevanten Topic
Prüfe ob Nachrichten gesendet/empfangen werden
Analysiere die Nachrichtenstruktur
Teste manuelles Senden von Nachrichten

Hinweise

Der Port ist standardmäßig 4004
MQTT Explorer ist auch als Desktop-App verfügbar
Ideal für die Fehlersuche bei MQTT-Problemen
Kann auch für Node-RED-Debugging genutzt werden