Este proyecto es un dashboard de monitorización que muestra en tiempo real las métricas de rendimiento de un servidor VPS. Incluye gráficos interactivos y estadísticas detalladas sobre CPU, RAM, almacenamiento, tráfico de red, procesos, particiones, servicios y certificados SSL.
- Gráficos en tiempo real de CPU, RAM, Disco y Red utilizando
Chart.js. - Gráficos históricos (día, semana, mes) usando los datos almacenados en SQLite.
- Métricas detalladas, incluyendo:
- Carga del sistema (1, 5, 15 minutos)
- Uptime
- Procesos principales con consumo de CPU y memoria
- Particiones de almacenamiento
- Tráfico de red (RX/TX)
- Servicios del sistema
- Certificados SSL activos
- Logs del sistema
- Protección con autenticación HTTP básica.
- Servidor web: Apache o Nginx.
- PHP: Versión 7.4 o superior.
- Extensiones de PHP necesarias:
shell_exechabilitado para la ejecución de comandos del sistema.
-
Clona este repositorio en el directorio de tu servidor web:
git clone https://github.com/joanmedina/monitor-vps.git
-
Copia el contenido del proyecto al directorio donde estará alojado el dashboard.
-
Configura las credenciales de acceso en el archivo
auth.php. -
Programa la recolección de métricas ejecutando periódicamente
record_metrics.php(por ejemplo, mediantecron). Este script guarda los datos endata/metrics.sqlite. Ejemplo de entrada encrontabpara guardar datos cada 5 minutos:*/5 * * * * /usr/bin/php /ruta/al/proyecto/record_metrics.php
Este proyecto utiliza autenticación HTTP básica para proteger las métricas del servidor. Las credenciales se establecen mediante variables de entorno definidas en el archivo .env.
USUARIO_PERMITIDO=admin
PASSWORD_PERMITIDA=<hash de la contraseña>Para generar un hash compatible puedes ejecutar:
php generate_hash.phpO bien utilizar directamente PHP desde la consola:
php -r "echo password_hash('tu_password', PASSWORD_DEFAULT);"Edita config.php para indicar los servicios que deseas monitorizar.
<?php
return [
'services' => ['apache2', 'mysql']
];monitor-vps/
│
├── assets/
│ ├── css/
│ │ └── styles.css # Hoja de estilos personalizada
│ ├── js/
│ │ └── app.js # Lógica de actualización de métricas
│
├── data/
│ └── metrics.sqlite # Base de datos SQLite con el histórico
│
├── metrics/
│ ├── cpu.php # Métricas de CPU
│ ├── memory.php # Métricas de RAM
│ ├── disk.php # Métricas de disco
│ └── ... # Otros scripts de métricas
│
├── index.php # Página principal del dashboard
├── monitor_data.php # API de datos en formato JSON
├── record_metrics.php # Script para guardar métricas en SQLite
├── historical_data.php # API para consultar datos históricos
├── auth.php # Protección con autenticación HTTP
├── README.md # Documentación del proyecto
El proyecto utiliza varios comandos para obtener métricas del sistema. Algunos ejemplos:
- Carga del sistema:
uptime - Procesos activos:
ps -eo pid,comm,%cpu,%mem --sort=-%cpu | head -n 10 - Espacio en disco:
df -h - Estado de servicios:
systemctl status - Conexiones abiertas:
netstat -tunap
Asegúrate de que el usuario del servidor tenga permisos para ejecutar estos comandos.
El panel requiere autenticación básica y todas las contraseñas se almacenan como hashes utilizando password_hash.
No obstante, muchas métricas se obtienen mediante shell_exec. Ejecuta el servidor web con un usuario sin privilegios y limita el acceso al dashboard.
Para evitar inyección de comandos, la captura del tráfico de red se implementa leyendo directamente /proc/net/dev en lugar de invocar comandos externos.
¡Las contribuciones son bienvenidas! Si tienes ideas para mejorar este dashboard o encuentras un problema, crea un issue o envía un pull request.
Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.