BaluHost
Plataforma self-hosted para servidores domésticos con núcleo NAS (RAID, WebDAV), control de hardware, VPN y marketplace de plugins. Construida en FastAPI y React.
Ficha actualizada 22 sept 2026, 14:40 · upstream 22 sept 2026, 14:12 · release v1.38.0
Qué es BaluHost
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
BaluHost es una plataforma integral para gestión de servidores domésticos que centraliza almacenamiento, red y monitorización en una interfaz web moderna. Su núcleo se basa en un sistema NAS robusto con soporte para RAID (0, 1, 5, 6, 10), gestión de archivos, WebDAV y compartición Samba/SMB.
La arquitectura combina un backend en Python FastAPI con una frontend en React TypeScript, permitiendo una extensibilidad significativa mediante un sistema de plugins. Estos plugins operan en dos niveles de confianza: integrados (bundled) o externos (sandboxed), lo que facilita la expansión funcional sin comprometer la seguridad del núcleo.
Además de las funciones básicas, ofrece control granular sobre el hardware, incluyendo gestión de ventiladores PWM, escalado de frecuencia CPU y monitorización de energía mediante dispositivos inteligentes como Tapo. La plataforma incluye integración con Pi-hole para DNS y WireGuard para VPN, todo ello desplegable en Debian 12/13 con PostgreSQL.
- Servidor NAS doméstico o pequeño empresarial con gestión de RAID y almacenamiento compartido.
- Centro de control de hardware para optimización energética y gestión de ventiladores en PCs AMD/Intel.
- Punto de acceso seguro con servidor VPN WireGuard, firewall básico y filtrado DNS vía Pi-hole.
- Plataforma extensible mediante marketplace de plugins para añadir funcionalidades específicas sin recompilar el núcleo.
- Monitorización del sistema con exportación de métricas a Prometheus y visualización en Grafana.
- Sistema de plugins dual: módulos integrados (bundled) y externos sandboxeados con verificación de firma ed25519.
- Soporte nativo para múltiples arrays RAID con monitorización SMART en tiempo real.
- Control avanzado de hardware: PWM fans, CPU frequency scaling y gestión de energía Tapo.
- Arquitectura modular desplegable vía script de instalación en Debian sin necesidad de Docker.
- Autodespliegue mediante CI/CD a partir de push a main con rollback automático ante fallos.
- Seguridad robusta: autenticación JWT, TOTP 2FA, rate limiting y headers de seguridad.
- No utiliza Docker ni Compose; requiere instalación manual o scripts específicos en Debian 12/13.
- El despliegue de producción está optimizado para hardware específico (ej. Ryzen 5 5600GT, RX 7900 XT) según la máquina de referencia.
- Los plugins externos requieren configuración de capacidades y verificación de firmas antes de su instalación.
- La interfaz gráfica depende de Nginx como proxy inverso para servir el frontend estático.
- Actualizaciones del sistema requieren gestión manual o uso del script de auto-actualización proporcionado.
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.
Requiere Debian 12/13. Instalar con ./deploy/install/install.sh o systemd. Necesita PostgreSQL 17.7, Nginx y Python 3.11+. El frontend se sirve desde client/dist/. Habilitar módulos opcionales (RAID, VPN) según FEATURE_DEPENDENCIES. CI/CD auto-desplegado a main.
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.