crowdsec-troubleshooter
Herramienta Docker ligera para diagnóstico CrowdSec+Traefik sin privilegios ni docker.sock. Verifica salud LAPI, bloqueos IP y pruebas de bloqueo en vivo con base de conocimientos integrada offline.
Ficha actualizada 25 sept 2026, 10:25 · upstream 25 sept 2026, 9:59 · release sin release detectada
Qué es crowdsec-troubleshooter
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
crowdsec-troubleshooter es una herramienta de diagnóstico diseñada específicamente para entornos que combinan CrowdSec con Traefik. Su enfoque principal es actuar como un 'wellness check' ligero, permitiendo verificar la salud del Local API (LAPI), analizar la actividad de parsing de logs y determinar el tipo de bouncer en uso sin requerir privilegios ni acceso al socket Docker.
La herramienta opera bajo un modelo de capas o 'tiers' que permite escalar las capacidades según sea necesario. El Tier 0 funciona con cero credenciales, realizando chequeos básicos como la liveness del LAPI y recomendaciones de actualización. Los niveles superiores desbloquean funciones avanzadas como comprobación de estado de bloqueos IP (Tier 1) y pruebas de bloqueo en vivo o auditoría de AppSec (Tier 2), requiriendo credenciales específicas para cada paso.
Incluye una base de conocimientos curada offline con 29 entradas sobre problemas comunes conocidos, lo que permite su funcionamiento en redes restringidas sin acceso a Docker Hub. Además, ofrece un 'wizard' interactivo para facilitar la configuración inicial y persistencia de valores mediante variables de entorno.
- Verificación rápida de salud del LAPI de CrowdSec sin credenciales (Tier 0).
- Comprobación del estado de bloqueo de una IP específica y razón del bloqueo (Tier 1).
- Prueba en vivo para confirmar que el bloqueo funciona end-to-end (Tier 2).
- Auditoría de configuración de firewall bouncer y detección de duplicados en adquisición.
- Consulta de base de conocimientos offline sobre problemas conocidos de CrowdSec/Traefik.
- Ejecución sin privilegios: No requiere docker.sock, capacidades especiales ni host networking.
- Base de conocimientos integrada offline con 29 entradas curadas desde repositorios oficiales.
- Modelo escalonado de credenciales: Tier 0 (sin creds), Tier 1/2 (keys/máquina) y Tier 3 (montajes de archivos).
- Wizard interactivo para configuración inicial y persistencia automática de valores en .env.
- Compatible con instalaciones bare-metal de CrowdSec, no solo Dockerizado.
- Funcionalidades avanzadas (bloqueos IP, pruebas en vivo) requieren credenciales explícitas del LAPI o máquina.
- La base de conocimientos es estática y debe actualizarse manualmente al construir una nueva imagen.
- Cobertura parcial de problemas conocidos: 29 entradas curadas a mano, no exhaustiva ni automática.
- Dependencia de red para Tier 0/1/2 hacia el LAPI; Tier 3 requiere acceso a archivos del host.
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.
Iniciar con Tier 0 usando solo -e CROWDSEC_LAPI_URL=http://crowdsec:8080 sin credenciales. Para pruebas de bloqueo en vivo (Tier 2), montar el archivo de credenciales de máquina (-v /path/machine.json:/creds/machine.json:ro). Usar wizard.sh para configuración interactiva que persiste valores en ./.crowdsec-troubleshooter.env. Ver FLAGS.md para lista completa de variables y montajes.
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.