minecraft-server-controller
Panel de control auto-hospedado para servidores Fabric en Windows, gestionando inicio/parada, consola en vivo, recuperación de crashes, backups verificados y gestión de mods vía HTTPS y Tailscale.
Ficha actualizada 28 sept 2026, 12:50 · upstream 28 sept 2026, 11:38 · release v1.1.0
Qué es minecraft-server-controller
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Minecraft Server Controller es un panel de control auto-hospedado diseñado específicamente para servidores Minecraft Fabric ejecutándose en Windows. Utiliza una arquitectura basada en Python con FastAPI y Next.js para ofrecer una interfaz web segura que permite gestionar el servidor sin necesidad de iniciar sesión manualmente en la máquina. El sistema incluye un agente local que supervisa el proceso del juego, proporcionando un dashboard accesible desde cualquier dispositivo a través de una red privada Tailscale con autenticación HTTPS.
La herramienta destaca por su capacidad de detección y recuperación automática ante fallos. Cuando el servidor se cierra inesperadamente, el sistema registra la evidencia, identifica la causa probable y puede reiniciar automáticamente tras un periodo de espera configurable. Además, ofrece gestión integral de mods con verificación de checksums, resolución de dependencias y restauración segura de backups que son validados antes de ser considerados confiables.
La seguridad es una prioridad en el diseño del sistema. El acceso se limita exclusivamente a la red Tailscale, las contraseñas se almacenan como hashes nunca en texto plano, e incluye limitación de tasa, tokens de sesión y registro de auditoría. La interfaz web soporta temas claro/oscuro siguiendo el sistema operativo por defecto, y ofrece consola en vivo con filtrado, copia y entrada de comandos que requieren confirmación para acciones riesgosas.
- Gestión centralizada de servidores Fabric en múltiples PCs Windows desde una interfaz web unificada
- Detección automática de crashes del servidor Minecraft con análisis de logs y reinicio controlado
- Administración segura de mods con verificación de dependencias, checksums y gestión de versiones
- Monitoreo remoto de métricas en tiempo real (TPS, memoria, CPU, jugadores) vía Tailscale
- Automatización de tareas de mantenimiento como backups programados, limpieza de logs y ventanas de mantenimiento
- Detección automática de crashes con análisis de causa probable y protección contra bucles de reinicio
- Gestión de mods con verificación de checksums, resolución de dependencias y rollback seguro
- Backups verificados antes de ser considerados confiables con restauración segura y retención configurable
- Acceso restringido exclusivamente a red Tailscale con HTTPS, tokens de sesión y limitación de tasa
- Consola en vivo con filtrado, copia, descarga y entrada de comandos con confirmación para acciones riesgosas
- Requiere Windows 10 o 11; no compatible con Linux ni macOS sin adaptaciones manuales
- Depende de Python 3.11+ instalado previamente en el sistema objetivo
- No incluye soporte nativo para Docker, Kubernetes o despliegues en contenedores
- Requiere permisos de administrador para configurar reglas de firewall y tareas programadas de inicio
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.
Instalar ejecutando setup.ps1 desde el proyecto con permisos de administrador. Configurar server.directory, server.jar y server.java en config/config.yaml. Establecer tls.hostname y network.host desde Tailscale. Generar secretos con make_secrets antes de usar .env. Verificar instalación con --check. Habilitar autostart tras configuración inicial.
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.