FAQ Syspanel: errores comunes y cómo solucionarlos | Ayuda rápida

Introducción: ¿Qué es Syspanel y por qué aparecen errores?

Syspanel (basado en el conocido HestiaCP, accesible por defecto en el puerto 2106) es un panel de control de hosting gratuito y de código abierto. Permite gestionar sitios web, bases de datos, cuentas de correo, DNS y mucho más desde una interfaz web. Es una herramienta potente, pero como cualquier software, pueden surgir errores, especialmente si estás empezando.

No te preocupes. La mayoría de los problemas comunes tienen soluciones sencillas que puedes aplicar tú mismo. Este artículo es una FAQ (Preguntas Frecuentes) diseñada para guiarte paso a paso. Al final, serás capaz de resolver los errores más típicos en Syspanel.

Sección 1: Errores de acceso y conexión al panel

### 1.1. No puedo acceder a Syspanel: la página no carga o da error "Conexión rechazada"

Este es, con diferencia, el error más común. Si al escribir https://tu-ip-o-dominio:2106 ves un mensaje de "conexión rechazada" o la página no carga, sigue estos pasos:

Paso 1: Verifica que el servicio esté activo
Accede a tu servidor por SSH (si no sabes cómo, contacta a tu proveedor). Una vez dentro, ejecuta:

systemctl status hestia

Si ves Active: inactive (dead) significa que el servicio está detenido. Para iniciarlo:

systemctl start hestia

Para que se inicie automáticamente al reiniciar el servidor:

systemctl enable hestia

Paso 2: Comprueba el firewall (UFW o iptables)
Syspanel usa el puerto 2106. Si tu firewall lo bloquea, no podrás acceder. Para abrirlo con UFW (el más común en Ubuntu/Debian):

ufw allow 2106

Luego recarga el firewall:

ufw reload

Paso 3: Revisa si el puerto está en uso por otro servicio
A veces otro programa ocupa el puerto. Verifica con:

netstat -tulpn | grep 2106

Si ves otro proceso, deberás detenerlo o cambiar el puerto de Syspanel (esto último es más avanzado).

[TIP] Si usas un VPS, asegúrate también de que el puerto 2106 esté abierto en las reglas de seguridad de tu proveedor (como el Security Group de AWS o el Firewall de DigitalOcean).

### 1.2. Error "403 Forbidden" al acceder a Syspanel

Esto suele deberse a que tu dirección IP no está en la lista blanca de Syspanel. Por defecto, el panel solo permite acceso desde ciertas IPs.

Solución: Agregar tu IP a la lista blanca

Conéctate por SSH a tu servidor.

Edita el archivo de configuración:

nano /usr/local/hestia/conf/hestia.conf

Busca la línea que dice ALLOWED_IP='' y agrega tu IP entre las comillas. Si tienes IP dinámica, puedes poner 0.0.0.0/0 para permitir todas (no recomendado por seguridad, pero útil para pruebas).
Guarda (Ctrl+O, luego Enter) y sal (Ctrl+X).
Reinicia el servicio:
```
systemctl restart hestia
```

[WARNING] Permitir todas las IPs (0.0.0.0/0) es un riesgo de seguridad. Úsalo solo temporalmente y luego restringe el acceso.

Sección 2: Errores al crear o gestionar sitios web

### 2.1. Al crear un sitio web, aparece "Domain already exists" (El dominio ya existe)

Syspanel es estricto con los nombres de dominio. Si ves este error, puede ser que:

Ya hayas creado ese dominio antes (incluso si lo borraste, queda un registro).
El dominio esté en la lista de "dominios reservados" del sistema.

Soluciones:

Verifica en la lista de sitios web: Ve a "Web" en el panel y asegúrate de que no esté listado.
Limpia la caché de DNS del panel: A veces queda un registro fantasma. Desde SSH ejecuta:
```
/usr/local/hestia/bin/v-delete-web-domain admin midominio.com
```
(Reemplaza admin por tu usuario y midominio.com por el dominio problemático).
Usa un subdominio diferente: Si el dominio principal está bloqueado, prueba con www.midominio.com o blog.midominio.com.

### 2.2. El sitio web se ve en blanco o da error 500 Internal Server Error

Un error 500 significa que algo falló en el servidor, pero no siempre da detalles. Las causas más comunes son:

Archivos PHP con errores de sintaxis.
Permisos incorrectos en archivos o carpetas.
Falta de memoria o recursos.

Solución paso a paso:

Revisa los logs de errores: En Syspanel, ve a "Web" > haz clic en el dominio > "Logs". Busca el archivo error.log. Allí verás la causa exacta (por ejemplo, "Parse error: syntax error...").
Corrige los permisos: Desde SSH, navega a la carpeta del sitio (normalmente en /home/usuario/web/midominio/public_html) y ejecuta:
```
find . -type d -exec chmod 755 {} \;
find . -type f -exec chmod 644 {} \;
```
Aumenta el límite de memoria PHP: Si el error es por agotamiento de memoria, edita el archivo php.ini del dominio (lo encuentras en la sección "Advanced" del dominio en Syspanel) y aumenta memory_limit a 256M o 512M.

[INFO] Si el error persiste, prueba a desactivar plugins o temas uno por uno si usas WordPress. A menudo, un plugin incompatible es el culpable.

Sección 3: Errores con bases de datos (MySQL/MariaDB)

### 3.1. No puedo conectar a la base de datos: "Access denied for user"

