🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

FAQ: Problemas comunes al usar Syspanel y cómo solucionarlos

Actualizado el 10 de diciembre de 2025

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

Syspanel es una herramienta de administración de servidores web potente y versátil. Sin embargo, como cualquier software, puede presentar algunos inconvenientes, especialmente si estás empezando o realizas cambios en la configuración. No te preocupes: la mayoría de los problemas tienen una solución sencilla que puedes aplicar tú mismo.

Esta guía está diseñada para resolver las dudas más frecuentes. Aquí encontrarás soluciones paso a paso para los errores más comunes en Syspanel, desde problemas de acceso hasta caídas del panel. Si alguna vez te has quedado atascado con un mensaje de error o una función que no responde, este FAQ es para ti.

[INFO] Recuerda que Syspanel (basado en HestiaCP) se gestiona a través del puerto 2106. Por ejemplo, para acceder a tu panel, la URL sería: https://tudominio.com:2106 o https://tu-ip:2106.

## Problemas de acceso al panel Syspanel

Uno de los problemas más comunes es no poder iniciar sesión. Esto puede deberse a varias causas, desde un error al escribir la contraseña hasta un servicio detenido.

### No recuerdo mi contraseña de administrador

Si olvidaste la contraseña del usuario admin (o de cualquier otro usuario), puedes restablecerla directamente desde la terminal del servidor.

Para solucionarlo:

  1. Conéctate a tu servidor por SSH como usuario root.
  2. Ejecuta el siguiente comando: 
    v-change-user-password admin NuevaContraseñaSegura
    (Reemplaza admin por el nombre de usuario y NuevaContraseñaSegura por la contraseña que desees).
  3. Recibirás un mensaje de confirmación. Ahora ya puedes iniciar sesión en https://tu-servidor:2106 con las nuevas credenciales.

[TIP] Si quieres cambiar la contraseña de otro usuario (por ejemplo, juanperez), usa el mismo comando: v-change-user-password juanperez NuevaClave.

### El panel no carga, da error de conexión segura (SSL)

Syspanel fuerza el uso de HTTPS. Si ves un error de certificado o la página no carga, puede ser porque el certificado SSL propio del panel no es válido para tu navegador o porque el servicio web del panel está caído.

Pasos para solucionarlo:

  1. Acepta el riesgo (solo para pruebas): Si es la primera vez que accedes, tu navegador te advertirá que la conexión no es privada. Puedes hacer clic en "Avanzado" y luego en "Continuar a tu-ip (no seguro)". Esto es normal la primera vez.
  2. Reinicia el servicio de Syspanel: Conéctate por SSH y ejecuta: 
    systemctl restart hestia
    (Aunque se llame hestia, recuerda que aquí lo llamamos Syspanel).
  3. Verifica que el puerto 2106 está abierto: Asegúrate de que tu firewall o el panel de tu proveedor de cloud permitan tráfico entrante al puerto 2106 (TCP).

### Error: "Usuario o contraseña incorrectos" a pesar de estar seguro de que son correctos

Esto suele ocurrir si el usuario ha sido bloqueado por demasiados intentos fallidos o si la base de datos de usuarios está corrupta.

Solución:

  1. Desbloquear usuario: Conéctate por SSH como root y ejecuta: 
    v-unban-user admin
    (Cambia admin por el usuario bloqueado).
  2. Verificar el archivo de usuarios: Si el problema persiste, revisa el archivo /etc/hestia/passwd. Si falta algún usuario, puedes crearlo de nuevo desde la terminal.

## Errores al crear o gestionar cuentas de hosting

Al añadir un nuevo dominio o usuario, pueden surgir errores relacionados con permisos, DNS o recursos del servidor.

### Error: "Domain already exists" (El dominio ya existe)

Syspanel impide crear un dominio que ya esté registrado en el sistema, incluso si es en otro usuario.

