Meshtastic-Android/docs/et-rEE/user/mqtt.md

title, parent, nav_order, last_updated, description, aliases

title	parent	nav_order	last_updated	description	aliases
MQTT	User Guide	11	2026-05-13	Silda oma võrk internetiga – MQTT maakleri seadistamine, krüpteerimiskihid ja kaardiaruandlus.	mqtt internet-bridge broker

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. Remote gateways subscribed to the same topic inject those messages into their local mesh.

Sätted

Luba MQTT

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

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

Meshtastic vaikemaakler

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

🔒 Privaatsus: Avaliku vahendaja sõnumeid saavad lugeda kõik tellijad. Always use channel encryption for private communications.

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

Üleslink vs allalink

Direction	Kirjeldus
Üleslink	Sõnumid kärgvõrgust → MQTT maakler
Allalink	Sõnumid MQTT maaklerist → kärgvõrk

Configure per-channel which directions are active to control message flow and airtime usage.

Message Formats

MQTT kasutab protobuf-sõnumivormingut:

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

⚠️ Märkus: JSON väljundi tugi eemaldati püsivarast. The json_enabled setting is still visible in the app for legacy compatibility but has no effect on current firmware versions.

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 resolution — if using a custom broker hostname, verify the node can resolve it. 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.
• Channel mismatch — both gateways must share the same channel with the same PSK. A mismatch means messages are encrypted with different keys and appear as garbage.
• Topic mismatch — ensure both gateways use the same root topic. The default msh works for the public broker.

Related Topics

• Seaded — Moodulid ja administreerimine — MQTT mooduli konfi viide
• Sõnumid ja kanalid — kanali krüptimine ja PSK seadistamine
• MQTT integratsioonijuhend — üksikasjalik MQTT dokumentatsioon aadressil meshtastic.org

---