Este error es típico cuando las credenciales son incorrectas o el usuario no tiene permisos.

Soluciones:

Verifica usuario y contraseña: En Syspanel, ve a "Base de datos" y revisa que el usuario y la contraseña sean exactamente los que estás usando. Copia y pega para evitar errores tipográficos.
Recrea el usuario de la base de datos: A veces es más rápido borrar el usuario y crearlo de nuevo desde el panel.

Concede permisos manualmente (avanzado): Si el problema persiste, desde SSH ejecuta:

mysql -u root -p
GRANT ALL PRIVILEGES ON nombre_base.* TO 'usuario'@'localhost' IDENTIFIED BY 'contraseña';
FLUSH PRIVILEGES;
EXIT;

### 3.2. Error "Too many connections" (Demasiadas conexiones)

Esto ocurre cuando tu sitio web o aplicación abre muchas conexiones a la base de datos y supera el límite.

Solución: Aumentar el límite de conexiones

Accede a MySQL desde SSH:
```
mysql -u root -p
```
Verifica el límite actual:
```
SHOW VARIABLES LIKE 'max_connections';
```
Auméntalo temporalmente (para pruebas):
```
SET GLOBAL max_connections = 500;
```
Para hacerlo permanente, edita el archivo /etc/mysql/my.cnf o /etc/my.cnf y agrega o modifica la línea:
```
max_connections = 500
```
Reinicia MySQL:
```
systemctl restart mysql
```

[WARNING] No aumentes el límite excesivamente, ya que cada conexión consume memoria. 500 es un valor seguro para la mayoría de los VPS.

Sección 4: Errores de correo electrónico

### 4.1. No puedo enviar o recibir correos (SMTP/POP3)

Si configuraste una cuenta de correo en Syspanel pero no funciona, revisa:

Paso 1: Verifica los registros DNS
Tu dominio debe tener registros MX correctos. Desde el panel de DNS de tu dominio, asegúrate de que apunte a la IP de tu servidor. Por ejemplo:

mail.midominio.com. IN A    IP_DEL_SERVIDOR
midominio.com.     IN MX 10 mail.midominio.com.

Paso 2: Comprueba que el servicio de correo esté activo
Desde SSH:

systemctl status exim4   # Para envío (SMTP)
systemctl status dovecot # Para recepción (POP3/IMAP)

Si están detenidos, inícialos:

systemctl start exim4
systemctl start dovecot

Paso 3: Revisa los logs de correo
Los errores suelen quedar registrados en /var/log/mail.log o /var/log/exim4/mainlog. Busca palabras como "rejected" o "failed".

### 4.2. Los correos enviados van a la carpeta de Spam

Esto es común cuando el servidor no tiene configurado correctamente SPF, DKIM o DMARC.

Solución desde Syspanel:

Ve a "Correo" > selecciona tu dominio.
Busca la sección "Registros DNS" y activa las opciones de SPF y DKIM.
Syspanel te generará los registros que debes agregar a tu zona DNS.
Copia esos registros y pégalos en el panel de DNS de tu dominio.

[TIP] La configuración de DKIM es especialmente importante para que Gmail, Outlook y otros no marquen tus correos como spam.

Sección 5: Errores generales y de rendimiento

### 5.1. Syspanel está muy lento o no responde

La lentitud puede deberse a falta de recursos (RAM, CPU) o a un proceso colgado.

Diagnóstico rápido:

Desde SSH, ejecuta htop para ver el uso de recursos. Si ves procesos zombies o uso de CPU al 100%, identifica el proceso culpable.

Reinicia los servicios de Syspanel:

systemctl restart hestia
systemctl restart nginx   # Si usas Nginx
systemctl restart apache2 # Si usas Apache

Limpia la caché del panel: A veces los archivos temporales se acumulan. Ejecuta:

/usr/local/hestia/bin/v-update-sys-queue disk
/usr/local/hestia/bin/v-update-sys-queue traffic

### 5.2. Error "Out of memory" (Falta de memoria) al instalar algo

Si tu servidor tiene poca RAM (por ejemplo, 512 MB), al instalar WordPress o módulos grandes puede fallar.

Solución: Crear un archivo de swap
El swap es como una memoria RAM virtual en el disco duro.

Desde SSH, crea un archivo de swap de 1 GB:

fallocate -l 1G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile

Hazlo permanente agregando esta línea al archivo /etc/fstab:
```
/swapfile none swap sw 0 0
```

[INFO] Con 1 GB de swap adicional, podrás manejar mejor picos de memoria. No es tan rápido como la RAM real, pero evita errores fatales.

Conclusión: Syspanel es confiable si sabes cómo solucionar los problemas

Como has visto, la mayoría de los errores en Syspanel tienen soluciones claras y accesibles. Desde problemas de conexión hasta bases de datos o correo, con unos pocos comandos y verificaciones puedes resolverlos tú mismo.

Recuerda:

Siempre revisa los logs (en /var/log/ o dentro del panel).
Mantén actualizado tu Syspanel (desde SSH: apt update && apt upgrade).
No temas a la línea de comandos: es tu mejor aliada para diagnósticos rápidos.

Si este FAQ te ha sido útil, compártelo con otros usuarios. Y si tienes un error que no aparece aquí, ¡escríbelo en los comentarios! Estaremos encantados de ampliar esta guía.

[TIP FINAL] Antes de hacer cambios importantes, siempre crea una copia de seguridad desde Syspanel (Backup > New Backup). ¡Nunca sabes cuándo la necesitarás!