Repolode
Enviar
TheDuffman85

TheDuffman85/crowdsec-web-ui

Un dashboard web autohospedado para CrowdSec que permite investigar alertas, gestionar decisiones, consultar métricas de ejecución y enviar notificaciones.

Ver en GitHub
Estrellas
952
Forks
48
Issues abiertos
4
Último commit
ayer

¿Qué es?

CrowdSec Web UI es un dashboard autohospedado que se conecta a una o varias CrowdSec Local APIs (LAPIs). Permite a los operadores consultar el historial de alertas con búsquedas y filtros rápidos, inspeccionar el contexto de CrowdSec asociado a cada alerta y ver las decisiones activas y vencidas. Desde la misma interfaz se pueden añadir bloqueos manuales con duración y motivo personalizados, además de realizar acciones de limpieza.

La UI puede combinar varias instancias de CrowdSec en una vista combinada del dashboard, las alertas y las decisiones. Las vistas opcionales de métricas de Prometheus abarcan la actividad de LAPI, los bouncers, AppSec, los parsers y las whitelists. Las reglas de notificación para alertas, decisiones, CVE, disponibilidad y actualizaciones se pueden enviar por Email, Gotify, MQTT, ntfy o webhooks.

La aplicación funciona como un servidor Node.js con un cliente React, guarda el estado en SQLite y se distribuye como una imagen de Docker. Entre las opciones de seguridad se incluyen el inicio de sesión con contraseña y TOTP, passkeys, SSO con OIDC y roles basados en grupos, y un modo de solo lectura para toda la instancia.

Funciones clave

  • 01Historial de alertas con búsqueda, contexto de CrowdSec e información de IP, AS y ubicación
  • 02Gestión de decisiones activas y vencidas, incluidos bloqueos manuales con duraciones personalizadas
  • 03Conexión a varias CrowdSec LAPIs con una vista de ámbito combinado
  • 04Vistas opcionales de métricas de Prometheus para LAPI, bouncers, AppSec y parsers
  • 05Reglas de notificación enviadas por Email, Gotify, MQTT, ntfy o webhooks
  • 06Inicio de sesión con contraseña, TOTP, passkeys y SSO con OIDC y roles basados en grupos

Casos de uso

  • Operadores que usan CrowdSec en varios servidores y quieren un único dashboard para todas las LAPIs
  • Equipos que necesitan revisar alertas y bloquear o desbloquear IPs manualmente sin usar la línea de comandos
  • Administradores de homelabs o equipos pequeños que quieren recibir notificaciones push de nuevas alertas y decisiones
  • Organizaciones que integran el acceso a CrowdSec con un proveedor de identidad OIDC existente

Inicio rápido

  1. 1

    Genera una contraseña aleatoria con openssl

    openssl rand -hex 32
  2. 2

    Registra la Web UI como una máquina en tu contenedor de CrowdSec

    docker exec crowdsec cscli machines add crowdsec-web-ui --password 'replace-with-generated-password' -f /dev/null
  3. 3

    Inicia la Web UI con Docker Compose usando el archivo docker-compose.yml incluido

    docker compose up -d
  4. 4

    Abre http://localhost:3000 en el navegador y crea la cuenta inicial de administrador

Antes de usarlo

  • Necesitas una instancia de CrowdSec LAPI en ejecución a la que conectarte.
  • Está bajo la licencia AGPL-3.0, una licencia de copyleft fuerte.
  • Las implementaciones públicas deben estar detrás de HTTPS y de un proxy inverso reforzado, ya que la aplicación no gestiona TLS.
  • Las instalaciones migradas anteriores a la autenticación seguirán sin autenticación hasta que la habilites.

En colecciones

Apps autoalojadasInicio de sesión, SSO y servidores de identidad

Temas

#crowdsec#security-dashboard#intrusion-detection#self-hosted#docker#prometheus#notifications#oidc#crowdsec-lapi#crowdsec-manager

Preguntas frecuentes

¿Qué es crowdsec-web-ui?
Un dashboard web autohospedado para CrowdSec que permite investigar alertas, gestionar decisiones, consultar métricas de ejecución y enviar notificaciones. CrowdSec Web UI es un dashboard autohospedado que se conecta a una o varias CrowdSec Local APIs (LAPIs). Permite a los operadores consultar el historial de alertas con búsquedas y filtros rápidos, inspeccionar el contexto de CrowdSec asociado a cada alerta y ver las decisiones activas y vencidas. Desde la misma interfaz se pueden añadir bloqueos manuales con duración y motivo personalizados, además de realizar acciones de limpieza.
¿crowdsec-web-ui es gratuito? ¿Qué licencia tiene?
crowdsec-web-ui es open source bajo la licencia AGPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿crowdsec-web-ui sigue mantenido?
Mantenimiento activo. El último commit de crowdsec-web-ui fue el 6 nov 2026.
¿Para qué puedo usar crowdsec-web-ui?
Operadores que usan CrowdSec en varios servidores y quieren un único dashboard para todas las LAPIs Equipos que necesitan revisar alertas y bloquear o desbloquear IPs manualmente sin usar la línea de comandos Administradores de homelabs o equipos pequeños que quieren recibir notificaciones push de nuevas alertas y decisiones Organizaciones que integran el acceso a CrowdSec con un proveedor de identidad OIDC existente
¿Cómo se instala crowdsec-web-ui?
Genera una contraseña aleatoria con openssl: openssl rand -hex 32 Registra la Web UI como una máquina en tu contenedor de CrowdSec: docker exec crowdsec cscli machines add crowdsec-web-ui --password 'replace-with-generated-password' -f /dev/null Inicia la Web UI con Docker Compose usando el archivo docker-compose.yml incluido: docker compose up -d Abre http://localhost:3000 en el navegador y crea la cuenta inicial de administrador
¿Dónde consigo crowdsec-web-ui?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/TheDuffman85/crowdsec-web-ui

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados