amule-react-ui
Interfaz web reactiva para gestionar aMule mediante la API REST y eventos SSE nativos de amuleapi, sin backend personalizado ni servidor Node.js separado.
Ficha actualizada 24 sept 2026, 0:18 · upstream 24 sept 2026, 0:08 · release v1.1.0
Qué es amule-react-ui
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio proporciona una consola de operaciones basada en el navegador para aMule, diseñada para ser servida por el proceso nativo amuleapi. La arquitectura evita un backend personalizado o un servidor Node.js separado; la pila en ejecución consiste en el navegador que se comunica con amuleapi (archivos estáticos, REST y SSE), el cual es servido por amuled. Esta configuración de mismo origen mantiene la cookie de sesión HttpOnly, las solicitudes REST y las actualizaciones en tiempo real del SSE unidas.
El proyecto incluye una imagen de contenedor construida desde el código fuente y un despliegue Compose de un solo servicio. Ejecuta amuled con su proceso nativo amuleapi e sirve la SPA empaquetada sin necesidad de un runtime Node.js. Soporta tanto desarrollo local con Vite como despliegues en producción mediante archivos estáticos.
La interfaz ofrece estado en vivo autenticado, actividad de subida y descarga, búsquedas, controles de servidor/red, categorías y diálogos de confirmación para acciones con consecuencias. No almacena contraseñas ni tokens en el almacenamiento del navegador; la autenticación utiliza la cookie HttpOnly de la API.
- Monitorización en tiempo real de actividad de subida y descarga mediante eventos SSE
- Gestión de búsquedas P2P con soporte para múltiples categorías
- Control remoto de servidor y red (conectarse, desconectarse, reiniciar)
- Despliegue autocontenido en contenedores Docker sin runtime Node.js en producción
- Arquitectura ligera que evita un backend personalizado o servidor Node.js separado
- Soporte nativo para eventos SSE y API REST en el mismo origen
- Imágenes Docker multiplataforma con tagging inmutable de versiones combinadas
- Scripts de despliegue repetibles con soporte para rollback automático
- Generación automática de archivos de liberación con checksum SHA-256
- Dependencia de aMule compilado desde fuente con amuled y amuleapi habilitados
- Configuración manual obligatoria de la contraseña admin en amuleapi
- Requiere TLS fuera del origen para despliegues más allá de redes locales confiables
- El workflow de liberación es manual y no despliega automáticamente a hosts aMule
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.
Para producción, usa el script install-static-ui.sh con rutas absolutas. Configura StaticRoot en amuleapi.conf apuntando al directorio dist/. Restringe el listener de la API y reglas del firewall a la red intencionada. Coloca TLS delante de amuleapi antes de exponerlo fuera de una red local confiable. Para Docker, configura DOCKERHUB_IMAGE, DOCKERHUB_USERNAME y DOCKERHUB_TOKEN como secretos en GitHub Actions.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.