Rezept: MQTT-Bridge

Mosquitto oder Home-Assistant-MQTT bleibt in deinem LAN, die Werte gehen per HTTPS an ProbeHarbor für Frost- und Leckalarme und den Verlauf.

Nahaufnahme weißer Cat-5e-Ethernet-Kabel mit RJ45-Steckern
Das Fühler-JSON verlässt das LAN meist über Ethernet oder ein nahes Relay, nicht direkt übers öffentliche Internet. Foto: DiscDepotDundee.co.uk. CC BY-SA 4.0

ProbeHarbor ist kein MQTT-Broker. Behalte Mosquitto, ESPHome oder das MQTT von Home Assistant in deinem LAN und spiegle ausgewählte Topics über HTTPS, damit Frost- und Leckage-SMS/-E-Mails für den Haushalt und der Verlauf in der Cloud liegen, ohne dass der Broker offen im Netz steht.

Schnelle Brücke (curl)

Lege unter Dashboard → Devices ein Push-Gerät an, kopiere den Ingest-Schlüssel, ordne die JSON-Schlüssel deinem MQTT-Payload zu und sende dann einen POST:

curl -X POST "https://probeharbor.dev/api/ingest/mqtt" \
  -H "Content-Type: application/json" \
  -H "X-Ingest-Key: YOUR_DEVICE_KEY" \
  -d '{"topic":"home/garage/temp","message":{"temp1":42.5,"humidity":38}}'

Das vollständige Anlegen von Geräten (Push oder Pull) beschreibt Push- und Pull-Geräte hinzufügen. Payload-Formate und ausgehende Alarm-Webhooks: Ingest-API und Alarm-Webhooks.

Home Assistant rest_command

Lieber automatische Entitäten über einen Freigabelink? Nutze die offizielle HACS-Integration. Für reines MQTT-Spiegeln:

# configuration.yaml
rest_command:
  probeharbor_ingest:
    url: "https://probeharbor.dev/api/ingest/mqtt"
    method: POST
    headers:
      Content-Type: application/json
      X-Ingest-Key: !secret probeharbor_ingest_key
    payload: >
      {"topic":"{{ trigger.topic }}","payload":{{ trigger.payload }}}
automation:
  - alias: ProbeHarbor MQTT bridge
    trigger:
      - platform: mqtt
        topic: home/garage/temp
    action:
      - service: rest_command.probeharbor_ingest

Node-RED

Importiere mqtt-to-probeharbor.json, richte die MQTT-Nodes auf deinen Broker, setze PROBEHARBOR_INGEST_KEY und deploye. Produktleitfaden: Node-RED-Integration. Ausführliche Beschreibung: Entwicklerdoku zur MQTT-Brücke.

Weiterführend

Häufige Fragen

Muss ich für ProbeHarbor auf MQTT verzichten?
Nein. Behalte Mosquitto/Home Assistant für lokale Automationen und sende per HTTPS-POST an den Ingest für die Frost- und Wasseralarme und den Verlauf von ProbeHarbor.

Was veröffentlicht die MQTT-Bridge?
Sie überträgt Broker-Topics in Ingest-JSON für ProbeHarbor (Temperaturen, Türen, Wasser). Details: probeharbor.dev/about/mqtt-bridge.

Ist TLS zu probeharbor.dev erforderlich?
Für den Cloud-Ingest ja. Lokales MQTT kann in deinem LAN bleiben; die Bridge oder das Gerät muss per HTTPS-POST an deine Ingest-URL senden.