Errores comunes en Syspanel | FAQ y soluciones

¿Te has encontrado con un mensaje de error inesperado en tu Syspanel y no sabes por dónde empezar? No te preocupes. Es completamente normal. Al ser una herramienta potente y llena de funciones, a veces pueden surgir pequeños contratiempos. Esta guía está diseñada para ser tu primer punto de apoyo. Aquí resolvemos las preguntas más frecuentes (FAQ) sobre los errores más comunes en Syspanel, explicados de forma sencilla para que puedas solucionarlos tú mismo.

Piensa en este artículo como tu manual de primeros auxilios para el panel de control. Vamos paso a paso, con un lenguaje claro y amigable. Si sigues estas pautas, en la mayoría de los casos podrás recuperar el control de tu servidor en minutos.

¿Qué es Syspanel y por qué a veces falla?

Syspanel es el nombre que le damos a tu panel de control de hosting, basado en la tecnología de HestiaCP. Es la interfaz que te permite gestionar tus sitios web, cuentas de correo, bases de datos y archivos desde un solo lugar. Accedes a él normalmente a través de tu navegador, usando la dirección de tu servidor seguida del puerto 2106 (por ejemplo: https://tudominio.com:2106).

Como cualquier software, puede tener pequeños errores. Las causas más habituales suelen ser:

Configuraciones recientes: Un cambio en un archivo, una regla de firewall o un ajuste en PHP.
Falta de recursos: El servidor se queda sin espacio en disco o memoria RAM.
Certificados SSL caducados: Especialmente el del propio panel.
Problemas de red o DNS: El servidor no puede comunicarse correctamente.

FAQ: Preguntas Frecuentes y Soluciones Paso a Paso

Aquí tienes las dudas más comunes que recibimos. Busca la que se parezca a tu problema y sigue los pasos.

1. No puedo acceder a Syspanel (Error de conexión o página en blanco)

Este es, con diferencia, el error más común. Ves la pantalla de carga y luego nada, o te aparece un mensaje como "Esta página no está funcionando".

¿Por qué ocurre? Normalmente es por un problema de firewall, un certificado SSL caducado o porque el servicio del panel se ha detenido.

¿Cómo lo soluciono? Sigue estos pasos en orden:

Verifica la URL y el puerto: Asegúrate de estar escribiendo bien la dirección. Debe ser https:// (no http://) seguido de la IP o dominio de tu servidor, dos puntos y el puerto 2106. Ejemplo correcto: https://192.168.1.100:2106 o https://mipanel.com:2106.
Comprueba el servicio del panel desde SSH: Si tienes acceso por terminal (SSH), este es el paso más efectivo. Conéctate a tu servidor y ejecuta:
```
sudo systemctl status syspanel
```
(Nota: aunque lo llamamos Syspanel, internamente el servicio puede llamarse hestia o hestia-nginx. Si el comando de arriba no funciona, prueba con sudo systemctl status hestia).
- Si ves "active (running)": El servicio está bien. El problema es de red o certificado.
- Si ves "inactive (dead)" o "failed": El servicio se ha detenido. Reinícialo con:
```
sudo systemctl restart syspanel
```
  (o sudo systemctl restart hestia).
Revisa el firewall (UFW o iptables): Es posible que el puerto 2106 esté bloqueado. Desde SSH, comprueba las reglas:
```
sudo ufw status
```
Si no ves una línea que diga 2106/tcp ALLOW, debes permitirlo:
```
sudo ufw allow 2106/tcp
```
Renueva el certificado SSL del panel: A veces el certificado caduca y el navegador bloquea la conexión. Desde SSH, ejecuta:
```
sudo /usr/local/hestia/bin/v-update-letsencrypt-ssl
```
Luego, reinicia el panel con el comando del paso 2.

[TIP] Si después de todo esto sigues sin poder acceder, prueba a hacerlo desde otro navegador o desde una red diferente (por ejemplo, desde los datos móviles de tu teléfono). A veces es un problema de caché local.

2. Error "502 Bad Gateway" o "504 Gateway Time-out"

Este error es muy frustrante porque aparece de repente mientras trabajas. Significa que el servidor web (Nginx) no puede comunicarse con el servicio de aplicaciones (PHP-FPM).

Causas comunes: Un script PHP que se ha colgado, falta de memoria o una configuración incorrecta de PHP.

Soluciones prácticas:

Reinicia PHP-FPM: Es la solución más rápida y efectiva. Desde SSH, ejecuta uno de estos comandos (dependiendo de la versión de PHP que uses):
```
sudo systemctl restart php8.2-fpm   # Para PHP 8.2
sudo systemctl restart php8.1-fpm   # Para PHP 8.1
sudo systemctl restart php7.4-fpm   # Para PHP 7.4
```
Si no sabes qué versión tienes, puedes listarlas con ls /etc/php/.
Aumenta la memoria de PHP: Si el error persiste, tu script necesita más memoria. Edita el archivo de configuración de PHP para tu sitio:
```
sudo nano /etc/php/8.2/fpm/php.ini   # Cambia 8.2 por tu versión
```
Busca la línea memory_limit y cámbiala a un valor más alto, por ejemplo de 128M a 256M o 512M. Guarda (Ctrl+O, luego Enter) y sal (Ctrl+X). Luego, reinicia PHP-FPM con el comando del paso 1.
Verifica el espacio en disco: Un disco lleno puede provocar timeouts. Ejecuta:
```
df -h
```
Si ves que alguna partición (como / o /home) está al 100%, necesitas liberar espacio (borrar logs, backups antiguos, etc.).

[WARNING] No aumentes la memoria de PHP sin control. Un valor demasiado alto puede agotar la RAM del servidor. Empieza con el doble del valor actual.

3. No puedo crear cuentas de correo o el correo no se envía/recibe

Los problemas de correo son muy comunes y suelen deberse a la configuración de DNS o a la autenticación.

Preguntas frecuentes sobre correo:

¿Por qué recibo el error "Authentication failed" al configurar mi cliente de correo (Outlook, Thunderbird)?

Solución: Revisa tu nombre de usuario y contraseña. El nombre de usuario debe ser el correo electrónico completo (ej: tucorreo@tudominio.com), no solo la parte de antes de la arroba. Además, asegúrate de que tu cliente de correo esté configurado para usar SSL/TLS en los puertos correctos (993 para IMAP, 995 para POP3, 465 para SMTP).

¿Por qué mis correos enviados desde Syspanel no llegan a Gmail o Hotmail?

Causa: Lo más probable es que a tu servidor le falten registros DNS de correo (registros MX, SPF, DKIM, DMARC).
Solución desde Syspanel:
1. Ve a tu dominio en Syspanel.
2. Busca la sección de Registros DNS.
3. Asegúrate de que existan los registros que Syspanel te sugiere automáticamente. Si no están, agrégalos manualmente. Los más importantes son:
  - MX: Apunta a mail.tudominio.com.
  - SPF: Un registro TXT que autoriza a tu servidor a enviar correo.
  - DKIM: Otro registro TXT que firma digitalmente tus correos.
4. Una vez añadidos, espera de 1 a 24 horas para que se propaguen.

[INFO] Syspanel configura automáticamente estos registros DNS si gestionas los DNS desde el propio panel. Si usas DNS externos (como Cloudflare), debes copiar manualmente los valores que te da Syspanel.

4. Error al subir archivos o instalar WordPress: "Tamaño máximo de archivo excedido"

Subes un tema, un plugin o un backup y el panel te dice que el archivo es demasiado grande.

¿Cómo aumento el límite?

Desde la configuración de Syspanel (más fácil): En la interfaz de Syspanel, ve a la configuración de tu plan o paquete de hosting. Busca la opción "Límite de subida de archivos" y ajústalo (por ejemplo, a 128M o 256M).
Desde SSH (más directo): Edita el archivo php.ini de la versión de PHP que uses tu sitio (como vimos en el error 502):
```
sudo nano /etc/php/8.2/fpm/php.ini
```
Busca y modifica estas tres líneas:
- upload_max_filesize = 128M (cambia el valor)
- post_max_size = 130M (debe ser un poco mayor que upload_max_filesize)
- max_execution_time = 300 (aumenta los segundos para que no se agote el tiempo)
  Guarda, cierra y reinicia PHP-FPM.

5. El panel se ve extraño o los botones no funcionan (Problemas de CSS/JavaScript)

A veces, al cargar Syspanel, ves los textos pero sin estilos visuales, o los botones no responden al hacer clic.

Causa: Casi siempre es un problema de caché del navegador o de un plugin bloqueador de scripts (como uBlock Origin).

Solución rápida:

Limpia la caché del navegador: En Chrome, ve a Configuración > Privacidad y seguridad > Borrar datos de navegación. Marca "Archivos e imágenes en caché" y borra. Luego, recarga la página (F5 o Ctrl+R).
Desactiva temporalmente los bloqueadores: Si usas extensiones como uBlock Origin o Privacy Badger, desactívalas para la página de Syspanel.
Usa el modo incógnito: Abre una ventana de incógnito en tu navegador. Si el panel se ve bien ahí, el problema es definitivamente de caché o extensiones.

Consejos Finales para Evitar Errores en Syspanel

Para terminar, aquí tienes tres hábitos que te ahorrarán muchos dolores de cabeza:

Mantén todo actualizado: Syspanel y el sistema operativo del servidor reciben actualizaciones de seguridad y rendimiento. Revisa periódicamente si hay actualizaciones disponibles desde el propio panel o vía SSH (sudo apt update && sudo apt upgrade).
Haz backups regulares: Antes de hacer cualquier cambio importante (actualizar PHP, modificar configuraciones), genera un backup completo desde Syspanel. Es tu red de seguridad.
No modifiques archivos del sistema a menos que sepas lo que haces: Syspanel gestiona muchas configuraciones automáticamente. Editar a mano archivos como /etc/nginx/conf.d/ puede romper el panel. Si tienes dudas, siempre es mejor preguntar.

[WARNING] Si después de seguir todos estos pasos el error persiste, no intentes más arreglos "caseros". Algunos errores requieren intervención a nivel de servidor. En ese caso, contacta con nuestro equipo de soporte técnico indicando exactamente el error que ves y los pasos que ya has intentado. Te ayudaremos encantados.

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que Syspanel está diseñado para ser intuitivo, y la mayoría de los problemas tienen una solución sencilla. ¡No te rindas!