MeshCenter в Docker: базовая станция Meshtastic на домашнем NAS без Raspberry Pi

Дата обновления: 20.10.2026 (актуально для MeshCenter 1.12.1)

Автор: Флинт

💡 MeshCenter больше не привязан к Raspberry Pi: с версии 1.11.0 его можно запустить в контейнере Docker на домашнем NAS или сервере, а радио Meshtastic подключить по Wi-Fi.

💬 Когда я начинал MeshCenter, всё было просто: Raspberry Pi, радио по USB, веб-интерфейс в браузере. Но у меня дома круглосуточно работает Synology, и мысль «зачем ещё одна плата, если есть NAS» не давала покоя. А радио хотелось поставить туда, где лучше приём, а не туда, где стоит компьютер.

Так появился серверный режим: MeshCenter в контейнере Docker на NAS, радио с Wi-Fi стоит на чердаке или у окна, и между ними только домашняя сеть. В этой статье я расскажу, зачем это нужно, что вы получаете и чего лишаетесь, а во второй половине пошагово покажу установку – даже если вы никогда не работали с Docker.

Попробуйте сами: интерактивное онлайн-демо

Как выглядит MeshCenter, можно посмотреть прямо в браузере, ничего не устанавливая: онлайн-демо MeshCenter. Интерфейс в Docker-версии тот же самый.


🎯 Зачем запускать MeshCenter в контейнере

Базовая станция Meshtastic должна работать постоянно: принимать сообщения, пока вы спите, собирать телеметрию, хранить историю переписки. Обычно для этого берут Raspberry Pi. Но не всем хочется заводить и обслуживать ещё одно устройство:

  • 🗄️ у многих дома уже есть NAS, который и так работает круглосуточно – с RAID, бэкапами и, часто, с ИБП;
  • 🍓 Raspberry Pi нужно обслуживать отдельно: SD-карта, питание, обновления системы;
  • 📡 радио удобнее поставить там, где лучше приём – на чердаке, у окна, на мачте, – а не рядом с компьютером.

Решение простое: радио Meshtastic с Wi-Fi подключено к домашней сети, а MeshCenter работает в контейнере на NAS и общается с радио по сети (TCP). Отдельный компьютер рядом с радио не нужен – радио достаточно питания.

  [ Радио Meshtastic ] ── Wi-Fi ── [ Роутер ] ── LAN ── [ NAS: контейнер MeshCenter ]
   (чердак / мачта)                                               │
                                                браузер на ПК, планшете, телефоне

✅ Кому подходит серверный режим

  • 🗄️ владельцам Synology и других NAS на процессорах Intel/AMD;
  • 🖥️ тем, у кого есть домашний сервер или мини-ПК с Docker;
  • 💾 тем, кому важны централизованные бэкапы и не хочется обслуживать отдельную плату;
  • 📡 тем, у кого радио должно стоять отдельно от компьютера.

🍓 Кому лучше остаться на Raspberry Pi

  • 📷 если нужны камера, e-Paper дисплей, датчики (BME280, часы DS3231);
  • 🔌 если у радио нет Wi-Fi – например, платы на nRF52 (RAK4631, T-Echo);
  • 📱 если телефон должен оставаться подключённым к радио, пока работает MeshCenter (подробнее ниже);
  • ⚡ если хочется самой простой установки: записал SD-карту и включил.

💡 Есть и третий вариант. На любой компьютер или сервер с Debian/Ubuntu MeshCenter можно поставить без Docker, обычной ручной установкой (install.sh). Радио тогда подключается по USB, и все функции доступны. Docker – не единственный способ обойтись без Raspberry Pi, а вариант именно для NAS и серверов, где не хочется ставить программы прямо в систему.


⚖️ Raspberry Pi или Docker: сравнение

Raspberry Pi (классика)Docker (серверный режим)
Где работаетотдельная плата PiNAS или сервер, который у вас уже есть
Подключение радиоUSB (рекомендуется), TCP, Bluetoothтолько TCP по сети
Камера, дисплей, датчикиестьнет
Установкаавтоматическая с SD-картысборка образа + compose
Обновлениекнопкой в интерфейсезаменой образа
ПроцессорARM (Pi Zero 2W, 3, 4, 5)x86-64 (Intel/AMD)
Хранение данныхSD-картатом NAS (RAID, снапшоты, бэкапы)

🏗️ Как это устроено внутри

Для тех, кому интересно, что в «коробке». Образ построен на python:3.11-slim (Debian) и весит около 350 МБ (около 80 МБ в сжатом виде).

  • 🧠 MeshCenter Core – веб-приложение на Flask под gunicorn, всегда ровно один рабочий процесс;
  • 📡 адаптер Meshtastic – отдельный процесс со своим окружением Python и официальной библиотекой meshtastic. С Core он общается через локальный канал. Так библиотека под GPLv3 отделена от основного кода MeshCenter под MIT – ровно как в обычной установке;
  • ⚙️ tini в роли init-процесса – корректно передаёт сигналы и не оставляет «зомби»;
  • 🔒 обычный пользователь вместо root, сброшены все capabilities, запрещено повышение прав;
  • 🩺 эндпоинт /healthz – по нему Docker понимает, что веб-приложение живо.

💾 Где хранятся данные

Всё важное лежит снаружи контейнера, в двух папках на диске NAS:

Папка на NASВ контейнереЧто там
config//configconfig.py (создаётся при первом запуске и никогда не перезаписывается), ключи погодных сервисов
data//dataсообщения, узлы, профили радио, точки на карте, файлы MCAttach, настройки, хэш пароля, журнал событий

Контейнер можно удалить и пересоздать, обновить или откатить образ – данные остаются на месте.

🧭 Как MeshCenter понимает, что он в контейнере

Специальная переменная окружения включает контейнерный режим. Функции, которым нужно «железо» (USB, камера, дисплей, Wi-Fi), сервер отклоняет, а интерфейс скрывает. Системная страница показывает только честные цифры: нагрузку, память и время работы хоста (контейнер делит их с NAS) и диск тома с данными. Модель платы и температуру процессора контейнер достоверно узнать не может – поэтому они скрыты.

