speedtest-monitor
Monitor de velocidad de internet autoalojado con dashboard en vivo, alertas y autenticación OIDC. Usa Bun + Next.js 16 + SQLite. Incluye medición vía Cloudflare Speedtest sin navegador.
Ficha actualizada 24 sept 2026, 10:37 · upstream 24 sept 2026, 9:52 · release v1.22.6
Qué es speedtest-monitor
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
speedtest-monitor es una herramienta de monitorización de ancho de banda que se ejecuta localmente, utilizando la librería @cloudflare/speedtest para realizar pruebas HTTP sin necesidad de un navegador Chromium. El sistema almacena cada medición en una base de datos SQLite y ofrece un panel de control con actualizaciones en tiempo real a través de WebSocket.
La aplicación cuenta con autenticación robusta mediante Better Auth, soportando roles admin y viewer, así como integración con proveedores OIDC como Authelia o Keycloak. Permite configurar alertas por degradación de conexión o fallos, enviando notificaciones a múltiples destinos como Discord, Slack, email o webhooks personalizados.
El despliegue es sencillo mediante Docker Compose, pero requiere configuración inicial de variables de entorno para la autenticación y persistencia de datos. La arquitectura utiliza Bun como runtime, Next.js 16 con App Router y Drizzle ORM para la gestión de datos, manteniendo una complejidad media adecuada para entornos de producción estables.
- Monitorización continua del ancho de banda de subida y bajada en servidores o redes domésticas.
- Detección automática de degradaciones de conexión mediante alertas configurables por umbral.
- Dashboard en vivo para visualizar métricas de latencia, pérdida de paquetes y jitter.
- Integración con sistemas de notificación existentes (Discord, Slack, Email) para incidentes de red.
- Gestión de usuarios con roles diferenciados para equipos técnicos y observadores.
- Medición de velocidad sin dependencias de navegador, reduciendo la huella del contenedor.
- Utiliza Bun 1.x como runtime, ofreciendo un inicio rápido y bajo consumo de recursos.
- No requiere Chromium ni librerías de fuentes adicionales tras la migración a Cloudflare Speedtest.
- Soporte nativo para autenticación OIDC con proveedores estándar como Authelia o Authentik.
- Sistema de alertas inteligente que evita spam, activándose solo en transiciones de estado.
- Persistencia de datos en SQLite con soporte para rotación de logs automática en Docker.
- Interfaz de usuario basada en Astryx con tema personalizado y diseño responsivo.
- La autenticación requiere configuración inicial obligatoria (AUTH_SECRET) o uso del wizard de setup.
- Las credenciales de notificación no se persisten en la base de datos, solo en variables de entorno.
- La migración desde versiones anteriores de autenticación implica re-autenticación para todos los usuarios.
- El cambio de backend de medición a HTTP-only puede alterar ligeramente los valores absolutos de velocidad respecto a fast.com.
- No incluye curl ni herramientas de línea de comandos dentro de la imagen Docker oficial.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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.
Desplegar con docker compose up -d --build. Configurar AUTH_SECRET y BETTER_AUTH_URL obligatoriamente en producción. Persistir /data para SQLite y logs. Ajustar SPEEDTEST_TEST_DURATION_S para enlaces multi-Gbps. Usar SPEEDTEST_PARALLEL_STREAMS=16 en conexiones de 10 Gbps.
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.