CircuitBreaker
Plataforma auto-alojada para visualización de infraestructura homelab con mapeo topológico interactivo, telemetría en tiempo real e integración nativa con Proxmox/TrueNAS.
Ficha actualizada 22 sept 2026, 17:32 · upstream 22 sept 2026, 14:50 · release v0.4.3
Qué es CircuitBreaker
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
CircuitBreaker es una plataforma de visualización de infraestructura diseñada para entornos homelab que permite mapear hardware, servicios y redes con topología interactiva. Utiliza tecnologías como React, Node.js y FastAPI sobre PostgreSQL y Redis para gestionar datos de telemetría en tiempo real mediante WebSockets.
La herramienta destaca por su capacidad de descubrimiento automático (nmap/SNMP/ARP) que integra Proxmox VMs, TrueNAS pools y dispositivos UniFi sin intervención manual. Incluye agentes remotos con cifrado Noise para monitorear sitios aislados y diagramas de racks con soporte para 70+ dispositivos de 20 vendedores.
La seguridad es robusta con autenticación OAuth/OIDC, MFA TOTP, encriptación Fernet para secretos y logs auditables con cadena SHA-256. Soporta despliegue nativo vía systemd o Docker Compose, aunque la versión actual 0.4.3 requiere precauciones de seguridad.
- Visualización topológica interactiva de infraestructura física y lógica en entornos homelab
- Monitorización de salud de hardware mediante SNMP/iDRAC/iLO con indicadores visuales en tiempo real
- Gestión remota de sitios aislados mediante agentes cb-agent con cifrado Noise y sin reglas de firewall entrantes
- Auditoría de cambios con logs inmutables y cadena hash SHA-256 para trazabilidad forense
- Integración nativa con Proxmox (LXC/VM) y TrueNAS mediante importación automática de clusters
- Soporte para 70+ dispositivos de 20 vendedores incluyendo Dell, HPE, Ubiquiti y APC
- Autenticación robusta con OAuth (GitHub/Google), OIDC genérico y MFA TOTP integrado
- Agentes remotos cb-agent con cifrado Noise para monitoreo en redes inalcanzables desde el servidor principal
- Versión Release Candidate 0.4.3 sin auditoría de seguridad completa; no apta para exposición directa a internet
- Requiere despliegue en LAN confiable o detrás de VPN según contrato de soporte v1.0.0
- Mínimos de recursos: 2 núcleos CPU, 2GB RAM y 30GB disco para instalación nativa
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 vía script nativo (systemd) o Docker Compose en LAN confiable. Usar certificado Let's Encrypt solo para dominios públicos; CA auto-firmada para LAN. Ejecutar cb update periódicamente y mantener agente cb-agent actualizado. No exponer puerto 80/443 directamente a internet sin VPN.
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.