Preguntas frecuentes sobre Syspanel: errores y cómo resolverlos

Introducción: ¿Por qué surgen errores en Syspanel?

Syspanel es una herramienta de gestión de hosting muy potente y visual. Sin embargo, como cualquier panel de control, puede presentar algunos problemas típicos, sobre todo cuando se está empezando o se realizan cambios en la configuración del servidor. En esta guía hemos recopilado las preguntas más frecuentes (FAQ) que recibimos en soporte, con sus respectivas soluciones paso a paso. No te preocupes si no eres experto técnico; aquí lo explicamos todo de forma clara y sencilla.

[INFO] Syspanel (antes conocido como HestiaCP) se gestiona a través del puerto 2106. Si en algún momento necesitas acceder al panel, recuerda usar https://tudominio.com:2106 o https://tu-ip:2106.

1. No puedo acceder a Syspanel: pantalla en blanco o error de conexión

Este es uno de los errores más comunes. Puede deberse a varias causas, pero las más habituales son:

1.1. El servicio de Syspanel no está corriendo

A veces, tras un reinicio del servidor o una actualización, el panel se detiene. Para solucionarlo:

Conéctate a tu servidor por SSH (si no sabes cómo, pide ayuda a tu proveedor de hosting).
Ejecuta el siguiente comando para verificar el estado:
```
systemctl status syspanel
```
Si aparece como inactive o failed, reinícialo con:
```
systemctl restart syspanel
```
Espera unos segundos y vuelve a intentar acceder desde el navegador.

[TIP] Si el error persiste, revisa los logs con journalctl -u syspanel -n 50 para ver el motivo exacto.

1.2. Puerto 2106 bloqueado por el firewall

Es posible que el puerto 2106 no esté abierto en tu servidor o en el firewall de tu proveedor de nube.

Accede al panel de control de tu servidor (como DigitalOcean, AWS, etc.).
Busca la sección de "Firewall" o "Grupos de seguridad".
Asegúrate de que el puerto 2106 (TCP) esté permitido para tu IP o para todo el mundo (0.0.0.0/0) si necesitas acceso remoto.
Guarda los cambios y prueba de nuevo.

1.3. Certificado SSL caducado o inválido

Syspanel usa HTTPS por defecto. Si el certificado SSL ha caducado, el navegador puede bloquear la conexión.

Solución temporal: En la mayoría de navegadores puedes hacer clic en "Avanzado" y luego en "Continuar (no seguro)".
Solución definitiva: Renueva el certificado desde Syspanel: ve a Panel de control > Configuración > SSL y sigue los pasos para regenerarlo.

2. Error al crear un nuevo dominio o sitio web

Cuando intentas añadir un dominio y recibes un mensaje de error, normalmente se debe a una de estas razones:

2.1. El dominio ya existe en el sistema

Syspanel no permite duplicados. Verifica si el dominio ya está registrado:

En el menú principal, ve a Web o Sitios web.
Revisa la lista de dominios existentes.
Si aparece, puedes eliminarlo (si ya no lo necesitas) o simplemente acceder a su configuración.

2.2. Falta el registro DNS

Para que un dominio funcione, debe apuntar a tu servidor. Si no has configurado los DNS:

En tu proveedor de dominio (donde lo compraste), crea un registro A que apunte a la IP de tu servidor.
Si usas subdominio, crea un registro CNAME.
Espera de 5 a 30 minutos para que se propague (a veces hasta 24 horas).

[WARNING] No uses Syspanel como gestor DNS si no tienes experiencia. Es más seguro usar los DNS de tu proveedor de dominio o servicios como Cloudflare.

2.3. Permisos de carpeta incorrectos

Al crear un sitio, Syspanel asigna automáticamente los permisos. Si el error dice "no se puede escribir", puedes forzar la corrección desde la terminal:

v-change-sys-permissions

Este comando restablece los permisos de todas las cuentas de usuario.

3. Problemas con el correo electrónico (no llegan correos)

El correo es uno de los servicios que más dolores de cabeza da. Aquí tienes las soluciones a los fallos más comunes:

3.1. Los correos salientes van a la carpeta de spam

Esto suele pasar por falta de registros DNS de autenticación (SPF, DKIM, DMARC).

En Syspanel, ve a Correo > Configuración del dominio.
Busca los registros SPF, DKIM y DMARC que te muestra el panel.
Cópialos exactamente como aparecen y créalos en la zona DNS de tu dominio.
Espera unos minutos y prueba enviando un correo de prueba a una cuenta de Gmail o Outlook.

[INFO] Un registro SPF típico sería algo como: v=spf1 mx a ip4:TU_IP ~all

3.2. No puedo enviar correos (error de conexión SMTP)

Si al enviar un correo desde tu cliente (Outlook, Thunderbird) te da error:

Verifica que los puertos SMTP estén abiertos: 587 (TLS) o 465 (SSL).
En Syspanel, asegúrate de que el servicio Exim esté activo. Puedes revisarlo desde Servicios en el panel.
Si usas un proveedor externo (como Gmail), desactiva temporalmente el firewall del servidor para descartar bloqueos.

3.3. Las cuentas de correo no aparecen en Syspanel

A veces, tras una migración, las cuentas no se listan. Solución:

