Problemas comunes en Syspanel: Preguntas frecuentes y soluciones

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

Syspanel es un panel de control potente y ligero, pero como cualquier herramienta técnica, puede presentar algunos inconvenientes. No te preocupes: la mayoría de los problemas tienen una solución sencilla que puedes aplicar tú mismo. Este FAQ recoge las dudas más frecuentes que recibimos en soporte y te guía paso a paso para resolverlas.

Syspanel problemas suelen deberse a configuraciones incorrectas, servicios detenidos o permisos mal establecidos. Aquí te explicamos cómo diagnosticarlos y solucionarlos de forma clara y rápida.

1. No puedo acceder al panel de control Syspanel

1.1. ¿Está el servicio corriendo?

Lo primero es verificar que el servicio principal de Syspanel esté activo. Accede por SSH a tu servidor y ejecuta:

systemctl status syspanel

Si ves que está inactivo o ha fallado, reinícialo:

systemctl restart syspanel

1.2. ¿Estoy usando el puerto correcto?

Recuerda que Syspanel se sirve a través del puerto 2106. Asegúrate de escribir en tu navegador:

https://tu-dominio-o-ip:2106

[WARNING] Si usas HTTP sin SSL, el navegador puede bloquear la conexión. Siempre usa HTTPS.

1.3. ¿El firewall bloquea el puerto 2106?

En servidores con UFW o iptables, el puerto 2106 debe estar abierto. Para UFW:

sudo ufw allow 2106/tcp

Si usas iptables, añade una regla similar. Luego verifica con ufw status o iptables -L.

1.4. ¿El certificado SSL es válido?

Si tu certificado ha expirado o es autofirmado, el navegador te mostrará un error. Puedes renovarlo desde el propio Syspanel en Configuración > SSL o forzar la conexión aceptando el riesgo (solo para pruebas).

2. Error de conexión a la base de datos

2.1. Servicio MySQL/MariaDB detenido

Uno de los errores Syspanel más comunes es que el servicio de base de datos no esté funcionando. Verifica con:

systemctl status mysql

Si está detenido, inícialo:

systemctl start mysql

2.2. Credenciales incorrectas

Asegúrate de que las credenciales de la base de datos en el archivo de configuración de Syspanel sean correctas. Normalmente se encuentran en:

/usr/local/syspanel/conf/database.php

Revisa usuario, contraseña y nombre de la base de datos.

2.3. Espacio en disco insuficiente

Si el disco está lleno, la base de datos puede fallar. Verifica con:

df -h

Si alguna partición está al 100%, libera espacio eliminando logs o archivos temporales.

[TIP] Programa una limpieza automática de logs con cron para evitar esto.

3. No puedo crear o modificar sitios web

3.1. Permisos de directorio incorrectos

Cada sitio web necesita que su carpeta public_html tenga permisos adecuados. Desde Syspanel, puedes asignar el usuario correcto. En caso de error, desde SSH:

chown -R usuario:usuario /home/usuario/web/tudominio/public_html
chmod 755 /home/usuario/web/tudominio/public_html

3.2. DNS no propagado

Si acabas de crear un dominio, espera de 5 a 30 minutos para que los DNS se propaguen. Puedes verificar con herramientas online como whatsmydns.net.

3.3. Límite de sitios alcanzado

Syspanel tiene un límite por defecto de sitios por usuario. Revisa en Usuarios > Editar si has llegado al tope. Puedes aumentarlo desde la configuración del administrador.

4. El correo no se envía o no se recibe

4.1. Servicio de correo detenido

El servicio Exim o Dovecot debe estar activo. Verifica:

systemctl status exim4
systemctl status dovecot

Si están detenidos, reinícialos:

systemctl restart exim4 dovecot

4.2. Registros SPF, DKIM y DMARC

Para que tus correos no vayan a spam, configura los registros DNS adecuados. Syspanel los genera automáticamente en la sección Correo > Registros DNS. Solo debes copiarlos a tu zona DNS.

4.3. Cola de correo atascada

A veces los correos se quedan en cola. Vacíala con:

exim -bp | exim -Mrm

O desde Syspanel, en Correo > Cola, puedes eliminar mensajes manualmente.

[INFO] Si el problema persiste, revisa los logs en /var/log/exim4/mainlog.

5. Problemas con FTP/SFTP

5.1. Conexión rechazada

Asegúrate de que el servicio FTP (vsftpd o proftpd) esté activo:

systemctl status vsftpd

Si no está instalado, puedes hacerlo desde Syspanel en Servidores > FTP.

5.2. Credenciales incorrectas

Usa el usuario y contraseña del sitio web, no del administrador de Syspanel. Si olvidaste la contraseña, cámbiala desde Usuarios > Editar > Cambiar contraseña.

5.3. Modo pasivo y firewall

El modo pasivo de FTP requiere puertos adicionales (normalmente 30000-31000). Ábrelos en el firewall:

sudo ufw allow 30000:31000/tcp

Y configura el rango en el archivo de configuración de vsftpd (/etc/vsftpd.conf):

pasv_min_port=30000
pasv_max_port=31000

6. Syspanel no responde o se congela

6.1. Alto consumo de recursos

Revisa el uso de CPU y RAM con:

top

Si un proceso está consumiendo demasiado, identifícalo y reinicia el servicio correspondiente. También puedes aumentar el límite de memoria en Syspanel desde Configuración > Rendimiento.

6.2. Logs de errores

Los logs de Syspanel suelen estar en /var/log/syspanel/. Busca errores recientes con:

tail -f /var/log/syspanel/error.log

6.3. Reinicio completo

Si nada funciona, reinicia el servidor:

sudo reboot

[WARNING] Solo haz esto si no hay procesos críticos en ejecución.

7. Actualización de Syspanel fallida

7.1. Falta de espacio en disco

Antes de actualizar, verifica que tengas al menos 500 MB libres. Usa df -h para comprobarlo.

7.2. Dependencias rotas

Si la actualización se interrumpió, ejecuta:

sudo apt-get update
sudo apt-get upgrade -y
sudo apt-get install -f

Luego reintenta la actualización desde Syspanel.

7.3. Backup previo

Siempre haz un backup antes de actualizar. Syspanel tiene una herramienta de backup en Herramientas > Backup. Si algo sale mal, puedes restaurar.

[TIP] Programa backups automáticos semanales.

8. Preguntas frecuentes adicionales (FAQ Syspanel)

8.1. ¿Cómo cambio el puerto de Syspanel?

Edita el archivo /usr/local/syspanel/conf/syspanel.conf y modifica la línea port=2106 por el puerto deseado. Luego reinicia el servicio.

8.2. ¿Cómo restablezco la contraseña de administrador?

Desde SSH, ejecuta:

/usr/local/syspanel/bin/v-change-user-password admin nueva_contraseña

8.3. ¿Syspanel es compatible con Cloudflare?

Sí, pero debes asegurarte de que el tráfico pase por el puerto 2106 y que Cloudflare no lo bloquee. Usa el modo "DNS only" para el panel.

8.4. ¿Puedo migrar desde otro panel?

Sí, pero es un proceso manual. Te recomendamos exportar bases de datos y archivos, luego importarlos en Syspanel. Consulta nuestra guía de migración.

9. Consejos finales para evitar problemas

Actualiza regularmente Syspanel y los servicios del sistema.
Monitorea el espacio en disco y el uso de recursos.
Configura alertas por correo para cuando un servicio caiga.
Usa contraseñas seguras y cambia las predeterminadas.
Consulta la documentación oficial de Syspanel en nuestro sitio web.

Si después de seguir estos pasos el problema persiste, abre un ticket de soporte desde el propio panel o envíanos un correo con los logs relevantes. Estamos aquí para ayudarte.

Syspanel ayuda está a solo un clic de distancia. Recuerda que la mayoría de los Syspanel problemas se resuelven con un reinicio de servicios o una comprobación de permisos. ¡No dudes en usar este FAQ como tu primera herramienta de diagnóstico!