Syspanel: errores comunes y cómo solucionarlos

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

Syspanel es una herramienta de panel de control robusta y fácil de usar, pero como cualquier software, puede presentar algunos inconvenientes de vez en cuando. La mayoría de los errores comunes tienen solución y no requieren conocimientos avanzados de programación. En esta guía, te explicaré paso a paso cómo resolver los problemas más típicos que puedes encontrar al usar Syspanel.

Recuerda que tu panel de control Syspanel se accede a través del puerto 2106. Si tienes problemas para acceder, probablemente sea por un bloqueo de puerto o una configuración de firewall.

## Error 1: No puedo acceder a Syspanel (pantalla en blanco o “Connection refused”)

### Posibles causas

Este es uno de los errores más frustrantes, pero suele tener soluciones sencillas.

Causa común #1: El servicio de Syspanel no está corriendo.
Causa común #2: El puerto 2106 está bloqueado por un firewall.
Causa común #3: El navegador guardó una caché obsoleta.

### Solución paso a paso

Verifica que el servicio esté activo. Conéctate por SSH a tu servidor y ejecuta:
```
systemctl status syspanel
```
Si ves “inactive (dead)”, inícialo con:
```
systemctl start syspanel
```
Comprueba el firewall. Asegúrate de que el puerto 2106 esté abierto. En sistemas con UFW (Ubuntu), usa:
```
ufw allow 2106/tcp
```
En CentOS/Red Hat con firewalld:
```
firewall-cmd --add-port=2106/tcp --permanent
firewall-cmd --reload
```
Limpia la caché del navegador. Prueba acceder desde una ventana de incógnito o borra los datos de navegación de los últimos 24 horas.

[TIP] Si usas Cloudflare u otro proxy, asegúrate de que el puerto 2106 esté configurado como “Solo TCP” (no HTTP) y que no esté oculto detrás de un proxy.

## Error 2: “Error de conexión a la base de datos” al instalar un CMS

### ¿Por qué ocurre?

Syspanel gestiona bases de datos MySQL/MariaDB. Este error suele aparecer cuando los datos de conexión no coinciden o el servicio de base de datos no está funcionando.

### Soluciones prácticas

Verifica que MySQL/MariaDB esté corriendo:
```
systemctl status mysql
```
Si no está activo, inícialo:
```
systemctl start mysql
```
Revisa las credenciales. En Syspanel, ve a la sección “Bases de datos” y anota el nombre de usuario, la contraseña y el host (normalmente localhost). Luego, en el instalador de tu CMS, asegúrate de que coincidan exactamente.
Prueba la conexión manualmente. Desde la terminal, intenta conectar:
```
mysql -u tu_usuario -p
```
Si te pide contraseña y no funciona, es posible que la contraseña esté mal escrita en Syspanel. Puedes restablecerla desde el panel.

[WARNING] Nunca uses root como usuario de base de datos para aplicaciones web. Crea siempre un usuario específico desde Syspanel.

## Error 3: El sitio web carga muy lento o da error 500

### Causas más frecuentes

Archivos .htaccess mal configurados.
Permisos incorrectos en carpetas.
PHP con límites de memoria muy bajos.

### Cómo solucionarlo

Revisa los logs de errores. En Syspanel, ve a “Registros” o accede por SSH a /var/log/syspanel/ y busca el archivo error.log. Allí verás detalles del error.

Restablece los permisos de archivos. Un comando rápido desde SSH:

find /home/usuario/web/dominio/public_html -type f -exec chmod 644 {} \;
find /home/usuario/web/dominio/public_html -type d -exec chmod 755 {} \;

Sustituye usuario y dominio por los tuyos.

Aumenta la memoria PHP. Desde Syspanel, en la sección “PHP” de tu plan, cambia el valor de memory_limit a 256M o 512M. Luego reinicia el servicio PHP:
```
systemctl restart php8.2-fpm
```
(Ajusta la versión de PHP según la que tengas).

[INFO] El error 500 también puede deberse a un plugin o tema corrupto en WordPress. Desactívalos renombrando la carpeta wp-content/plugins a wp-content/plugins_viejo desde el panel de archivos.

## Error 4: No puedo enviar ni recibir correos electrónicos

### Diagnóstico rápido

Syspanel incluye un servidor de correo (Exim o Postfix). Si los correos no funcionan, suele ser por:

Bloqueo del puerto 25 por parte del proveedor de hosting.
Configuración incorrecta de registros DNS (SPF, DKIM, DMARC).
El servicio de correo no está habilitado.

### Pasos para resolverlo

Verifica que el servicio de correo esté activo:

systemctl status exim4

systemctl status postfix