Cómo resolverlo:

  1. Verifica en la lista de dominios: Inicia sesión en el panel y ve a "WEB" > "Dominios". Busca el nombre del dominio.
  2. Elimínalo si es un duplicado: Si aparece, puedes eliminarlo (cuidado: esto borrará todos los archivos asociados). Si no aparece, el problema puede ser un registro huérfano en la base de datos.
  3. Solución avanzada: Conéctate por SSH y lista todos los dominios del sistema: 
    v-list-sys-users
    Luego, busca el dominio manualmente en /etc/hestia/data/users/<usuario>/web.conf. Si está ahí, elimínalo con un editor de texto.

### El subdominio no funciona o da error 404

Al crear un subdominio (ej: blog.tudominio.com), a veces no se crea correctamente la configuración DNS o los directorios.

Pasos para solucionarlo:

  1. Verifica la zona DNS: Asegúrate de que el registro CNAME o A para el subdominio apunte a tu servidor. Puedes hacerlo desde Syspanel en "DNS" > "Editar zona".
  2. Reconstruye la configuración del dominio: En la terminal, ejecuta: 
    v-rebuild-web-domains <usuario>
    (Reemplaza <usuario> por el nombre del usuario propietario del dominio).
  3. Comprueba la carpeta: El subdominio se crea dentro de la carpeta web del usuario. Por ejemplo: /home/<usuario>/web/<subdominio.tudominio.com>/public_html. Si no existe, créala manualmente.

## Problemas con correo electrónico (Email)

Syspanel incluye un potente servidor de correo, pero es común tener problemas de envío o recepción.

### No puedo enviar correos, quedan en la cola

Esto suele deberse a que el servidor tiene bloqueado el puerto 25 (SMTP) o a que la configuración de DNS (registros MX, SPF, DKIM) es incorrecta.

Solución paso a paso:

  1. Revisa los registros de correo: En el panel, ve a "MAIL" y asegúrate de que la cuenta de correo esté activa.
  2. Verifica los registros DNS: Asegúrate de que existan los registros:
    • MX: apuntando a mail.tudominio.com.
    • A para mail.tudominio.com: apuntando a la IP de tu servidor.
    • TXT con el registro SPF y DKIM (Syspanel los genera automáticamente, pero debes añadirlos en tu DNS externo si no usas los DNS de Syspanel).
  3. Comprueba el puerto 25: Desde tu terminal, ejecuta: 
    telnet localhost 25
    Si no responde, el servicio de correo (Exim) está caído. Reinícialo con: 
    systemctl restart exim4

[WARNING] Muchos proveedores de VPS bloquean el puerto 25 por defecto para evitar spam. Debes solicitar su apertura o usar un relay SMTP externo (como SendGrid o Mailgun).

### Los correos llegan a la carpeta de Spam

Esto es un problema de reputación del dominio o de configuración de autenticación.

Cómo mejorarlo:

  1. Configura DKIM: En Syspanel, ve a "MAIL" > "DKIM" y asegúrate de que esté habilitado. Luego, copia el registro TXT generado y pégalo en tu zona DNS externa.
  2. Configura SPF: Añade un registro TXT como: v=spf1 a mx ip4:TU_IP ~all (reemplaza TU_IP por la IP de tu servidor).
  3. Configura DMARC: Añade un registro TXT para _dmarc.tudominio.com con el valor: v=DMARC1; p=none; rua=mailto:admin@tudominio.com.

## Errores de base de datos (MySQL/MariaDB)

Las bases de datos son el corazón de la mayoría de las aplicaciones web. Un error aquí puede dejar tu sitio en blanco.

### Error: "Can't connect to local MySQL server"

El servicio de base de datos no se está ejecutando.

Solución:

  1. Verifica el estado del servicio: 
    systemctl status mysql
    (o mariadb si usas MariaDB).
  2. Reinicia el servicio: 
    systemctl restart mysql
  3. Revisa los logs: Si no arranca, mira el archivo /var/log/mysql/error.log. Un error común es que el disco esté lleno. Libera espacio y vuelve a intentarlo.

### No puedo importar una base de datos grande (más de 50MB)

Syspanel tiene un límite de subida por defecto en PHP que impide importar archivos grandes.

