Настройка MQTT-шлюза сообщества и онлайн-карты
Meshtastic Армения поддерживает официальный MQTT-брокер (mqtt.msh.am), связывающий узлы с онлайн-панелью мониторинга.
🧭 Рекомендации по подключению
Кому следует включать MQTT?
- Стационарным домашним станциям (
CLIENT_BASE): Узлы с питанием от розетки и стабильным Wi-Fi. - Высотным узлам и шлюзам на крышах: Устройства с хорошим радиопокрытием городских районов или долин.
- ❌ Носимым и карманным узлам (
CLIENT): В повседневном использовании включать MQTT НЕ нужно. Это тратит аккумулятор, мобильный интернет и создаёт дубликаты пакетов при движении.
⚙️ Параметры подключения к брокеру
Настройте узел через мобильное приложение Meshtastic или Web Client:
| Параметр настройки | Требуемое значение | Примечание |
|---|---|---|
| MQTT Enabled | ON (Включено) | Главный переключатель в Module Config |
| Server Address | mqtt.msh.am | Публичный брокер сообщества |
| Server Port | 1883 | Стандартный порт MQTT |
| Username | meshdev | Учётные данные доступа |
| Password | large4cats | Стандартный пароль сообщества Meshtastic |
| Encryption Enabled | OFF (Выключено) | Не включать TLS на порту 1883 |
| Root Topic | /msh/EU_868/AM/ | Региональный корень топика (со слэшем в начале) |
| Channel Uplink Enabled | YES | Включается в настройках канала |
| Downlink Enabled | ❌ NO (Выключено) | КРИТИЧНО: Всегда выключено на клиентских узлах |
📱 Инструкция по настройке в приложении
- Откройте приложение Meshtastic и подключитесь к узлу по Bluetooth.
- Перейдите в Settings (шестерёнка) -> Module Config -> MQTT.
- Включите MQTT Enabled.
- В поле Server Address введите
mqtt.msh.am. - Укажите Username:
meshdevи Password:large4cats. - Убедитесь, что Encryption выключено (OFF).
- Задайте Root Topic:
/msh/EU_868/AM/. - Сохраните настройки (узел перезагрузится).
- Откройте Channels -> выберите основной канал (
MediumFast):- Включите Uplink Enabled (ON).
- Оставьте Downlink Enabled выключенным (OFF).
⚠️ Главное правило: Downlink ДОЛЖЕН быть выключен
Никогда не включайте Downlink на клиентских узлах!
- Uplink (Радио -> MQTT): Узел принимает радиопакет от соседних участников и отправляет его на карту в интернет. Это безопасно и помогает строить карту покрытия сети.
- Downlink (MQTT -> Радио): Узел принимает интернет-трафик от MQTT-брокера и ретранслирует его в радиоэфир 868 МГц.
Если обычные пользователи включат Downlink, глобальный интернет-трафик и спам хлынут в локальный радиоэфир Армении, вызвав перегрузку радиоканала и блокировку экстренной связи. Downlink разрешён исключительно на авторизованных шлюзах администраторов сети с контролем трафика.
🔒 Конфиденциальность и управление передачей данных
1. Передача на глобальную карту (OkToMQTT)
По умолчанию данные с mqtt.msh.am используются локальным порталом (msh.am).
- Если вы хотите, чтобы ваш узел также передавался на мировую карту (
mqtt.meshtastic.org), убедитесь, что флагOkToMQTT(lora.config_ok_to_mqtt = true) включён в настройках LoRa.
2. Полный запрет отправки в интернет (ignore_mqtt)
Если вы хотите общаться исключительно по прямому радиоканалу без передачи координат и телеметрии в интернет:
- В приложении: Settings -> Radio Config -> LoRa.
- Включите Ignore MQTT (
lora.ignore_mqtt = true). - Шлюз
api.msh.amанализирует этот флаг и строго отбрасывает любые пакеты от узлов с включённымignore_mqttдо их сохранения в базах данных или отправки в публичные API.