crowdsec-unifi-suite
Instalador unificado para desplegar CrowdSec en redes UniFi, gestionando el stack completo (motor, parser, bouncer) con soporte Docker y CLI interactiva. Incluye sidecar proxy para filtrar decisiones y evitar saturación del firewall local.
Ficha actualizada 23 sept 2026, 20:24 · upstream 23 sept 2026, 19:51 · release v1.0.1
Qué es crowdsec-unifi-suite
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio ofrece una solución integral para integrar la plataforma de seguridad CrowdSec en redes UniFi. Proporciona un instalador interactivo para gateways (UDM, UDR, etc.) y un stack basado en Docker para servidores Linux externos. La arquitectura centraliza el análisis de logs en el servidor mientras delega la ejecución de bloqueos al bouncer del gateway mediante una API proxy.
El componente clave es el sidecar proxy, que actúa como intermediario entre el motor CrowdSec y el firewall UniFi. Este proxy evalúa las decisiones de bloqueo basándose en múltiples factores (severidad, origen, TTL) y aplica un límite para asegurar que no se exceda la capacidad del conjunto ipset del dispositivo de red.
Además, facilita la importación de listas de amenazas externas como AbuseIPDB, Spamhaus e IPsum mediante un daemon dedicado, permitiendo una inteligencia de amenazas proactiva sin depender exclusivamente de las listas comunitarias por defecto.
- Protección activa contra ataques DDoS en gateways UniFi (UDM/UDR).
- Implementación rápida de seguridad perimetral con un solo comando en el gateway.
- Centralización del análisis de logs de firewall y IDS en servidor externo.
- Gestión automática de listas de bloqueo mediante feeds externos (AbuseIPDB, Spamhaus).
- Despliegue flexible en infraestructuras híbridas (Docker + Gateway local).
- Incluye sidecar proxy para filtrar decisiones y respetar límites de ipset.
- Soporte nativo para instalación interactiva y scripts Docker Compose.
- Integración directa con feeds de inteligencia de amenazas externos (AbuseIPDB, Spamhaus).
- Compatibilidad verificada con modelos Enterprise, Pro y Consumer de UniFi.
- No soporta arquitectura mips64 (ej. USG/USG Pro) según documentación.
- Estado actual en versión beta v1.0.1, requiriendo supervisión activa.
- Dependencia de Docker para el stack de servidor externo.
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.
Instalar primero CrowdSec en el servidor Docker y generar credenciales antes de arrancar el resto del stack. Configurar api_url en el bouncer del gateway apuntando al sidecar (puerto 8084) y no directamente a LAPI. Ajustar max_decisions según la capacidad ipset del dispositivo UniFi específico.
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.