⏰ Время. Контейнер не может сам проверить, что часы синхронизированы. Переменная MESHCENTER_TRUST_HOST_CLOCK=1 разрешает доверять часам хоста: DSM синхронизирует их по NTP. От этого зависят расписания и синхронизация времени радио. Часовой пояс задаётся через TZ.


📡 Подключение по TCP: что важно знать

Сетевое подключение – главное отличие серверного режима, и у него есть свои особенности.

⚠️ Правило «один клиент на радио»

Радио Meshtastic обслуживает только одно TCP-подключение. Когда подключается новый клиент, радио молча отключает предыдущего. Если оба умеют автоматически переподключаться, они будут бесконечно выбивать друг друга – каждый продержится несколько секунд.

И это не теория. При разработке Docker-версии я потратил на эту проблему почти два дня. Связь рвалась каждые несколько минут, и под подозрением побывали прошивка радио, настройки TCP keepalive и мой собственный код. А причина оказалась до обидного простой: второй экземпляр MeshCenter на другом компьютере был настроен на то же радио, и его библиотека тихо переподключалась через секунду после каждого отключения. Как только второй клиент убрали, Docker-версия проработала около 7 часов без единого разрыва.

Отсюда практические правила:

  • 🚫 пока MeshCenter подключён, не подключайтесь к этому радио по сети – ни телефоном, ни вторым MeshCenter, ни скриптом;
  • 📱 нужен телефон – нажмите в Node Manager «Освободить радио» (Release radio), поработайте, отключитесь в приложении и нажмите Reconnect (подробнее ниже);
  • 🔁 если у вас несколько установок MeshCenter с TCP-профилем этого радио, на всех, кроме одной, радио должно быть освобождено.

MeshCenter сам распознаёт такую ситуацию. С версии 1.12.0 он замечает не только быстрые обрывы, но и регулярное чередование, когда клиенты сменяют друг друга каждые полминуты-минуту. В Node Manager появляется предупреждение «The radio keeps closing our session – another client (phone app, a second MeshCenter) probably shares it. Use Release radio on the other instance», а попытки подключения становятся реже (раз в 5, затем раз в 10 минут), чтобы не мешать. Предупреждение исчезает само, когда сессия простоит стабильно 15 минут. Освобождать радио самостоятельно MeshCenter не будет – это решение остаётся за вами.

📶 Wi-Fi и Bluetooth. Как подтверждает документация Meshtastic, на платах ESP32 Wi-Fi и Bluetooth одновременно не работают: при включении Wi-Fi Bluetooth отключается. Поэтому подключить телефон «параллельно по Bluetooth», пока MeshCenter работает по сети, не получится.

🔄 Автоматическое восстановление связи

Если радио пропало – отключилось питание, пропал Wi-Fi, перезагрузился роутер или NAS, – MeshCenter не сдаётся и не требует перезапуска:

  • ⏳ ждёт около 25 секунд, чтобы радио успело освободить старое подключение;
  • 🔁 пробует снова через 30, 60, 90 секунд, а затем каждые 2 минуты – без ограничения по времени;
  • 🪪 при каждой попытке проверяет, что ответило то же самое радио – другое устройство на том же IP без вашего подтверждения не будет принято;
  • ⏱️ считает связь восстановленной только после того, как сессия продержалась 20 секунд.

В интерфейсе это видно как «Reconnecting… (attempt N, next in X s)», а кнопка Reconnect запускает попытку немедленно. Node Manager показывает число разрывов за последний час – короткие сбои не превращаются в тревожный красный статус.

Проверено на реальном радио: после отключения питания больше чем на 20 минут связь восстановилась сама, без перезапуска контейнера. Одна особенность T-Beam: сразу после переподключения он иногда закрывает первую новую сессию, а вторая попытка уже стабильна. Поэтому один «разрыв» в счётчике после Reconnect – это нормально. А чтобы не нагружать радио, при повторном подключении MeshCenter запрашивает только конфигурацию без полного списка узлов – около 1,2 КБ вместо 14 КБ. Слабым платам на ESP32 так заметно легче.

✔️ Подтверждения доставки

С версии 1.12.0 подтверждения доставки личных сообщений («доставлено ✓✓») работают и по TCP, а не только по USB. Сообщение считается доставленным только тогда, когда подтверждение пришло от самого получателя, а не от ретранслятора по пути.


✅ Преимущества

  • ✅ Не нужно отдельное устройство – MeshCenter работает на NAS, который и так включён круглосуточно.
  • ✅ Надёжное хранение – данные лежат на томе NAS с RAID, снапшотами и Hyper Backup; SD-карта не износится и не испортится при сбое питания.
  • ✅ Свобода размещения радио – оно стоит там, где лучше приём; нужны только питание и Wi-Fi.
  • ✅ Изоляция и безопасность – контейнер работает не от root, без лишних прав и не трогает систему NAS.
  • ✅ Простое обновление и откат – новая версия = новый образ; не понравилась – вернули старый.
  • ✅ Удобная передача радио – кнопка «Освободить радио» отдаёт его телефону на нужное время без остановки контейнера.
  • ✅ Производительность – процессор NAS обычно мощнее Raspberry Pi Zero 2W, интерфейс отзывается быстрее.

⚠️ Ограничения

  • 📡 Только TCP – радио должно иметь Wi-Fi (или Ethernet) и включённый сетевой доступ. USB и Bluetooth в контейнере отключены.
  • 🖥️ Только x86-64 – образ собирается под linux/amd64. NAS на ARM и Raspberry Pi в Docker пока не поддерживаются.
  • 🔒 Один клиент на радио – пока MeshCenter подключён, телефон и другие программы к радио по сети подключаться не могут. Для передачи радио есть кнопка «Освободить радио».
  • 📷 Нет функций, связанных с «железом» – камера, e-Paper дисплей, датчики I2C и RTC, управление Wi-Fi, перезагрузка устройства.
  • 🔄 Нет встроенного обновления – кнопка обновления в контейнере отключена, новая версия собирается и загружается как новый образ.
  • 📦 Нет готового образа – его нужно собрать самостоятельно (это делается один раз на каждую версию).
  • 📭 Сообщения во время разрыва могут потеряться – радио не хранит их для сетевого клиента.
  • 🧪 Проверено пока только на Synology DS920+ – на других системах всё должно работать по тому же принципу, но официально они ещё не тестировались.

