---
title: MQTT
parent: User Guide
nav_order: 11
last_updated: 2026-05-13
description: Silda oma võrk internetiga – MQTT maakleri seadistamine, krüpteerimiskihid ja kaardiaruandlus.
aliases:
  - 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:

![MQTT lüliti](/assets/screenshots/settings_switch.png)

| 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](https://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](settings-module-admin) — MQTT mooduli konfi viide
- [Sõnumid ja kanalid](messages-and-channels) — kanali krüptimine ja PSK seadistamine
- [MQTT integratsioonijuhend](https://meshtastic.org/docs/software/integrations/mqtt) — üksikasjalik MQTT dokumentatsioon aadressil meshtastic.org

---

