Juan Denis
b4414aa5b8
Add a unified, cross-platform development launcher and update docs/styles to SCSS. - Add dev/dev.sh: comprehensive Bash dev launcher with stable non-default ports, port resolution/cleanup, WSL-aware behavior, ngrok support, and validation tooling. - Rewrite Windows entrypoint (dev.ps1) to require WSL and delegate to dev/dev.sh; make top-level dev.sh a thin wrapper that execs dev/dev.sh. - Add AGENTS.md with project overview, architecture, and development instructions for assistance tools. - Update docs (CLAUDE.md, CONTRIBUTING.md) to reflect migration from LESS to SCSS and update style guidance. - Update .gitignore to ignore backend/.venv-wsl, frontend.env.development.local, and /.agents. - Frontend: add new pages and page-specific SCSS files, update main.scss, components, pages, client/socket services, and vite.config.js to support the SCSS-based frontend changes. These changes unify local development workflows (especially via WSL), improve port stability, and complete the frontend styling migration from LESS to SCSS.
12 KiB
ServerKit
Infraestructura autoalojada, simplificada.
Un panel de control de servidores ligero y moderno para gestionar aplicaciones web, bases de datos, contenedores Docker y seguridad — sin la complejidad de Kubernetes ni el coste de las plataformas gestionadas.
English | Español | 中文版 | Português
Funcionalidades · Inicio Rápido · Capturas de Pantalla · Arquitectura · Hoja de Ruta · Documentación · Contribuir · Discord
🎯 Funcionalidades
Aplicaciones y Contenedores
🐘 PHP / WordPress — PHP-FPM 8.x con instalación de WordPress en un clic
🐍 Aplicaciones Python — Despliega Flask y Django con Gunicorn
🟢 Node.js — Aplicaciones gestionadas con PM2 y transmisión de logs en tiempo real
🐳 Docker — Gestión completa de contenedores y Docker Compose
🔑 Variables de Entorno — Gestión segura y cifrada de variables por aplicación
Infraestructura
🌐 Gestión de Dominios — Hosts virtuales Nginx con configuración sencilla
🔒 Certificados SSL — Let's Encrypt automático con renovación automática
🗄️ Bases de Datos — Soporte para MySQL/MariaDB y PostgreSQL
🛡️ Firewall (UFW) — Gestión visual de reglas de firewall
⏰ Tareas Programadas (Cron) — Programa tareas con un editor visual
📁 Gestor de Archivos — Navega y edita archivos desde la interfaz web
📡 Servidor FTP — Gestión de usuarios y accesos de vsftpd
Seguridad
🔐 Autenticación de Dos Factores — Basada en TOTP con códigos de respaldo
🦠 Análisis de Malware — Integración con ClamAV y cuarentena
📋 Monitorización de Integridad de Archivos — Detecta cambios no autorizados en archivos
🚨 Alertas de Seguridad — Notificaciones de amenazas en tiempo real
🧱 Fail2ban y SSH — Protección contra fuerza bruta y gestión de claves SSH
Monitorización y Alertas
📊 Métricas en Tiempo Real — Monitorización de CPU, RAM, disco y red vía WebSocket
📈 Seguimiento de Disponibilidad — Datos históricos de tiempo de actividad del servidor
🔔 Notificaciones — Discord, Slack, Telegram y webhooks genéricos
🖥️ Multi-Servidor — Monitorización y gestión remota de servidores basada en agentes
🚀 Inicio Rápido
⏱️ En funcionamiento en menos de 2 minutos
Opción 1: Instalación en Una Línea (Recomendada)
curl -fsSL https://serverkit.ai/install.sh | bash
Funciona en Ubuntu 22.04+ y Debian 12+. Configura todo automáticamente.
Opción 2: Docker
git clone https://github.com/jhd3197/ServerKit.git
cd ServerKit
cp .env.example .env # luego edita .env con tus claves
docker compose up -d # accede en http://localhost
Opción 3: Instalación Manual
Consulta la Guía de Instalación para instrucciones paso a paso.
Requisitos
| Mínimo | Recomendado | |
|---|---|---|
| SO | Ubuntu 22.04 LTS | Ubuntu 24.04 LTS |
| CPU | 1 vCPU | 2+ vCPU |
| RAM | 1 GB | 2+ GB |
| Disco | 10 GB | 20+ GB |
| Docker | 24.0+ | Última versión |
📸 Capturas de Pantalla
Ver Más Capturas
🏗️ Arquitectura
┌──────────────────┐
│ INTERNET │
└────────┬─────────┘
│
▼
┌──────────────────────────────────────────────────────────────────────────┐
│ YOUR SERVER │
│ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ NGINX (Reverse Proxy) │ │
│ │ :80 / :443 │ │
│ │ │ │
│ │ app1.com ──┐ app2.com ──┐ api.app3.com ──┐ │ │
│ └───────────────┼─────────────────┼─────────────────────┼─────────────┘ │
│ │ proxy_pass │ proxy_pass │ proxy_pass │
│ ▼ ▼ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ DOCKER CONTAINERS │ │
│ │ │ │
│ │ ┌───────────┐ ┌───────────┐ ┌───────────┐ │ │
│ │ │ WordPress │ │ Flask │ │ Node.js │ ... │ │
│ │ │ :8001 │ │ :8002 │ │ :8003 │ │ │
│ │ └─────┬─────┘ └───────────┘ └───────────┘ │ │
│ └──────────┼──────────────────────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────────────────────────┐ │
│ │ DATABASES │ │
│ │ MySQL :3306 PostgreSQL :5432 Redis :6379 │ │
│ └─────────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────────┘
Ver Documentación Completa de Arquitectura → — Flujo de peticiones, sistema de plantillas, asignación de puertos, vinculación de bases de datos y resolución de problemas.
🗺️ Hoja de Ruta
- Infraestructura base — Flask + React + JWT + WebSocket
- Gestión de aplicaciones — PHP, Python, Node.js, Docker
- Dominios y SSL — Hosts virtuales Nginx, Let's Encrypt
- Bases de datos — MySQL, PostgreSQL
- Gestión de archivos y FTP
- Monitorización y alertas — Métricas, webhooks, seguimiento de disponibilidad
- Seguridad — 2FA, ClamAV, integridad de archivos, Fail2ban
- Firewall — Integración con UFW
- Gestión multi-servidor — Agente en Go, panel centralizado
- Despliegue con Git — Webhooks, despliegue automático, rollback, sin tiempo de inactividad
- Copias de seguridad y restauración — S3, Backblaze B2, copias programadas
- Servidor de correo — Postfix, Dovecot, DKIM/SPF/DMARC
- Equipos y permisos — RBAC, registro de auditoría
- Aplicación móvil — React Native con notificaciones push
- Marketplace de plugins — Extensiones, widgets personalizados, temas
Detalles completos: ROADMAP.md
📖 Documentación
| Documento | Descripción |
|---|---|
| Arquitectura | Diseño del sistema, flujo de peticiones, diagramas |
| Guía de Instalación | Instrucciones completas de configuración |
| Guía de Despliegue | Comandos CLI y despliegue en producción |
| Referencia de la API | Endpoints de la API REST |
| Hoja de Ruta | Hoja de ruta de desarrollo y funcionalidades planificadas |
| Contribuir | Cómo contribuir |
🧱 Stack Tecnológico
| Capa | Tecnología |
|---|---|
| Backend | Python 3.11, Flask, SQLAlchemy, Flask-SocketIO |
| Frontend | React 18, Vite, SCSS |
| Base de Datos | SQLite / PostgreSQL |
| Servidor Web | Nginx, Gunicorn |
| Contenedores | Docker, Docker Compose |
| Seguridad | ClamAV, TOTP (pyotp), Cryptography |
🤝 Contribuir
¡Las contribuciones son bienvenidas! Por favor, lee primero CONTRIBUTING.md.
fork → rama de funcionalidad → commit → push → pull request
Áreas prioritarias: Implementación de copias de seguridad, canales de notificación adicionales, mejoras de UI/UX, documentación.
💬 Comunidad
Únete al Discord para hacer preguntas, compartir comentarios u obtener ayuda con tu configuración.
ServerKit — Simple. Moderno. Autoalojado.
Reportar un Error · Solicitar una Funcionalidad
Hecho con ❤️ por Juan Denis