🔒 Безопасность

  • 🔑 При первом запуске MeshCenter требует задать пароль (не короче 12 символов). Сделайте это сразу: пока пароля нет, установку может «занять» любой в вашей сети.
  • 🛡️ Все страницы и API защищены сессией, изменяющие запросы – CSRF-токеном, попытки подбора пароля ограничиваются.
  • 🌐 MeshCenter работает по обычному HTTP и рассчитан на домашнюю сеть. Не открывайте порт в интернет – для удалённого доступа используйте VPN или обратный прокси с HTTPS.
  • 📁 Папка data/ содержит секреты (хэш пароля, ключ сессий, ключи MCAttach) – не делайте её общедоступной.

🛠️ Пошаговая установка на Synology

Теперь практика. Я описываю установку на Synology DS920+ (DSM 7.3) – именно на нём всё проверено. Для других систем отличаются только названия пунктов меню (об этом ниже).

📚 Немного терминов

  • 📦 Образ (image) – готовая «коробка» с программой: внутри минимальный Linux, Python, MeshCenter и библиотека meshtastic. Собирается один раз и не меняется.
  • ▶️ Контейнер – запущенная копия образа. Его можно остановить, удалить и создать заново, ничего не потеряв.
  • 📁 Папки снаружи (тома) – config/ и data/ на диске NAS. Все ваши данные хранятся там.
  • 📝 compose.yaml – текстовый файл-«рецепт»: какой образ запускать, на каком порту и какие папки подключить.

📋 Что нужно заранее

  • 🖥️ NAS с процессором Intel/AMD. Проверить на Synology: Панель управления → Информационный центр → Общие → Процессор.
  • 📦 Container Manager: Центр пакетов → Container Manager → Установить.
  • 📡 Радио Meshtastic с Wi-Fi. В официальном приложении включите Wi-Fi, подключите радио к домашней сети и убедитесь, что включён сетевой доступ (TCP, порт 4403).
  • 📌 Постоянный IP радио. Закрепите адрес в роутере (DHCP-резервирование) – иначе после смены адреса MeshCenter радио не найдёт.
  • 💻 Компьютер для сборки образа с Windows, macOS или Linux, на котором можно поставить Docker Desktop и Git.

💻 Шаг 1. Сборка образа на компьютере

Готового образа для скачивания пока нет (почему – в разделе вопросов). Собрать его несложно. Установите Docker Desktop и Git, затем скачайте исходники и переключитесь на релиз – именно на релиз, а не на текущую ветку разработки:

git clone https://github.com/FlintUA/MeshCenter
cd MeshCenter
git checkout v1.12.1

Номер последней версии смотрите на странице Releases. Теперь соберите образ. Linux / macOS:

deploy/docker/build.sh

Windows (PowerShell) – команда целиком, с точкой в конце:

docker build --platform linux/amd64 --build-arg MESHCENTER_VERSION=1.12.1 -t meshcenter:1.12.1 .

Сборка занимает несколько минут. Затем сохраните образ в файл для переноса на NAS:

docker save -o meshcenter-1.12.1.tar meshcenter:1.12.1

💡 Получится файл около 80-90 МБ. Собрать образ можно и прямо на NAS из исходников, но для этого нужны git и SSH, и на NAS это заметно дольше. Новичку проще собрать на компьютере.

📁 Шаг 2. Папки и права

В File Station создайте папку /volume2/docker/meshcenter/ и внутри неё две папки: config и data. Если общая папка docker у вас на первом томе – пишите volume1 (здесь и далее).

[📷 Место для скриншота: File Station с папками config и data]

Контейнер из соображений безопасности работает не от администратора, а от обычного пользователя, и ему нужно право писать в эти папки. Для этого понадобится SSH:

  1. включите SSH: Панель управления → Терминал и SNMP → Включить службу SSH;
  2. подключитесь с компьютера (на Windows – из PowerShell): ssh ваш_логин@IP-адрес-NAS;
  3. выполните sudo -i (система спросит пароль DSM).

Дальше вводите команды по одной. Сначала узнайте числовые идентификаторы пользователя:

id ваш_логин

Ответ будет примерно таким: uid=1026(...) gid=100(users). Число после uid – это PUID, после gid – PGID. Передайте папки этому пользователю (подставьте свои числа):

chown -R 1026:100 /volume2/docker/meshcenter/config /volume2/docker/meshcenter/data

💡 Образ по умолчанию рассчитан на 1026:100 – у первого созданного пользователя Synology обычно именно такие значения. Если у вас другие числа, укажите их в compose.yaml (шаг 4).

📦 Шаг 3. Загрузка образа на NAS

Без командной строки: Container Manager → Образ → Импорт → Добавить из файла → выберите meshcenter-1.12.1.tar. Если интерфейс не примет файл, используйте способ через SSH ниже.

[📷 Место для скриншота: Container Manager → Образ → Импорт]

Или через SSH: скопируйте файл на NAS через File Station и выполните:

docker load -i /volume2/docker/meshcenter/meshcenter-1.12.1.tar

После этого образ meshcenter:1.12.1 появится в списке образов, а файл .tar можно удалить.

📝 Шаг 4. Файл compose.yaml

Создайте в папке /volume2/docker/meshcenter/ текстовый файл compose.yaml с таким содержимым:

