WrtMonitor

WrtMonitor - self-hosted сервер, Web UI, Android-приложение и OpenWrt-агент для мониторинга и удалённого управления роутерами OpenWrt.

Текущая версия

Текущая тестовая версия: v0.32.0-push-reliability. Публичного стабильного релиза пока нет; тестовые базы можно пересоздавать между несовместимыми версиями.

Главное в 0.32.0:

• агент получает команды через long-poll без ожидания следующей telemetry;
• Web UI и Android обновляют открытый экран через единый SSE-поток;
• интервал telemetry остаётся независимым и настраиваемым от 5 секунд;
• при потере сервера агент использует ограниченный экспоненциальный backoff;
• добавлены метрики подключений, пробуждений, timeout и переполнения событий.

Полная история изменений: CHANGELOG.md.

Что уже есть

• сервер FastAPI + PostgreSQL + Alembic;
• текущая модель доступа: single-owner, без ролей и мультипользовательского режима;
• Web UI со светлой и тёмной dashboard-темой;
• Android-клиент;
• OpenWrt-агент для регистрации, telemetry, очереди команд, diagnostics и автообновления;
• установка через Docker Compose, VPS, домашний Linux-сервер, NAS с Docker и TrueNAS Custom App;
• управление Wi-Fi, сетью, DHCP, системными сервисами, диагностикой и жизненным циклом агента;
• release artifacts для сервера, агента и Android.

Интерфейс

Обзор роутера

Клиенты домашней сети

Интернет и интерфейсы

Быстрый старт

1. Разверните сервер и PostgreSQL через Docker Compose или TrueNAS.
2. Откройте /setup.
3. Создайте первого администратора.
4. Проверьте /ready.
5. Откройте Аккаунт -> Подключить мобильное приложение, создайте QR и отсканируйте его в Android. Ручной ввод адреса и вход по паролю остаются доступны.
6. Установите OpenWrt-агент.

Для reverse proxy указывайте внешний HTTPS-адрес:

WRTMONITOR_PUBLIC_SERVER_URL=https://monitor.example.ru
WRTMONITOR_ALLOW_INSECURE_LOCAL=false

Для локального временного теста можно включить HTTP:

WRTMONITOR_PUBLIC_SERVER_URL=http://192.168.1.10:8088
WRTMONITOR_ALLOW_INSECURE_LOCAL=true

TrueNAS

Базовый YAML лежит в deploy/truenas/wrtmonitor-truenas.yaml.

В релизе он публикуется как:

wrtmonitor-truenas-v0.32.0.yaml

Контейнер использует:

ghcr.io/shurshick/wrtmonitor:latest

latest скачивается при redeploy через Edit -> Save, но не обновляет уже запущенный контейнер сам по себе.

OpenWrt-агент

OpenWrt-агент можно установить:

• с GitHub Release;
• прямо с уже развернутого сервера https://monitor.example.ru/downloads/openwrt/.

Сервер раздаёт:

• wrtmonitor-agent
• wrtmonitor.init
• install-openwrt.sh
• agent-version.txt
• openwrt-agent-files.txt
• SHA256SUMS.txt
• SHA256SUMS.sig
• lib/*.sh

Подробности:

• OpenWrt agent
• Развёртывание сервера
• Эксплуатация и восстановление
• Router management core

Документация

• OpenWrt agent
• Развёртывание сервера
• API
• Архитектура
• Жизненный цикл команд
• Проверка на реальном роутере
• Android
• Roadmap
• Changelog

История релизов теперь ведётся в одном месте: CHANGELOG.md. Отдельные старые промежуточные release notes больше не поддерживаются.