easyzfs
Aplicación ligera de gestión ZFS escrita en Go como único binario estático, sin Docker ni sistema operativo dedicado. Incluye PWA embebido, API REST/SSE y alertas Web Push para monitorear pools, datasets, instantáneas y estado de discos.
Ficha actualizada 24 sept 2026, 7:34 · upstream 24 sept 2026, 7:22 · release v2.9.24
Qué es easyzfs
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
EasyZFS es una herramienta de gestión especializada para entornos ZFS que reside directamente en el NAS o servidor Linux, evitando la sobrecarga de sistemas completos como TrueNAS. Desarrollada en Go con un único binario estático (~12 MB), utiliza SQLite embebido para persistencia y React/Vite para una interfaz PWA moderna. Su filosofía es minimalista: corre en contenedores LXC pequeños (mínimo 256 MB RAM) sin necesidad de Docker, elevando privilegios solo cuando es estrictamente necesario mediante sudoers limitado.
La aplicación se integra con systemd y ofrece una API REST + SSE para actualizaciones en tiempo real. Gestiona operaciones complejas como expansión RAID-Z, checkpoints de pools y defragmentación (`zfs rewrite`) a través de la interfaz web. Incluye un modo demostrativo seguro que bloquea acciones destructivas, ideal para pruebas o presentaciones sin riesgo.
- Monitoreo continuo de salud ZFS (pools degradados, fallos SMART, temperaturas) con alertas push al móvil.
- Gestión de instantáneas y scrubs programados mediante tareas automáticas (`easyzfs-auto-*`).
- Despliegue en infraestructuras ligeras como LXC o VMs pequeñas donde TrueNAS no cabe.
- Auditoría de acciones destructivas con confirmación explícita y registro en log de auditoría.
- Visualización de progreso en tiempo real para reconstrucción de discos o expansión de RAID-Z.
- Binario estático Go sin dependencias C, ideal para despliegues rápidos y portabilidad.
- Consumo de memoria extremadamente bajo (tens of MB), viable en LXC de 256 MB.
- Alertas Web Push nativas sin intermediarios externos ni dependencia de servicios de terceros.
- Soporte para operaciones avanzadas ZFS como `zfs rewrite` y expansión RAID-Z con UI.
- Modo DEMO=1 que simula datos reales pero bloquea mutaciones, seguro para demostración.
- No proporciona shares de red (SMB/NFS/iSCSI) ni soporte para aplicaciones o máquinas virtuales por diseño.
- Autenticación y roles básicos; carece del RBAC granular y auditoría empresarial de TrueNAS.
- Depende de binarios externos en el sistema (`zpool`, `smartctl`, `hdparm`) que deben estar instalados.
- Base de datos SQLite embebida, no apta para entornos de alta concurrencia o multi-nodo distribuido.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
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 Linux con systemd, ZFS y smartmontools. Instalar mediante script `deploy/install.sh` o manualmente creando usuario `easyzfs` y unit systemd. Configurar `/etc/easyzfs/env` con secretos seguros (SESSION_SECRET, ADMIN_PASSWORD). Usar sudoers limitado para ejecutar binarios específicos como root sin dar acceso total al sistema. Para pruebas seguras, activar entorno DEMO=1.
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.