name: meshcenter
services:
  meshcenter:
    container_name: meshcenter
    image: meshcenter:1.12.1
    user: "1026:100"            # PUID:PGID из шага 2
    restart: unless-stopped
    ports:
      - "5080:5000"            # порт 5000 на Synology занят самим DSM
    environment:
      TZ: Europe/Berlin        # ваш часовой пояс: Europe/Moscow, Europe/Kyiv...
      MESHCENTER_TRUST_HOST_CLOCK: "1"
    volumes:
      - ./config:/config
      - ./data:/data
    hostname: meshcenter
    cap_drop: [ALL]
    security_opt: ["no-new-privileges:true"]
    stop_grace_period: 30s
  • image – имя и версия образа из шага 3, через двоеточие (meshcenter:1.12.1), а не имя tar-файла;
  • ports: "5080:5000" – MeshCenter будет открываться на порту 5080 NAS;
  • MESHCENTER_TRUST_HOST_CLOCK – доверять часам NAS; без этого не работают расписания и синхронизация времени радио;
  • cap_drop и no-new-privileges – контейнер не получает лишних прав.

🚀 Шаг 5. Запуск

Container Manager → Проект → Создать: название meshcenter, путь /volume2/docker/meshcenter, источник – «использовать существующий compose.yaml», далее – готово.

[📷 Место для скриншота: Container Manager → Проект → Создать]

Через SSH то же самое:

cd /volume2/docker/meshcenter
docker compose up -d

🔑 Шаг 6. Первый вход и настройка

  1. Откройте в браузере http://IP-адрес-NAS:5080. Первый запуск может занять до минуты.
  2. Откроется страница первичной настройки – сразу задайте пароль.
  3. Откройте Node Manager, выберите поиск радио по TCP, введите IP радио и порт 4403, подтвердите. MeshCenter перезапустится сам.
  4. Для передачи файлов (MCAttach) укажите номер вашего закрытого канала: откройте config/config.py и задайте MCA_CONTROL_CHANNEL_INDEX = 1 (номер – позиция канала в приложении Meshtastic: 0 – основной, 1 – первый дополнительный и т. д.). Затем перезапустите проект.

[📷 Место для скриншота: Node Manager: подключение радио по TCP]

🔒 Важно: MeshCenter намеренно не использует для служебных данных MCAttach публичный канал – поэтому без этой настройки передача файлов отключена.


🔄 Повседневная работа

  • 📱 Освободить радио для телефона – Node Manager → «Освободить радио» → срок → «Освободить». Поработайте с телефоном, отключитесь в приложении и нажмите Reconnect (или дождитесь окончания срока). Остановка проекта в Container Manager тоже работает, но кнопка удобнее.
  • 🌙 Выключение NAS – останавливать контейнер вручную не нужно: после загрузки он запустится сам. А вот вручную остановленный контейнер после перезагрузки останется выключенным. И помните: если перед выключением радио было освобождено «до подключения», после включения нужно нажать Reconnect.
  • ⬆️ Обновление – соберите на компьютере новый образ (git checkout на новую версию, сборка, docker save), импортируйте его, поменяйте версию в строке image: и перезапустите проект. Затем обновите страницу с Ctrl+F5 и проверьте версию внизу. Папки с данными не затрагиваются.
  • ↩️ Откат – верните прежнюю версию в image:, если старый образ ещё в списке.
  • 💾 Резервная копия – остановите проект, скопируйте config/ и data/ (например, Hyper Backup), запустите снова. Копировать данные работающего контейнера не стоит: внутри базы SQLite.
  • 📜 Логи – Container Manager → Контейнер → meshcenter → Журнал или docker compose logs -f.

🗄️ Другие NAS и обычный Linux-сервер

Порядок везде одинаковый: собрать образ → загрузить → папки config и data с правами → compose.yaml → запуск. Отличаются только названия меню:

  • 📦 QNAP – Container Station → Images → Import, затем Applications → Create с тем же compose.yaml;
  • 📦 Unraid – плагин Compose Manager или ручное создание контейнера с теми же портом и папками;
  • 📦 TrueNAS SCALE – Apps → Custom App;
  • 🐧 Debian/Ubuntu-сервер – установите docker и docker compose, создайте папки, выполните chown, положите compose.yaml и запустите docker compose up -d.

Эти системы пока не проверялись. Обязательные условия везде одни: процессор x86-64 и радио с доступом по TCP.


🩺 Частые ошибки

Что видноПричина и решение
Контейнер сразу останавливается, в журнале «not writable»Неверные права на config/ или data/ – повторите шаг 2 и проверьте user:
Страница не открывается на порту 5000На Synology порт 5000 занят DSM – используйте 5080:5000
Радио то подключается, то отключаетсяК радио подключён второй клиент: телефон, другой MeshCenter, программа на ПК
«The radio keeps closing our session…»Радио занято другим клиентом – освободите радио на другой установке MeshCenter или отключите телефон
После перезагрузки NAS статус «Radio released»Радио было освобождено «до подключения» – нажмите Reconnect в Node Manager
Один «Link reset» сразу после ReconnectНормально для T-Beam: первая сессия после переподключения иногда закрывается, вторая стабильна
Долго висит «Reconnecting…»Радио выключено, не в сети или сменило IP – проверьте резервирование в роутере
docker compose up выдаёт «pull access denied»Образ ещё не загружен (docker load) или в строке image: опечатка, например имя файла вместо meshcenter:1.12.1
Сообщение «неподтверждено», ответ NO_CHANNELПолучатель не может расшифровать сообщение: нет обмена ключами между радио
MCAttach: «control channel index None»Не задан MCA_CONTROL_CHANNEL_INDEX (шаг 6)
Не срабатывают расписанияПроверьте MESHCENTER_TRUST_HOST_CLOCK и время на NAS
Неправильное времяНеверный TZ в compose.yaml
«not available in a container»Функции нужно «железо» – в контейнере она недоступна

❓ Вопросы и ответы

Можно ли запустить Docker-версию на Raspberry Pi?

Пока нет – образ собирается только под x86-64. Для Raspberry Pi есть обычная установка, и она функциональнее: USB, камера, дисплей, датчики.