Soluciones:

  1. Usa la terminal (recomendado): Conéctate por SSH y ejecuta: 
    mysql -u <usuario> -p <nombre_bd> < /ruta/al/archivo.sql
    Te pedirá la contraseña de la base de datos.
  2. Aumenta el límite de subida: Edita el archivo /etc/php/8.x/apache2/php.ini (la versión puede variar) y cambia: 
    upload_max_filesize = 100M
post_max_size = 100M
    Luego reinicia Apache: systemctl restart apache2.

## Problemas de rendimiento y recursos

Un servidor lento puede deberse a falta de recursos o a procesos mal configurados.

### El servidor está muy lento o no responde

Diagnóstico y solución:

  1. Comprueba el uso de recursos: Desde la terminal, ejecuta: 
    top
    o 
    htop
    Busca procesos que consuman mucha CPU o RAM.
  2. Verifica el espacio en disco: 
    df -h
    Si el disco está al 100%, libera espacio eliminando logs viejos o archivos temporales.
  3. Revisa el número de procesos de Apache: Si tienes muchos sitios web, Apache puede saturarse. Considera usar Nginx como proxy inverso o aumentar la memoria RAM del servidor.

[INFO] Syspanel incluye una función de "Monitor" en el panel que te muestra el uso de CPU, RAM y disco en tiempo real. Úsala para detectar picos de actividad.

### Error 503 Service Unavailable

Este error indica que el servidor web (Apache o Nginx) no puede manejar la petición, generalmente por sobrecarga o por un error de configuración.

Solución:

  1. Reinicia el servicio web: 
    systemctl restart apache2
    (o nginx si usas Nginx).
  2. Revisa los logs de errores: 
    tail -f /var/log/apache2/error.log
    Busca líneas que indiquen "server reached MaxRequestWorkers" o "out of memory".
  3. Aumenta los límites de Apache: Edita /etc/apache2/mods-available/mpm_prefork.conf y aumenta los valores de MaxRequestWorkers y ServerLimit. Luego reinicia Apache.

## Preguntas frecuentes sobre actualizaciones y mantenimiento

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

Mantener Syspanel actualizado es crucial para la seguridad y el rendimiento.

Pasos seguros:

  1. Haz una copia de seguridad: Antes de actualizar, ve a "BACKUP" en el panel y descarga una copia completa de tus cuentas.
  2. Actualiza desde la terminal: Conéctate como root y ejecuta: 
    apt update && apt upgrade -y
    Esto actualizará todos los paquetes del sistema, incluyendo Syspanel.
  3. Actualiza Syspanel específicamente: Si existe una nueva versión del panel, puedes ejecutar: 
    /usr/local/hestia/upd/upgrade.sh
    Sigue las instrucciones en pantalla.

[WARNING] Nunca actualices desde el panel web mientras se está ejecutando una actualización del sistema. Hazlo siempre desde la terminal.

### ¿Cómo restauro una copia de seguridad?

Proceso sencillo:

  1. Ve a "BACKUP" > "Restaurar".
  2. Selecciona el archivo de backup (formato .tar o .tar.gz).
  3. Elige si quieres restaurar todo o solo partes (correo, web, DNS, etc.).
  4. Haz clic en "Restaurar". El proceso puede tardar varios minutos dependiendo del tamaño.

Si la restauración falla, prueba a hacerlo desde la terminal:

v-restore-user <usuario> /ruta/al/backup.tar.gz

## Conclusión: Syspanel FAQ y soporte continuo

Esperamos que esta guía de Syspanel FAQ te haya ayudado a resolver los problemas más comunes. Recuerda que la mayoría de los errores tienen una solución lógica y que siempre puedes recurrir a la terminal para acciones avanzadas.

Si después de probar todas estas soluciones el problema persiste, no dudes en contactar a nuestro equipo de Syspanel soporte. Estamos aquí para ayudarte. Para consultas rápidas, recuerda que el puerto de acceso es el 2106 y que siempre es buena práctica tener un backup reciente antes de realizar cambios importantes.

[TIP] Guarda esta página como referencia. Muchos de estos problemas se resuelven en minutos si sabes dónde mirar. ¡No te rindas!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel