mirror of
https://github.com/meshtastic/Meshtastic-Android.git
synced 2026-10-03 09:04:32 -04:00
146 lines
8.0 KiB
HTML
146 lines
8.0 KiB
HTML
<!DOCTYPE html>
|
||
<html lang="et-rEE" dir="ltr">
|
||
<head>
|
||
<meta charset="UTF-8">
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
<title>MQTT</title>
|
||
<link rel="stylesheet" href="../../styles/docs.css">
|
||
</head>
|
||
<body data-page="mqtt" data-locale="et-rEE">
|
||
<pre class="markdown-content"># 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:
|
||
|
||
|
||
|
||
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 |
|
||
Kaardiaruannete koostamine | Teavita asukoht avalikul kaardil | Keelatud |
|
||
|
||
### MQTT puhverserver sellel telefonil
|
||
|
||
Kui sõlmel puudub oma internetiühendus, saab see kasutada ühendatud telefoni MQTT-lüüsina: luba mooduli konfiguratsioonis **MQTT** ja **Proksi kliendiga lubatud** ning rakendus edastab MQTT-liikluse raadio ja maakleri vahel telefoni internetiühenduse kaudu.
|
||
|
||
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.
|
||
|
||
## Kaardiaruannete koostamine
|
||
|
||
Kui kaardiaruandlus on lubatud, avaldab sõlm oma asukoha Meshtasticu kogukonnakaardil:
|
||
|
||
- Nähtav aadressil [meshmap.net](https://meshmap.net) ja sarnastes kogukonna kaarditeenustes
|
||
- Only position and node info are shared
|
||
- Keela see valik, kui sa ei soovi, et sinu asukoht oleks avalikult nähtav
|
||
|
||
## Üleslink vs allalink
|
||
|
||
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.
|
||
|
||
## 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
|
||
|
||
---
|
||
|
||
</pre>
|
||
</body>
|
||
</html> |