А на Windows или macOS через Docker Desktop?

При разработке это работало, но официально не поддерживается: Docker Desktop рассчитан на разработку, а не на круглосуточную работу. Для постоянной станции используйте NAS или Linux-сервер.

Можно ли подключить радио по USB к NAS и пробросить его в контейнер?

В текущей версии нет. Если радио подключено по USB к компьютеру с Linux, проще поставить MeshCenter на этот компьютер напрямую, без Docker.

Что будет, если NAS выключается на ночь?

Ничего страшного: контейнер остановится вместе с NAS и запустится после включения. Сообщения, пришедшие, пока NAS был выключен, MeshCenter не увидит.

Можно ли держать два MeshCenter на одно радио?

Одновременно по TCP – нет, они будут выбивать друг друга. Но с кнопкой «Освободить радио» их можно спокойно чередовать: на одной установке радио освобождено «до подключения», на другой подключено. Другой вариант – Raspberry Pi с одним радио по USB, а NAS с другим радио по TCP.

Как временно подключиться к радио с телефона?

В Node Manager нажмите «Освободить радио» и выберите срок. Подключитесь приложением Meshtastic по Wi-Fi, сделайте что нужно, отключитесь в приложении и нажмите Reconnect. Если выбрали 15 минут или час, MeshCenter подключится обратно сам.

Почему нет готового образа на Docker Hub?

Внутри образа есть библиотека meshtastic под лицензией GPLv3. Для распространения готовых образов нужна соответствующая документация по исходным кодам и лицензиям, и она ещё не готова. До тех пор прошу собирать образ самостоятельно для личного использования и не публиковать готовые образы.

Как понять, что контейнер работает нормально?

В Container Manager у контейнера статус healthy – значит, веб-приложение отвечает. Состояние связи с радио показывает уже сам интерфейс: значок в шапке и Node Manager.


💎 Заключение

Docker-версия MeshCenter – это серверный режим для тех, у кого уже есть NAS или домашний сервер, а радио с Wi-Fi можно поставить в удобном месте. Вы получаете надёжное хранение, изоляцию, простое обновление и обходитесь без отдельного устройства. Взамен – нет функций, завязанных на «железо», и нужно соблюдать правило «одно сетевое подключение на радио».

Нужна полноценная станция со всеми функциями – выбирайте Raspberry Pi с радио по USB. Важнее «поставить и забыть» на уже работающем NAS – серверный режим для вас.

🔨 Текущий статус

  • ✅ Docker-версия входит в MeshCenter с версии 1.11.0;
  • ✅ проверена на Synology DS920+ с T-Beam: многочасовая работа без разрывов, автоматическое восстановление после отключения радио;
  • ✅ 1.12.0: подтверждения доставки по TCP, кнопка «Освободить радио», распознавание второго клиента;
  • ✅ 1.12.1: подробная англоязычная инструкция по Docker в репозитории, окна приложения вместо системных диалогов браузера;
  • 💭 в планах – образ для ARM и готовые образы после закрытия лицензионных вопросов.

Если вы попробуете серверный режим на другом NAS – QNAP, Unraid, TrueNAS – напишите о результатах в Issues на GitHub: это очень поможет проекту. 📡

🔗 Ссылки

Автор: Флинт – автор MeshCenter и сайта elektroniker.help.

MeshCenter: история создания центра управления для Meshtastic

MeshCenter: история создания центра управления для Meshtastic

Дата обновления: июль 2026 · Автор: Elektroniker.Help

💡 Как увлечение одной идеей, помощь искусственного интеллекта и любовь к электронике переросли в большой и сложный проект

💬 Всё началось с простого желания — написать небольшой веб-чат для своей Meshtastic-ноды. У меня есть автономная Meshtastic нода на базе платы RAK4631 и я хотел, чтобы можно было отправлять и получать сообщения не только через телефон или через web-браузер на компьютере, но и через свой самодельный web-интерфейс. Думал, что это будет пара десятков строк кода, небольшой Flask-сервер и минимум интерфейса. Просто потренироваться, пощупать технологии, понять, как вообще работает веб-разработка.

😅 Как же я ошибался.

⚡ Постепенно я начал добавлять новые функции: отображение списка узлов, телеметрию, работу с камерой, сохранение истории… И вот, спустя почти месяц вечеров и выходных, этот “простой чатик” превратился в MeshCenter — полноценный браузерный центр управления для Meshtastic-базовых станций на Raspberry Pi.

🎯

Попробуйте сами: интерактивное онлайн-демо

Чтобы любой желающий мог оценить функциональность проекта без установки и настройки, я подготовил интерактивное онлайн-демо. Оно доступно по ссылке meshcenter.elektroniker.help/preview/ и представляет собой полностью рабочий интерфейс MeshCenter с симулированными данными.

В демо-версии вы сможете:

  • 🗺️ Смотреть ноды на карте и получать о них информацию;
  • 📡 Просматривать список узлов с их статусом и телеметрией;
  • 📈 Изучать графики температуры, влажности, давления и энергопараметров;
  • 📷 Тестировать интерфейс управления камерой с примером видеопотока;
  • 🖼️ Знакомиться с галереей и системой импорта/экспорта данных.

Демо не требует установки, регистрации или дополнительного ПО — просто откройте ссылку в браузере на компьютере или планшете. Это отличный способ «пощупать» проект перед тем, как разворачивать его на своём Raspberry Pi.

MeshCenter - главный экран
MeshCenter

🧑‍🔧 Кто я и почему я это делаю

Прежде чем рассказывать о технических деталях, я должен честно признаться: я не программист. По образованию и основной деятельности я электронщик. Большую часть своей профессиональной жизни я занимаюсь ремонтом компьютерной техники: ноутбуков, мониторов, моноблоков (All-in-One). Это моя основная работа, и я хорошо знаю, как устроена электроника “снизу”, на уровне компонентов, схем и пайки.

💻 Программирование для меня — это увлечение и хобби. Я никогда не учился на программиста, не работал в IT-компаниях и не писал коммерческий код. Всё, что я делаю в этой области — это результат самообразования, любопытства и желания разобраться, как работают современные технологии.