Ve a Correo > Dominio y haz clic en "Actualizar".
Si sigue sin funcionar, ejecuta en SSH:
```
v-update-mail-domain dominio.com
```
(Reemplaza dominio.com por el tuyo).

4. Error de "503 Service Unavailable" en mis sitios web

Este error significa que el servidor web (Nginx o Apache) no puede procesar la solicitud. Causas frecuentes:

4.1. El servicio web está caído

Desde Syspanel, ve a Servicios y verifica que Nginx y Apache (si usas ambos) estén en verde.
Si están rojos, reinícialos desde el mismo panel o por SSH:
```
systemctl restart nginx
systemctl restart apache2
```

4.2. PHP-FPM se ha detenido

Syspanel usa PHP-FPM para ejecutar código PHP. Si se detiene, los sitios con PHP dan error 503.

Comprueba el estado con:
```
systemctl status php*-fpm
```
(El asterisco depende de la versión, por ejemplo php8.1-fpm).
Reinicia el servicio:
```
systemctl restart php8.1-fpm
```

4.3. Límite de memoria o recursos excedido

Si tu sitio recibe mucho tráfico, puede superar los límites de PHP. Aumenta la memoria desde Syspanel:

Ve a Configuración del servidor > PHP.
Busca memory_limit y cámbialo a un valor mayor (por ejemplo, 256M).
Guarda y reinicia PHP-FPM.

5. No puedo subir archivos por FTP o SFTP

5.1. Usuario o contraseña incorrectos

En Syspanel, ve a Usuarios y selecciona el usuario correspondiente.
Haz clic en "Editar" y restablece la contraseña.
Asegúrate de que el usuario tenga permisos de FTP/SFTP.

5.2. Puerto bloqueado

Para FTP tradicional: puerto 21 (y puertos pasivos 30000-31000).
Para SFTP (recomendado): puerto 22 (SSH).

Abre estos puertos en el firewall de tu servidor.

5.3. Error de "Permiso denegado" al subir archivos

Puede ser que la carpeta de destino no tenga los permisos correctos. Desde SSH, asigna el propietario adecuado:

chown -R usuario:usuario /home/usuario/web/dominio.com/public_html

Reemplaza usuario y dominio.com por los tuyos.

[TIP] Siempre usa SFTP en lugar de FTP tradicional, es más seguro y no requiere configurar puertos adicionales.

6. Error de base de datos MySQL/MariaDB

6.1. No puedo conectar a la base de datos

Verifica que el servicio MySQL esté activo desde Servicios en Syspanel.
Comprueba que el usuario y la contraseña sean correctos. Puedes resetear la contraseña desde Base de datos > Editar.
Si usas un gestor como phpMyAdmin, asegúrate de que esté instalado. Syspanel no lo incluye por defecto, pero puedes instalarlo manualmente.

6.2. Error "Too many connections"

Esto ocurre cuando hay muchas conexiones simultáneas. Aumenta el límite:

Por SSH, edita el archivo de configuración de MySQL:
```
nano /etc/mysql/my.cnf
```
Busca max_connections y cámbialo a un valor mayor (ej. 500).
Guarda y reinicia MySQL:
```
systemctl restart mysql
```

6.3. La base de datos no aparece en Syspanel

Si importaste una base de datos manualmente y no se ve:

Ve a Base de datos y haz clic en "Actualizar".
Si no funciona, desde SSH ejecuta:
```
v-update-databases
```

7. Problemas con SSL/HTTPS (Let's Encrypt)

7.1. El certificado no se renueva automáticamente

Syspanel tiene un cron que renueva los certificados cada 60 días. Si falla:

Verifica que el dominio apunte correctamente al servidor (DNS).
Ejecuta la renovación manual desde el panel: Web > Dominio > SSL > Renovar.
Si sigue fallando, revisa los logs en /var/log/syspanel/ para ver el error concreto.

7.2. Error "No se puede obtener el certificado"

Esto suele deberse a que el puerto 80 está bloqueado. Let's Encrypt necesita verificar el dominio a través de HTTP.

Abre el puerto 80 en el firewall.
Asegúrate de que no haya un proxy o CDN que impida la verificación (desactiva Cloudflare temporalmente).

8. Consejos finales para evitar errores en Syspanel

Mantén el panel actualizado: Ve a Panel de control > Actualizaciones e instala las últimas versiones.
Haz copias de seguridad periódicas: Syspanel permite programar backups desde Configuración > Backup.
No modifiques archivos de configuración manualmente a menos que sepas lo que haces. Un error puede dejar el panel inaccesible.
Si algo falla, revisa los logs. Los encontrarás en /var/log/syspanel/ y son tu mejor aliado para diagnosticar.

[WARNING] Si después de seguir todos estos pasos el problema persiste, contacta con tu proveedor de hosting o con el equipo de soporte de Syspanel. No intentes soluciones extremas como reinstalar el panel sin antes hacer una copia de seguridad completa.

Esperamos que esta FAQ te haya sido de ayuda. Recuerda que Syspanel es una herramienta robusta, pero como cualquier sistema, requiere mantenimiento y atención. ¡No te desanimes! Con práctica, resolver estos errores se volverá algo rutinario.