Comprueba los puertos. Desde tu PC, ejecuta:
```
telnet tudominio.com 25
```
Si no responde, contacta a tu proveedor de hosting para que desbloquee el puerto 25.
Configura los registros DNS. En el panel de tu dominio, agrega:
- SPF: v=spf1 mx a ip4:TU_IP_SERVIDOR ~all
- DKIM: Actívalo desde Syspanel en “Correo” > “DKIM” y copia el registro TXT.
- DMARC: v=DMARC1; p=none; rua=mailto:admin@tudominio.com

[TIP] Para pruebas rápidas, usa la herramienta swaks desde SSH:
swaks --to prueba@tucorreo.com --server localhost

## Error 5: “El certificado SSL no es válido” o “HTTPS no funciona”

### Problemas típicos

El certificado Let’s Encrypt no se renovó automáticamente.
El dominio no apunta correctamente al servidor.
El firewall bloquea el puerto 443.

### Soluciones

Renueva manualmente el certificado. En Syspanel, ve a “SSL” y haz clic en “Renovar”. O desde SSH:
```
syspanel renew-ssl dominio.com
```
Verifica que el dominio apunte a tu IP. Usa dig dominio.com y asegúrate de que la IP coincida con la de tu servidor.
Abre el puerto 443 en el firewall:
```
ufw allow 443/tcp
```
Comprueba la fecha del servidor. Si la hora del sistema está desincronizada, los certificados fallan. Ejecuta:
```
timedatectl set-ntp true
```

[WARNING] Si usas Cloudflare, asegúrate de que el modo “SSL” esté en “Full (strict)” y que el certificado de origen esté instalado en Syspanel.

## Error 6: No puedo subir archivos grandes (límite de 2MB)

### Causa

PHP tiene un límite de subida configurado por defecto. Syspanel permite cambiarlo fácilmente.

### Cómo aumentarlo

Desde Syspanel, ve a “PHP” > “Configuración avanzada”.
Busca las directivas:
- upload_max_filesize
- post_max_size
- max_execution_time
Cámbialas a, por ejemplo, 64M y 300 segundos.
Guarda los cambios y reinicia PHP:
```
systemctl restart php8.2-fpm
```

[TIP] Si tu sitio usa WordPress, también puedes añadir esto al archivo wp-config.php:
@ini_set( 'upload_max_filesize', '64M' );
@ini_set( 'post_max_size', '64M' );

## Error 7: El panel muestra “Disk quota exceeded” o “No space left on device”

### ¿Qué significa?

Has alcanzado el límite de espacio en disco asignado a tu cuenta.

### Soluciones

Libera espacio. Revisa carpetas como backup/, tmp/ o logs/. Desde SSH:
```
du -sh /home/usuario/*
```
Identifica qué carpeta pesa más y elimina archivos innecesarios.
Aumenta la cuota. Si eres administrador del servidor, edita el plan de usuario en Syspanel y sube el límite de disco.

Comprime archivos viejos. Por ejemplo:

tar -czf backups_viejos.tar.gz /home/usuario/backups/*.sql
rm /home/usuario/backups/*.sql

[INFO] Puedes ver el uso de disco en tiempo real desde Syspanel en “Estadísticas” > “Uso de disco”.

## Preguntas frecuentes (FAQ)

### ¿Cómo reinicio Syspanel completamente?

Ejecuta desde SSH:

systemctl restart syspanel

### ¿Puedo cambiar el puerto de acceso de Syspanel?

Sí, pero no es recomendable. Si necesitas hacerlo, edita el archivo /etc/syspanel/nginx.conf y cambia listen 2106 por otro puerto. Luego reinicia el servicio.

### ¿Qué hago si olvido la contraseña de administrador de Syspanel?

Desde SSH, ejecuta:

syspanel reset-password admin

Te pedirá la nueva contraseña.

### ¿Syspanel es compatible con Cloudflare?

Sí, pero debes configurar correctamente los registros DNS y usar SSL en modo “Full (strict)”. Además, asegúrate de que el puerto 2106 no esté proxyado.

### ¿Cómo actualizo Syspanel a la última versión?

Usa el comando:

apt update && apt upgrade syspanel

O si usas yum:

yum update syspanel

## Conclusión

La mayoría de los errores en Syspanel tienen solución en pocos minutos si sigues estos pasos. Recuerda siempre:

Acceder por el puerto 2106.
Revisar los logs ante cualquier duda.
Mantener el sistema actualizado.

Si después de intentar todo esto el problema persiste, no dudes en contactar a tu proveedor de hosting o consultar la documentación oficial de Syspanel. Con un poco de paciencia, tu panel volverá a funcionar perfectamente.

[TIP FINAL] Crea una copia de seguridad completa antes de hacer cambios importantes. Syspanel incluye una herramienta de backup en “Seguridad” > “Copias de seguridad”. Úsala siempre.