🤖 И в этом мне очень помогает искусственный интеллект. В процессе работы над MeshCenter я активно использовал ChatGPT, DeepSeek и другие языковые модели. Это то, что сейчас называют “вайбкодинг” (vibe coding) — когда ты не просто пишешь код, а буквально “чувствуешь” процесс, взаимодействуя с ИИ, который помогает генерировать идеи, объяснять сложные концепции и писать рабочие фрагменты кода. Это невероятно ускоряет обучение и позволяет человеку, не имеющему глубокого бэкграунда в программировании, создавать реально работающие проекты.

📅 Вся разработка — от первой идеи до текущей версии — заняла у меня чуть меньше месяца. И это стало для меня не просто созданием полезного инструмента, но и настоящим учебным курсом по веб-разработке, работе с API, асинхронному программированию и фронтенду.

🌐 Что уже есть в мире Meshtastic и зачем нужен MeshCenter

📡 Meshtastic — это проект с открытым исходным кодом, который использует LoRa-радиомодули для создания децентрализованных, защищённых mesh-сетей без сотовой связи и интернета. Устройства обмениваются текстовыми сообщениями, телеметрией и координатами на большие расстояния (до нескольких километров в городе и десятков — в поле).

У Meshtastic уже есть официальные приложения, разработанные профессиональными командами программистов, которые трудятся над ними уже много лет:

  • 🌍 Официальный веб-клиент — client.meshtastic.org — мощное веб-приложение для управления нодами, настройки и обмена сообщениями.
  • 📱 Мобильные приложения для Android и macOS — полнофункциональные клиенты с широчайшим набором возможностей: от базовой настройки до детальной телеметрии, карт, групповых каналов и многого другого.

Кроме того, существуют и другие независимые проекты, например MeshMonitor (meshmonitor.org) — современная, многофункциональная система для мониторинга mesh-сетей. Она поддерживает не только Meshtastic, но и MeshCore, а также MQTT-брокеры, предоставляя интерактивные карты, чаты, телеметрию, удалённое администрирование и даже автоматизацию с триггерами. Это решение ориентировано на профессиональное развёртывание и централизованный мониторинг.

Эти приложения — это профессиональный, коммерческий уровень разработки. Там работают целые команды, используются современные фреймворки, CI/CD, тестирование и другие индустриальные практики. И они действительно хороши.

🎯 Так зачем же нужен MeshCenter?
MeshCenter не пытается заменить официальные приложения. Он решает другую задачу.
Если вы хотите развернуть стационарный шлюз, ретранслятор или домашнюю базовую станцию, то постоянно держать телефон рядом или открывать веб-клиент на полную мощность неудобно. Нужен лёгкий, минималистичный интерфейс, который:
  • ✅ работает постоянно на Raspberry Pi Zero 2W;
  • ✅ доступен из любого браузера в локальной сети;
  • ✅ не требует установки дополнительного ПО;
  • ✅ потребляет минимум ресурсов;
  • ✅ предоставляет быстрый доступ к основным функциям: чат, телеметрия, камера.
MeshCenter — это именно такой инструмент. Он не претендует на звание “убийцы” официальных приложений, а скорее дополняет их, предоставляя удобный постоянный доступ к базовым функциям вашей стационарной ноды.

⚡ Ключевые особенности MeshCenter

🌐 Браузерный интерфейс — доступ с любого устройства
📦 Не требует установки ПО на клиентских устройствах
💻 Работает на ПК и планшетах
📱 Адаптивный десктопный интерфейс
🔓 Открытый исходный код (Open Source)
🍓 Спроектирован для Raspberry Pi
📡 Работает со стандартной прошивкой Meshtastic
🧩 Модульная архитектура для лёгкого расширения

MeshCenter сочетает в себе лёгкость и функциональность, предоставляя именно то, что нужно для стационарной Meshtastic-станции — без излишеств, но с продуманными деталями.

Интерфейс MeshCenter
Интерфейс MeshCenter

🔧 Конфигурация: RAK4631 + Raspberry Pi Zero 2W

📟 В основе моей системы лежит RAK4631 — компактная плата с чипом nRF52840 и LoRa-модулем SX1262. Она потребляет менее 100 мА в активном режиме и способна работать от батареи или солнечной панели очень долго. Это идеальная “нода-трудяга” для круглосуточного дежурства.

RAK4631
RAK4631 — основа Meshtastic-ноды
Raspberry Pi Zero 2W
Raspberry Pi Zero 2W — мозг MeshCenter

Но у RAK4631 нет встроенного веб-сервера. Поэтому я добавил к нему Raspberry Pi Zero 2W через USB-порт (RAK4631 подключается как последовательное устройство /dev/ttyACM0). Pi работает под управлением Raspberry Pi OS Bookworm и выполняет роль мозгового центра:

  • 📥 принимает данные от RAK4631 через Meshtastic CLI;
  • ⚙️ обрабатывает их;
  • 🌐 отдаёт веб-интерфейс через Flask;
  • 📷 управляет камерой (если она подключена).

В итоге получилась базовая станция, доступная по Wi-Fi с любого устройства в локальной сети.

Собранная система
Собранная система: RAK4631 + Raspberry Pi Zero 2W

🍓 Почему Raspberry Pi Zero 2W?

Для MeshCenter я выбрал Raspberry Pi Zero 2W — и это был осознанный выбор. Эта модель предлагает оптимальный баланс между производительностью и энергопотреблением. Четырёхъядерный процессор ARM Cortex-A53 на 1 ГГц обеспечивает достаточную мощность для веб-сервера, обработки телеметрии и потокового видео, а при этом Zero 2W потребляет всего около 200-250 мА в режиме простоя.

🔌 Подключение через USB и гибкость системы

