🌐 Eesti — Community translation View in English

MQTT

MQTT ühendab Meshtastic võrgu internetiga, võimaldades raadiolevi ulatusest kaugemale ulatuvat pikamaasidet.

Overview

MQTT moodul ühendab sinu sõlme MQTT vahendajaga, võimaldades:

  • Messages to reach nodes on different physical meshes via the internet
  • Integration with home automation and monitoring systems
  • Sõlmede asukoha avaldamine avalikul Meshtastic kaardil
  • Custom data pipelines for logging and alerting

How It Works 

[Sinu sõlm] → Raadio → [WiFi-ga lüüsisõlm] → MQTT vahendaja → [Kauglüüs] → Raadio → [Kaugsõlm]

Internetiühendusega (WiFi või Ethernet) lüüsisõlm jagab võrgusõnumeid MQTT. Sama teemaga liitunud kauglüüsid sisestavad need sõnumid oma kohalikku kärgvõrku.

Sätted

Luba MQTT

  1. Mine menüüsse Seaded → Mooduli konfiguratsioon → MQTT.
  2. Luba MQTT moodul.
  3. Configure the broker connection:

MQTT lüliti

Sätted Kirjeldus Vaikimisi
Server Address MQTT vahendaja hostinimi mqtt.meshtastic.org
Kasutajatunnus Broker authentication meshdev
Parool Broker authentication large4cats
Root Topic Base topic for messages msh
Encryption Krüpteeri MQTT liiklus Lubatud
JSON väljund ⚠️ Vananenud — JSON pakettide tugi on püsivarast eemaldatud; seda välja ignoreeritakse Keelatud
TLS Secure connection to broker Keelatud
Map Reporting Report position to public map Keelatud

MQTT Proxy on This Phone

If your node has no internet access of its own, it can use the connected phone as its MQTT gateway: enable MQTT and Proxy to client enabled in the module config, and the app relays MQTT traffic between the radio and the broker over your phone’s internet connection.

MQTT sätete ekraani ülaosas olev lüliti MQTT puhverserver sellel telefonil näitab, kas see relee töötab praegu, ja võimaldab selle kohe välja lülitada (või taaskäivitada) – ilma seadme MQTT konfiguratsiooni muutmata ja uuesti salvestamata.

Meshtastic vaikemaakler

Kogukond haldab avaliku vahendajat aadressil mqtt.meshtastic.org. This is intended for general use and testing.

ℹ️ Märkus: Ühendused saidiga mqtt.meshtastic.org kasutavad alati TLS-i (port 8883), isegi kui TLS-i lüliti on välja lülitatud. For any other broker, TLS is used only when you enable it (port 8883 with TLS, 1883 without).

🔒 Privaatsus: Avaliku vahendaja sõnumeid saavad lugeda kõik tellijad. Privaatse suhtluse jaoks kasuta alati kanali krüpteerimist.

Private Broker

Parema privaatsuse ja kontrolli tagamiseks saad hallata oma MQTT maaklerit:

  • Mosquitto (lightweight, open-source)
  • HiveMQ
  • EMQX

Configure your node to point to your private broker with appropriate credentials.

Map Reporting

Kui kaardiaruandlus on lubatud, avaldab sõlm oma asukoha Meshtasticu kogukonnakaardil:

  • Visible at meshmap.net and similar community map services
  • Only position and node info are shared
  • Disable this if you don’t want your location publicly visible
Direction Kirjeldus
Üleslink Sõnumid kärgvõrgust → MQTT maakler
Allalink Sõnumid MQTT maaklerist → kärgvõrk

Konfi iga kanali kohta, millised suunad on aktiivsed, et kontrollida sõnumivoogu ja eetriaega.

Sõnumivormingud

MQTT kasutab protobuf-sõnumivormingut:

Vorming Kirjeldus Use case
Protobuf Binaarne Meshtastic protobuf kodeering Node-to-node mesh bridging

⚠️ Märkus: JSON väljundi tugi eemaldati püsivarast. Säte json_enabled on rakenduses endiselt nähtav, et näha ka pärandühilduvust, kuid see ei mõjuta praegusi püsivara versioone.

Encryption & Privacy

Understanding the layered encryption model:

  1. Kanali krüptimine toimub kärgvõrgus enne MQTT. Kui kanalil on PSK, on ​​MQTT liiklus juba krüptitud – maakler ja kõik tellijad näevad ainult šifriteksti.
  2. MQTT krüptimine (mooduli säte) lisab vahendajale edastamiseks täiendava krüptimiskihi. This protects metadata and routing information.
  3. TLS krüpteerib TCP ühenduse vahendaja endaga, takistades võrgutasandil pealtkuulamist.

🔒 Tähtis: Vaikimisi avalikul kanalil on tuntud võti. MQTT kaudu saadetud vaikekanalil olevad sõnumid on sisuliselt krüpteerimata – igaüks saab neid dekodeerida. Always use a custom PSK for private communications.

Best Practices

  • Kasuta kanali krüptimist (PSK), kanalitel mis on sillatud MQTT-ga
  • Ära luba MQTT internetiühenduseta sõlmedel (see puhverdab ja raiskab mälu)
  • Use a private broker for sensitive deployments
  • MQTT sõnumite allalaadimisel arvesta eetriaja kuluga – iga allalingitud sõnum tarbib sinu kohalikus võrgus raadioeetriaega
  • Kaalu ainult üleslingi lubamist, kui sul on vaja oma kärgvõrku eemalt jälgida ilma sõnumeid tagasi tõmbamata

Troubleshooting

MQTT ei ühendu

  • Kontrolli WiFit – lüüssõlmel peab olema aktiivne internetiühendus (WiFi või Ethernet). MQTT ei tööta LoRa raadiolingi enda kaudu.
  • Verify credentials — incorrect username or password will silently fail on most brokers. Double-check for trailing spaces.
  • Tulemüür — port 1883 (MQTT) või 8883 (MQTT+TLS) peab olema avatud. Some networks block non-standard ports.
  • DNS-i lahendamine – kui kasutad kohandatud maakleri hostinime, veenduge, et sõlm suudab seda lahendada. Try the broker’s IP address directly.

Messages Not Bridging

  • Kontrolli üleslingi/allalingi seadeid — kui lubatud on ainult üleslink, liiguvad sõnumid võrgust MQTT-sse, aga mitte tagasi. Luba vastuvõtval lüüsil allalink.
  • Kanali mittevastavus – mõlemad lüüsid peavad jagama sama kanalit sama PSK-ga. Vastuolu tähendab, et sõnumid on krüpteeritud erinevate võtmetega ja kuvatakse prügina.
  • Teema mittevastavus — veendu, et mõlemad lüüsid kasutaksid sama juurteemat. The default msh works for the public broker.