Inicio Rápido para Usuarios
Esta guía te ayudará a comenzar con NoxPanel rápidamente, desde el primer acceso hasta la gestión de tus máquinas virtuales.
Note
El dashboard de usuario muestra los pools asignados y las máquinas virtuales disponibles.
Primer Acceso
Acceder al panel:
Usuario: El asignado por el administrador
Contraseña: La proporcionada por el administrador
Verificar pools asignados:
Al acceder, verás los pools a los que tienes acceso. Si no ves ninguno, contacta con el administrador.
Note
Los pools son grupos de recursos que contienen máquinas virtuales. Tu acceso está limitado a los pools asignados.
Dashboard Principal
El dashboard muestra:
Pools disponibles: Los pools a los que tienes acceso
VMs en tiempo real: Estado actual de las máquinas virtuales
Estadísticas: Uso de recursos y métricas
Acciones rápidas: Botones para operaciones comunes
Note
El dashboard muestra pools disponibles, VMs en tiempo real, estadísticas y acciones rápidas.
Elementos del Dashboard:
Pool Cards: Cada pool muestra: - Nombre y descripción - Número de VMs - Uso de recursos (CPU, memoria, almacenamiento) - Estado general
VM List: Lista de máquinas virtuales con: - Nombre y ID - Estado (Running, Stopped, etc.) - Uso de recursos - Acciones disponibles
Quick Stats: Estadísticas rápidas: - Total de VMs - VMs ejecutándose - Uso total de recursos
Gestión de Máquinas Virtuales
Crear una Nueva VM
Acceder a la creación:
Desde el dashboard: Botón «Crear VM»
Desde un pool específico: Botón «Nueva VM»
Configurar la VM:
Nombre: web-server-01 Pool: development Nodo: pve-cluster-01 Cores: 2 Memoria: 4096 MB Disco: 50 GB Storage: local-lvm
Configuración Cloud-Init (opcional):
Usuario: ubuntu Contraseña: (generada automáticamente) SSH Keys: (opcional) Configuración IP: DHCP
Crear la VM:
Hacer clic en «Crear VM»
Esperar la creación (proceso automático)
Recibir notificación de completado
Note
La creación de VMs puede tomar varios minutos dependiendo del tamaño y configuración.
Controlar VMs
Acciones Disponibles:
Start: Iniciar la VM
Stop: Detener la VM
Restart: Reiniciar la VM
Shutdown: Apagar la VM
Reset: Resetear la VM (forzado)
Ejemplo de uso:
# Ejemplo: Controlar VM desde API
import requests
# Iniciar VM
response = requests.post('/api/vms/100/start/',
headers={'Authorization': 'Bearer token'})
# Verificar estado
status = requests.get('/api/vms/100/status/',
headers={'Authorization': 'Bearer token'})
Acceso a Consola
VNC Console
Acceder a la consola:
Desde la lista de VMs: Botón «Consola VNC»
Desde detalles de VM: Pestaña «Consola»
Configuración VNC:
Puerto: Asignado automáticamente (77-999)
Resolución: Configurable
Teclado: Layout configurable
Usar la consola:
Conexión automática al arrancar
Control completo de la VM
Captura de pantalla disponible
<!-- Ejemplo: Embed VNC Console -->
<iframe src="/vnc/100/"
width="1024"
height="768"
frameborder="0">
</iframe>
Terminal Web
Acceder al terminal:
Botón «Terminal» en la VM
Acceso SSH integrado
Características:
SSH directo: Conexión SSH nativa
Terminal web: Terminal en el navegador
Sesiones múltiples: Múltiples conexiones
Historial: Comandos ejecutados
Gestión de Redes
IP Addresses
Ver IPs asignadas:
Desde el dashboard: Sección «IP Addresses»
Desde detalles de VM: Pestaña «Red»
Solicitar nueva IP:
Ir a «IP Addresses» > «Añadir»
Seleccionar pool de IP
Elegir IP específica o automática
Asignar a VM
# Ejemplo: Asignar IP
from vms.models import IPPool
pool = IPPool.objects.get(name='production-network')
ip_address = pool.allocate_ip(
vm_id=100,
user=request.user
)
Network Configuration
Configuración automática:
DHCP: Configuración automática por defecto
IP estática: Configuración manual
VLAN: Asignación automática según pool
Ejemplo de configuración:
# Cloud-Init network config
network:
version: 2
ethernets:
eth0:
dhcp4: true
dhcp6: false
Monitoreo y Métricas
Métricas en Tiempo Real
Información disponible:
CPU Usage: Porcentaje de uso de CPU
Memory Usage: Uso de memoria RAM
Disk I/O: Actividad de disco
Network Traffic: Tráfico de red
Uptime: Tiempo de funcionamiento
Gráficos:
Note
Las métricas muestran el uso de recursos en tiempo real de las máquinas virtuales.
Alertas y Notificaciones
Uso alto de recursos: Alertas automáticas
VM offline: Notificaciones de estado
Errores de sistema: Alertas de problemas
Completado de tareas: Notificaciones de éxito
Gestión de Permisos
Roles de Usuario
Tipos de roles:
Owner: Control total del pool
Admin: Gestión completa de VMs
User: Crear y controlar VMs
Read-only: Solo visualización
Permisos por rol:
# Ejemplo: Verificar permisos
from vms.models import PoolMembership
membership = PoolMembership.objects.get(
user=request.user,
pool=pool
)
if membership.can_manage_vms():
# Puede crear VMs
pass
if membership.can_control_vms():
# Puede controlar VMs
pass
Acciones Disponibles
Según tu rol, podrás:
Owner/Admin: * Crear, modificar, eliminar VMs * Gestionar usuarios del pool * Configurar recursos * Acceso completo a consola
User: * Crear y controlar VMs * Acceso a consola * Ver métricas
Read-only: * Ver VMs y métricas * Sin acceso a consola * Sin modificaciones
Troubleshooting Básico
Problemas Comunes
VM no inicia:
Verificar recursos disponibles
Comprobar configuración de red
Revisar logs de la VM
Error de consola:
Verificar que la VM esté ejecutándose
Comprobar configuración VNC
Revisar permisos de acceso
Problemas de red:
Verificar asignación de IP
Comprobar configuración VLAN
Revisar configuración DNS
Comandos Útiles
Desde la consola de la VM:
# Verificar estado de red
ip addr show
# Verificar conectividad
ping 8.8.8.8
# Ver uso de recursos
htop
# Ver logs del sistema
journalctl -f
Desde el panel web:
Refresh: Actualizar datos en tiempo real
Logs: Ver logs de la VM
Metrics: Ver métricas detalladas
Console: Acceso directo a consola
Próximos Pasos
Dashboard detallado
Gestión avanzada de VMs
Configuración de redes
Acceso a consola
Troubleshooting
Note
Si necesitas ayuda adicional, contacta con el administrador del sistema o consulta la documentación completa.