Одна из главных фишек этой связки — простота подключения. RAK4631 подключается к Raspberry Pi Zero 2W через штатный USB-порт, и для этого не требуется никаких дополнительных модификаций, перепаек или специальных кабелей. Просто берёте стандартный USB-кабель (micro-USB на RAK4631 и USB-A или micro-USB на Pi — в зависимости от модели), соединяете их — и система готова к работе.

Плата RAK4631 определяется в системе Raspberry Pi как последовательное устройство /dev/ttyACM0, и MeshCenter через Meshtastic CLI легко с ним взаимодействует. Это решение максимально универсально и не требует от вас навыков пайки или глубоких знаний электроники.

И здесь кроется ещё один приятный бонус: если вы отключите питание Raspberry Pi (например, чтобы сэкономить батарею в полевых условиях), RAK4631 продолжит работать как обычная автономная Meshtastic-нода. Она останется доступной:

  • 📱 По Bluetooth — через мобильное приложение Meshtastic для Android или iOS;
  • 💻 Через веб-интерфейс — стандартный Meshtastic Web Client на компьютере (подключение по Bluetooth).

То есть вы не теряете управление нодой — она просто переключается в “родной” режим работы, без участия Pi. А когда вы снова подадите питание на Raspberry Pi (или включите его обратно), MeshCenter автоматически восстановит связь и продолжит работу с того места, где остановился. Это даёт двойную гибкость: вы можете использовать мощный веб-интерфейс с расширенными функциями (телеметрия, камера, графика), когда Pi включён, или перейти на лёгкий мобильный клиент, когда Pi выключен.

Такая архитектура делает систему отказоустойчивой и энергоэффективной — вы сами решаете, в каком режиме работать в каждый момент времени.

Однако MeshCenter не ограничивается только Zero 2W. Вы можете использовать любую модель Raspberry Pi, начиная с Raspberry Pi 3B+ и выше:

  • 🍓 Raspberry Pi 3B+ — чуть более мощный, но и более энергозатратный; отличный вариант, если Zero 2W недоступен.
  • 🍓 Raspberry Pi 4 — значительно более производительный, позволяет работать с более высокими разрешениями видео и FPS.
  • 🍓 Raspberry Pi 5 — максимальная производительность для самых требовательных сценариев.

Если вы планируете питать систему от солнечной панели или аккумулятора, Zero 2W остаётся лучшим выбором. Для стационарных установок с постоянным питанием можно использовать более мощные модели — MeshCenter будет работать на всех.

📶 Управление Wi-Fi: лёгкая настройка сети

Одной из удобных функций MeshCenter стал встроенный Wi-Fi Manager для Raspberry Pi, который позволяет управлять сетевыми подключениями прямо из браузера.

Wi-Fi Manager
Wi-Fi Manager в MeshCenter

Что можно делать:

  • 📊 просматривать текущее Wi-Fi-подключение, уровень сигнала (RSSI и проценты), скорость передачи (RX/TX link bitrate);
  • 🌐 видеть IP-адрес, шлюз и статус доступа в интернет;
  • 🔍 сканировать доступные Wi-Fi-сети поблизости;
  • 🔗 подключаться к новым сетям, автоматически используя сохранённые учётные данные;
  • 🗑️ забывать сохранённые профили Wi-Fi.

🔒 Важно: все настройки Wi-Fi выполняются через штатный NetworkManager Raspberry Pi. Сами пароли MeshCenter не хранит — это ответственность системы. Такое решение безопасно и не добавляет лишних сущностей в проект.

⚡ Энергопотребление: плата за функциональность

Сам RAK4631 очень экономичен, но Raspberry Pi уже “ест” ощутимо больше. И когда я добавил камеру… В общем, вот что получилось в реальных замерах:

  • 📟 RAK4631 (без Pi) — ≈ 50-100 мА (зависит от режима передачи и частоты);
  • 🍓 RAK4631 + Pi Zero 2W (в простое) — ≈ 200-250 мА;
  • ⚡ RAK4631 + Pi Zero 2W (активная работа с веб-интерфейсом и телеметрией) — ≈ 400-500 мА;
  • 📷 + включённая камера в режиме видео — пики до 650-850 мА.

🔋 Это важно учитывать, если вы питаете систему от аккумулятора или солнечной панели. При установке в полевых условиях я рекомендую использовать PowerBank с поддержкой пассивного охлаждения или небольшой солнечный контроллер с аккумулятором на 10-20 А·ч.

📷 Камера: видеопоток и фотосъёмка в одном интерфейсе

Одной из самых интересных и сложных частей стала интеграция камеры. У меня стоит Raspberry Pi Camera OV5647 (5 Мп). Это старая, но проверенная камера, которая отлично работает с Pi Zero 2W через библиотеку Picamera2.

Теперь управление камерой объединено в единый, интуитивно понятный интерфейс. Всё работает в двух основных режимах, которые плавно переключаются при смене вкладок.

Интерфейс камеры
Управление камерой в MeshCenter

🎥 Камера

Когда вы переходите на вкладку “Camera”, камера автоматически запускает MJPEG-поток. Вы можете настроить:

  • 📐 разрешение (от 320×240 до 1920×1080);
  • 🎞️ частоту кадров (от 5 до 30 FPS);
  • 🎨 качество JPEG (от 40% до 90%).

Также есть возможность сделать скриншоты прямо из транслируемого видео с предустановленными параметрами качества.

🖼️ Галерея: просмотр, управление и экспорт

Все сохранённые изображения — как скриншоты из видео, так и полноценные фото — попадают в галерею. Теперь она стала ещё удобнее:

  • 👁️ можно просматривать все снимки прямо в браузере;
  • ⬇️ скачивать изображения на компьютер — по одному или все сразу;
  • 🗑️ удалять ненужные снимки (по отдельности или массово).

Галерея полностью интегрирована с хранилищем Raspberry Pi, так что все файлы физически лежат на устройстве и доступны для дальнейшей работы.

Галерея MeshCenter
Галерея изображений в MeshCenter

📈 Телеметрия: данные, графики и экспорт

