Preguntas frecuentes sobre Syspanel | FAQ SysAdmin

Introducción

Como administrador de sistemas o usuario de hosting, es probable que te hayas encontrado con algún contratiempo al usar Syspanel. No te preocupes, es completamente normal. Syspanel es una herramienta potente para gestionar sitios web, bases de datos, cuentas de correo y más, pero como cualquier software, puede presentar algunos problemas comunes. En esta guía, vamos a resolver las dudas más frecuentes que recibimos en soporte técnico, con soluciones paso a paso que cualquier persona, incluso sin experiencia técnica avanzada, puede seguir.

Esta Syspanel FAQ está diseñada para ayudarte a solucionar problemas típicos sin necesidad de llamar a soporte. Si sigues estos pasos, resolverás la mayoría de los incidentes en minutos. Recuerda que Syspanel es la interfaz moderna que utilizamos para administrar servidores, y su acceso principal es a través del puerto 2106 (por ejemplo, https://tudominio.com:2106).

[INFO] Si en algún momento te sientes perdido, respira hondo. Todos los pasos están escritos para que los entiendas aunque no seas un experto en Linux. ¡Vamos allá!

Problemas de acceso a Syspanel

No puedo iniciar sesión en Syspanel

Este es, sin duda, el problema más común. Si al intentar acceder a https://tudominio.com:2106 no te deja entrar, puede deberse a varias causas. Vamos a revisarlas una por una.

Posibles causas y soluciones:

Credenciales incorrectas: Asegúrate de que estás usando el usuario y contraseña correctos. El usuario suele ser admin o el que configuraste al instalar. Si no lo recuerdas, puedes resetear la contraseña desde la terminal del servidor (si tienes acceso SSH). Ejecuta:
```
sudo v-change-syspanel-password admin nueva_contraseña
```
Esto cambiará la contraseña del usuario admin inmediatamente.
Puerto bloqueado por firewall: Es posible que el puerto 2106 no esté abierto en tu servidor. Para verificarlo, desde la terminal escribe:
```
sudo ufw status
```
Si no ves 2106/tcp en la lista, agrégalo con:
```
sudo ufw allow 2106/tcp
```
Servicio de Syspanel caído: A veces el panel se detiene. Reinícialo con:
```
sudo systemctl restart syspanel
```
Problema de certificado SSL: Si tu navegador te muestra un error de seguridad, es normal si usas un certificado autofirmado. Simplemente haz clic en "Avanzado" y "Continuar". Si el error persiste, verifica que el servicio esté usando el puerto correcto.

[WARNING] No compartas nunca tus credenciales de Syspanel. Si necesitas dar acceso a otra persona, crea un usuario secundario desde el panel.

La página de inicio de sesión no carga

Si ves un error de conexión o la página se queda en blanco, prueba esto:

Verifica que el servidor esté encendido: Parece obvio, pero a veces el problema es que el servidor se ha apagado o reiniciado. Accede por SSH y ejecuta uptime para confirmar.
Comprueba el servicio web: Syspanel depende de Nginx o Apache. Asegúrate de que estén funcionando:
```
sudo systemctl status nginx
```
Si está inactivo, reinícialo:
```
sudo systemctl restart nginx
```
Revisa los logs de Syspanel: Los errores suelen quedar registrados. Ejecuta:
```
sudo tail -f /var/log/syspanel/error.log
```
Esto te mostrará las últimas líneas de error. Si ves algo como "address already in use", significa que otro proceso está ocupando el puerto 2106. Cambia el puerto en la configuración (archivo /etc/syspanel/conf.d/port.conf).

Problemas con sitios web

Mi sitio web muestra error 503 o 502

Estos errores indican que el servidor web no puede procesar la solicitud. Generalmente se solucionan así:

Reinicia los servicios web:

sudo systemctl restart nginx
sudo systemctl restart php7.4-fpm  # Ajusta la versión de PHP según tu configuración

Verifica la memoria del servidor: Si el servidor se queda sin RAM, los sitios pueden fallar. Usa free -h para ver el uso de memoria. Si está al 90% o más, considera actualizar el plan de hosting o optimizar el sitio.
Comprueba los logs de error del sitio: Desde Syspanel, ve a la sección "Web" y haz clic en "Logs" del dominio afectado. Busca errores como "PHP Fatal error" o "Connection refused".

[TIP] Si el error 503 aparece después de instalar un plugin o hacer un cambio, revierte la modificación. A menudo, un plugin incompatible es el culpable.

No puedo agregar un nuevo dominio

Si al intentar añadir un dominio desde Syspanel te da error, sigue estos pasos:

Verifica que el dominio no esté ya registrado: A veces lo añadiste antes y lo olvidaste. Revisa la lista de dominios en Syspanel.
Comprueba los DNS: El dominio debe apuntar a la IP de tu servidor. Usa una herramienta como dig o nslookup para confirmar.
Espacio en disco: Si el disco está lleno, no podrás crear nuevos sitios. Ejecuta df -h para ver el uso. Si está al 100%, libera espacio eliminando logs viejos o archivos temporales.
Límite de cuentas: Algunos planes de Syspanel tienen un límite de sitios. Revisa tu plan desde el panel.

Problemas con bases de datos

No puedo conectar a la base de datos desde mi aplicación

Este es un error típico al configurar WordPress, Joomla u otros CMS. La solución es sencilla:

Verifica las credenciales: Desde Syspanel, ve a "Base de datos" y copia exactamente el usuario, contraseña y nombre de la BD. Asegúrate de no tener espacios adicionales.
Comprueba el host de la base de datos: Normalmente es localhost. Si tu aplicación está en otro servidor, deberás usar la IP del servidor de Syspanel y abrir el puerto 3306 en el firewall:
```
sudo ufw allow 3306/tcp
```
[WARNING] Abrir el puerto 3306 a internet es riesgoso. Solo hazlo si es estrictamente necesario y usa contraseñas seguras.
Reinicia el servicio MySQL/MariaDB:
```
sudo systemctl restart mysql
```

Error "Too many connections"

Si ves este error, es porque el límite de conexiones a la base de datos se ha alcanzado. Para solucionarlo:

Aumenta el límite temporalmente: Edita el archivo /etc/mysql/my.cnf y busca la línea max_connections. Cámbiala a un número mayor (ej. 200) y reinicia MySQL.
Optimiza las consultas: Si tu sitio tiene mucho tráfico, considera usar un plugin de caché o revisar las consultas lentas. Desde Syspanel, puedes activar el log de consultas lentas en la configuración de MySQL.

Problemas con el correo electrónico

No recibo correos en mi cuenta de Syspanel

Este problema suele deberse a la configuración DNS o a filtros de spam. Sigue estos pasos:

Verifica los registros MX: Desde Syspanel, ve a "DNS" del dominio y asegúrate de que el registro MX apunte a tu servidor (por ejemplo, mail.tudominio.com).
Revisa la carpeta de spam: A veces los correos llegan ahí. Si usas un cliente como Roundcube, mira en "Spam".
Comprueba el servicio de correo: Ejecuta:
```
sudo systemctl status dovecot
sudo systemctl status postfix
```
Si alguno está caído, reinícialo.
Prueba el envío: Envía un correo desde otra cuenta y revisa los logs:
```
sudo tail -f /var/log/mail.log
```

[TIP] Si el problema persiste, añade una regla SPF en los registros DNS del dominio para mejorar la entregabilidad.

Error al enviar correos: "Relay access denied"

Esto significa que el servidor no permite enviar correos sin autenticación. Asegúrate de que tu cliente de correo (Outlook, Thunderbird) tenga marcada la opción "Requerir autenticación" y que uses el puerto correcto (587 con STARTTLS o 465 con SSL).

Problemas de rendimiento y seguridad

Syspanel está muy lento

Si el panel tarda en cargar, puede deberse a:

Alto consumo de recursos: Revisa el uso de CPU y RAM con top o htop. Si un proceso consume mucho, identifícalo y detenlo.
Caché del navegador: Limpia la caché de tu navegador o prueba en modo incógnito.
Actualiza Syspanel: Las versiones antiguas pueden tener bugs de rendimiento. Desde la terminal:
```
sudo apt update && sudo apt upgrade syspanel
```

He recibido un aviso de seguridad, ¿qué hago?

Si Syspanel te notifica de un intento de acceso no autorizado, actúa rápido:

Cambia todas las contraseñas: La de Syspanel, FTP, bases de datos y correo.
Revisa los logs de acceso: En /var/log/syspanel/auth.log busca IPs sospechosas.
Bloquea IPs: Usa el firewall para bloquear direcciones específicas:
```
sudo ufw deny from IP_SOSPECHOSA
```
Activa la autenticación de dos factores (2FA): Syspanel permite añadir 2FA desde la configuración de usuario. Esto añade una capa extra de seguridad.

Preguntas frecuentes adicionales (SysAdmin preguntas frecuentes)

¿Cómo hago una copia de seguridad de todo mi Syspanel?

Desde el panel, ve a "Backup" y selecciona los elementos que quieras respaldar. También puedes hacerlo desde la terminal:

sudo v-backup-user admin

Esto creará un archivo comprimido en /backup/. Descárgalo a tu ordenador para tenerlo seguro.

¿Puedo cambiar el puerto de acceso a Syspanel?

Sí, pero no es recomendable a menos que sepas lo que haces. Edita el archivo /etc/syspanel/conf.d/port.conf y cambia el número. Luego reinicia el servicio:

sudo systemctl restart syspanel

Recuerda abrir el nuevo puerto en el firewall.

¿Qué hago si olvido la contraseña de root del servidor?

Si tienes acceso a Syspanel, puedes resetearla desde el panel (en la sección "Servidor"). Si no, necesitarás acceso físico o a través del proveedor de hosting para reiniciar el servidor en modo recovery.

Conclusión

Esperamos que esta Syspanel FAQ te haya sido de gran ayuda. Recuerda que la mayoría de los problemas comunes tienen soluciones sencillas que puedes aplicar tú mismo. Si después de seguir estos pasos el problema persiste, no dudes en contactar a nuestro equipo de soporte técnico. Estamos aquí para ayudarte.

[INFO] Guarda esta guía en tus favoritos. La próxima vez que tengas un problema Syspanel, ya sabes dónde mirar primero. ¡Buena suerte con tu servidor!