meshcore-health-check
Aplicación autoalojada para medir la cobertura de mensajes MeshCore entre observadores conectados a MQTT. Genera códigos de prueba, escucha respuestas y calcula métricas de alcance con mapas y detalles de ruta.
Ficha actualizada 23 sept 2026, 20:05 · upstream 23 sept 2026, 19:36 · release v1.3.9
Qué es meshcore-health-check
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Esta herramienta web permite evaluar la fiabilidad de la red MeshCore analizando qué observadores reciben mensajes específicos. Funciona generando un código único (hash) que se envía a un canal configurado, luego monitorea las respuestas vía MQTT para determinar cuántos nodos reportaron el mensaje correctamente. Proporciona métricas detalladas como RSSI, SNR, tiempos de llegada y rutas entre repetidores.
La aplicación está diseñada para ejecutarse en contenedores Docker con Node.js 24, manteniendo datos persistentes en un volumen local para supervivencia de sesiones y perfiles de observadores. Incluye soporte para mapas basados en GeoJSON y claves API opcionales para proveedores como CARTO o OpenStreetMap.
Ofrece funcionalidades avanzadas como la selección automática de los mejores observadores recientes, filtros geográficos y generación de enlaces compartidos con resultados retenidos temporalmente. Es ideal para operadores de redes que necesitan validar la conectividad sin depender de servicios externos propietarios.
- Validación de cobertura de red MeshCore en zonas específicas
- Auditoría de nodos receptores en tiempo real mediante MQTT
- Visualización geográfica de rutas de mensajes y repetidores
- Pruebas de calidad de señal con métricas RSSI y SNR
- Gestión de enlaces compartidos para reportes de cobertura
- Selección dinámica de los observadores top por actividad reciente
- Soporte nativo para despliegue Docker Compose sin base de datos SQL
- Decodificación de paquetes MeshCore mediante librería oficial @michaelhart/meshcore-decoder
- Persistencia de datos en volúmenes locales para supervivencia de sesiones y perfiles
- Visualización de mapas interactivos con OpenStreetMap o tiles CARTO opcionales
- Gestión de sesiones compartidas con enlaces retenidos temporalmente por servidor
- Filtros geográficos mediante archivos GeoJSON para límites regionales
- Dependencia estricta de Node.js 24 para el runtime, sin soporte a otras versiones mayores
- Requiere configuración manual de credenciales MQTT y nombre del canal de prueba en .env
- Los mapas premium requieren clave API opcional; OpenStreetMap es fallback básico
- Migraciones mayores de versión de Node requieren revisión manual antes de aplicar
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Clonar repositorio, copiar .env.example a .env y ejecutar docker compose up -d --build. Montar volumen en carpeta data/ para preservar sesiones y perfiles. Asegurar conexión MQTT estable y configurar variables como MQTT_HOST, TEST_CHANNEL_NAME y CARTO_BASEMAP_KEY si se desea usar tiles premium.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.