MeshCenter собирает и отображает телеметрию с Meshtastic-ноды и внешних датчиков:

  • 📊 Параметры устройства: напряжение, уровень заряда батареи, утилизация канала, воздушная загрузка, аптайм.
  • 🌡️ Данные с датчиков (BME280, INA226): температура, влажность, давление, ток, мощность.

Телеметрия автоматически сохраняется в историю. Вы можете просматривать её в виде графиков, выбирая интервалы: 1 час, 6 часов, 12 часов, 24 часа, 7 дней или 30 дней.

График Environment Sensors
История температуры, влажности и давления
График Power Sensors
Напряжение, ток и мощность на графике

Кроме того, добавлена возможность экспорта данных:

  • 🌡️ Environment Sensors — температура, влажность, давление;
  • ⚡ Power Sensors — напряжение, ток, мощность.

Экспорт доступен в формате CSV или JSON — это удобно для дальнейшего анализа в сторонних инструментах, построения отчётов или интеграции с другими системами.

Экспорт телеметрии
Экспорт данных телеметрии

📡 Управление узлами: список, фильтры, импорт/экспорт

MeshCenter автоматически обнаруживает узлы в сети и ведёт их локальную базу. Для каждого узла отображается:

  • 📛 имя и ID;
  • 🖥️ аппаратная модель (HW);
  • 📶 уровень сигнала (RSSI);
  • 📊 отношение сигнал/шум (SNR);
  • 🔢 количество хопов (прыжков) до узла;
  • 🕐 время последнего появления в сети.

Узлы можно фильтровать, искать, отмечать как ⭐ “Избранные” (быстрый доступ) или 🚫 “Игнорируемые” (скрыть из основного списка).

Также доступны импорт и экспорт всей базы узлов в CSV и JSON — это упрощает резервное копирование, перенос на другое устройство или обмен списком контактов между станциями.

Список узлов
Список узлов в MeshCenter
Управление узлами
Фильтры и инструменты управления узлами

🏗️ Архитектура и хранение данных

MeshCenter построен как монолитное Flask-приложение, но уже сейчас код разделён на логические модули: api/, camera/, meshsrv/, storage/, telemetry/, utils/. Это упрощает поддержку и будущее расширение.

Все данные хранятся в JSON-файлах — без внешней базы данных. Это делает установку простой, а бэкапы — элементарными. Просто скопируйте папку data/ на новый Pi — и всё работает.

🛤️ Путь к созданию: от идеи до реализации

Работа над MeshCenter стала для меня не просто созданием полезного инструмента, но и глубоким погружением в современные технологии веб-разработки. В процессе я получил практические знания:

  • 🔧 как устроены веб-приложения на базе Flask и как строить REST API;
  • 🔄 как взаимодействовать с внешними процессами (Meshtastic CLI) и обрабатывать их вывод;
  • 📷 как управлять камерой Raspberry Pi через Picamera2 и организовывать потоковое видео;
  • 🎨 как строить интерфейсы на чистом JavaScript (без тяжёлых фреймворков) и делать их удобными и отзывчивыми;
  • 📊 как работать с графиками (Chart.js), JSON-хранилищем, асинхронными операциями и многопоточностью.

Каждый модуль проекта — это отдельная история изучения и экспериментов. И хотя код не претендует на звание “индустриального стандарта”, он стал для меня мостиком от “железа” (которое я хорошо знаю) к “софту” (который я теперь тоже начинаю глубже понимать).

🚀 Планы на будущее

Проект живёт и развивается. В ближайших планах:

  • 🌦️ Интеграция с погодными сервисами — отображать текущую погоду рядом с сенсорными данными.
  • ⚙️ Веб-редактор настроек — чтобы менять конфигурацию прямо из браузера, без редактирования файлов.
  • 📡 Поддержка MQTT — для интеграции с Home Assistant.
  • 🧩 Плагинная архитектура — чтобы любой желающий мог добавить свой модуль.

И конечно, я продолжаю учиться. Каждый день в этом проекте даёт мне новые знания, и это для меня самое ценное.

💎 Заключение

То, что начиналось как простой “чат для практики”, превратилось в полноценную платформу для управления Meshtastic-станцией. MeshCenter уже сейчас помогает мне следить за сетью, общаться, делать снимки и анализировать телеметрию — всё через браузер, с любого компьютера в доме.

💡 Этот проект — доказательство того, что даже без профессионального бэкграунда, с помощью современных инструментов (включая ИИ), можно создавать реально работающие системы. Главное — желание, любопытство и готовность учиться.

🔨 Текущий статус разработки

На сегодняшний день основной планируемый функционал MeshCenter уже реализован и успешно работает в моей домашней сети. Проект достиг той стадии, когда он полностью покрывает мои базовые потребности: чат, телеметрия, управление камерой, работа с узлами — всё это стабильно функционирует и доступно через браузер.

Однако, как это часто бывает в разработке, самое интересное начинается после того, как “всё работает”. Теперь мои основные усилия смещаются в сторону оптимизации и устранения недочётов. Я планирую:

  • 🧹 Рефакторинг кода — улучшить структуру, убрать дублирование и сделать код более читаемым;
  • ⚡ Оптимизация производительности — уменьшить время отклика интерфейса, особенно при работе с большим объёмом телеметрии;
  • 🛡️ Обработка ошибок — сделать систему более устойчивой к сбоям связи и некорректным данным;
  • 🧪 Тестирование — добавить базовые автотесты, чтобы не ломать уже работающие функции при добавлении нового кода;
  • 📝 Документация — написать понятное руководство по установке и настройке для тех, кто захочет повторить мой опыт.

Работа продолжается, и я с удовольствием делюсь результатами. Если у вас есть идеи, предложения или вы нашли ошибку — заглядывайте в репозиторий на GitHub, я всегда открыт к диалогу и конструктивной критике. Вместе мы сможем сделать MeshCenter ещё лучше!

🍓 Если у вас есть Raspberry Pi и LoRa-модуль — попробуйте установить MeshCenter. Это не только полезно, но и даёт почву для новых экспериментов.