miniserver
FastyBird MiniServer es una aplicación autónoma de IoT construida con PHP 8.4, Node.js y Symfony, que integra dispositivos (Shelly, Tuya, Sonoff, Viera), MQTT, Modbus y HomeKit en un solo punto de acceso JSON:API.
Ficha actualizada 22 sept 2026, 18:39 · upstream 22 sept 2026, 17:21 · release sin release detectada
Qué es miniserver
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
<p>MiniServer es una herramienta de desarrollo autónoma para IoT que permite gestionar dispositivos, conectarlos a la red, automatizar procesos y administrar interfaces web. Se construye sobre Nette y Symfony, integrando múltiples ecosistemas de dispositivos IoT (Shelly, Tuya, Sonoff, Viera, NsPanel, Zigbee2MQTT, Modbus) y Apple HomeKit.</p>
<p>La arquitectura centraliza la lógica del negocio en un backend JSON:API que se consume desde una interfaz Vue 3. Esto permite escalar fácilmente tanto el backend como la frontend sin necesidad de reestructurar el sistema.</p>
<p>El proyecto soporta despliegue con Docker Compose, configuraciones tradicionales mediante Composer y pnpm, y ofrece un módulo de autenticación seguro que genera tokens JWT para proteger las APIs. Además, incluye herramientas de gestión de bases de datos (MySQL, CouchDB) y servicios de mensajería (RabbitMQ).</p>
- Automatización de dispositivos IoT mediante configuración JSON:API sin necesidad de scripts personalizados
- Conexión unificada a múltiples ecosistemas (Shelly, Tuya, Sonoff, Viera) desde una sola interfaz
- Integración con Apple HomeKit para control remoto y automatizaciones en el ecosistema Apple
- Gestión centralizada de dispositivos mediante una API RESTful que soporta autenticación JWT
- Automatización de procesos empresariales a través de eventos MQTT y Modbus
- Despliegue escalable con Docker Compose, ideal para entornos de producción o desarrollo colaborativo
- Soporte nativo de múltiples ecosistemas IoT (Shelly, Tuya, Sonoff, Viera, NsPanel, Zigbee2MQTT, Modbus) en un solo proyecto
- Arquitectura modular con backend JSON:API y frontend Vue 3 separados pero integrados en una sola aplicación
- Sistema de autenticación seguro con tokens JWT que protege las APIs contra accesos no autorizados
- Soporte para múltiples bases de datos (MySQL, CouchDB) y servicios de mensajería (RabbitMQ)
- Diseño modular que permite agregar nuevas extensiones sin afectar el núcleo del proyecto
- Interfaz Vue 3 con ReactPHP para comunicación asíncrona entre frontend y backend
- Requiere PHP 8.4 o superior, Node.js 24+ y pnpm 10+, lo que limita la compatibilidad con entornos antiguos
- Depende de módulos externos (MySQL, CouchDB, RabbitMQ) que deben instalarse manualmente en cada entorno
- La autenticación JWT requiere configuración manual del servidor de tokens (JWT_SECRET), lo que añade una capa adicional de seguridad a gestionar
- El despliegue con Docker requiere configurar supervisord para los procesos de PHP y WebSocket, lo que puede complicar el despliegue en entornos sin Docker
- La integración con HomeKit depende de la disponibilidad del dispositivo Apple HomeKit, lo que no garantiza compatibilidad universal
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.
<p>Para producción recomendamos usar Docker Compose con la imagen precompilada en <code>ghcr.io/fastybird/miniserver</code>. El despliegue incluye nginx como reverse proxy, php-fpm para el servidor PHP y un worker de eventos bajo supervisord. Se recomienda configurar el archivo <code>.env.example</code> con las credenciales del JWT secret antes de iniciar la aplicación.</p> <p>En entornos tradicionales sin Docker, se debe ejecutar <code>composer install --no-dev --prefer-dist --classmap-authoritative</code>, compilar con <code>pnpm build</code> y crear el esquema de datos mediante <code>php bin/fb-console.php migrations:migrate</code>. Se recomienda usar un servidor web como Apache o Nginx para servir la aplicación.</p> <p>Para producción, se debe implementar un sistema de backups diarios en las bases de datos y configurar alertas de salud del servicio (CPU, memoria, disco).</p>
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.