Preguntas frecuentes sobre Syspanel: Solución a errores comunes
Introducción: Tu aliado Syspanel y las dudas más comunes
Bienvenido a la guía de preguntas frecuentes sobre Syspanel, tu panel de control de hosting basado en la potente base de HestiaCP. Sabemos que al principio, cualquier herramienta nueva puede generar dudas. Por eso, hemos recopilado los errores y preguntas más habituales para que puedas resolverlos de forma rápida y sencilla.
Syspanel está diseñado para ser intuitivo, pero como cualquier sistema, a veces pueden surgir pequeños contratiempos. No te preocupes: aquí encontrarás soluciones paso a paso, explicadas en un lenguaje claro y sin tecnicismos innecesarios. Recuerda que tu panel de control se gestiona desde el puerto 2106 (por ejemplo: https://tudominio.com:2106).
## 1. No puedo acceder a Syspanel: Error de conexión o página en blanco
Este es, sin duda, el error más común. Si al intentar entrar a https://tudominio.com:2106 ves una página en blanco, un error de conexión o un mensaje de "sitio no seguro", no entres en pánico. Las causas suelen ser muy simples.
### Causas y soluciones rápidas
-
Problema con el puerto 2106 bloqueado por tu firewall local.
- Solución: Revisa que tu antivirus, cortafuegos (Windows Defender, Mac firewall) o programa de seguridad no esté bloqueando el puerto 2106. Añade una excepción para ese puerto o para la IP de tu servidor. Si estás en una red corporativa, consulta con tu administrador de red.
-
El servidor está caído o el servicio de Syspanel no se ha iniciado.
- Solución (si tienes acceso SSH): Conéctate por SSH a tu servidor y ejecuta:
Luego verifica el estado con:systemctl restart hestia
Deberías ver "active (running)". Si no, contacta con tu proveedor de hosting.systemctl status hestia
- Solución (si tienes acceso SSH): Conéctate por SSH a tu servidor y ejecuta:
-
Certificado SSL caducado o no válido.
- Solución: Esto es muy habitual. Syspanel genera un certificado SSL autofirmado que puede caducar. Para renovarlo desde la terminal:
Luego, recarga el navegador (usa una ventana de incógnito para evitar caché)./usr/local/hestia/bin/v-update-host-certificate
- Solución: Esto es muy habitual. Syspanel genera un certificado SSL autofirmado que puede caducar. Para renovarlo desde la terminal:
-
El navegador guarda una versión antigua (caché).
- Solución: Prueba con una ventana de incógnito/privada. Si funciona, limpia la caché de tu navegador (Ctrl+Shift+Supr en Chrome/Firefox).
[WARNING] Si usas Let's Encrypt, asegúrate de que el dominio apunte correctamente a la IP del servidor antes de emitir el certificado.
## 2. Error "500 Internal Server Error" al crear un sitio web o una base de datos
Este error significa que algo falló en el servidor al procesar tu solicitud. No te asustes, suele ser por permisos o configuraciones incorrectas.
### Pasos para diagnosticar y solucionar
-
Revisa los logs de Syspanel (desde la interfaz).
- Ve a Panel de control > Registros o busca la sección "Logs" dentro de Syspanel. Busca la entrada más reciente con el error. Te dará una pista (ej: "permiso denegado", "base de datos no encontrada").
-
Verifica el espacio en disco.
- Un disco lleno es una causa muy frecuente. Desde la terminal:
Si alguna partición está al 100%, libera espacio (elimina logs antiguos, copias de seguridad temporales, etc.).df -h
- Un disco lleno es una causa muy frecuente. Desde la terminal:
-
Comprueba los permisos de las carpetas.
- Al crear un sitio, Syspanel asigna permisos automáticamente, pero a veces falla. Desde la terminal, como usuario
admin(o el que creaste):
(No es necesario, solo es un ejemplo de comando). Para reparar permisos de un usuario específico:/usr/local/hestia/bin/v-change-user-password admin/usr/local/hestia/bin/v-repair-user-permissions <nombre_usuario>
- Al crear un sitio, Syspanel asigna permisos automáticamente, pero a veces falla. Desde la terminal, como usuario
-
Reintenta la operación.
- A veces es un error transitorio. Vuelve a intentar crear el sitio o la base de datos desde cero.
[TIP] Si el error persiste, anota el mensaje exacto del log y búscalo en Google junto con "Syspanel" o "HestiaCP". La comunidad es muy activa.
## 3. El correo no se envía o no se recibe (SMTP/IMAP)
Los problemas de correo son otro clásico. Syspanel incluye un servidor de correo (Exim) y Dovecot, pero la configuración de DNS suele ser la culpable.
### Revisa los registros DNS
- Registro MX: Debe apuntar a tu dominio principal (ej:
mail.tudominio.com). - Registro A para mail: Debe existir un registro A para
mail.tudominio.comque apunte a la misma IP de tu servidor. - Registro SPF: Es vital para evitar que los correos se marquen como spam. Debe ser algo como:
v=spf1 mx a:mail.tudominio.com -all - Registro DKIM: Syspanel lo configura automáticamente. Puedes verificar desde Panel de control > Correo > Configuración DKIM.
- Registro DMARC: Opcional pero muy recomendado.
### Soluciones desde Syspanel
- Reinicia los servicios de correo:
Desde la terminal:systemctl restart exim4 systemctl restart dovecot - Comprueba la cola de correo:
Si hay muchos correos atascados, puedes forzar su envío conexim -bpexim -qo eliminar los antiguos conexim -Mrm <id_mensaje>.
[INFO] Si usas Gmail, Outlook u otros proveedores, asegúrate de que tu IP no esté en listas negras. Puedes comprobarlo en sitios como
mxtoolbox.com.
## 4. El sitio web carga muy lento o da timeout
La lentitud puede deberse a muchos factores. Aquí los más comunes y cómo atajarlos con Syspanel.
### Diagnóstico rápido
-
Uso de recursos del servidor:
Desde Syspanel, ve a Panel de control > Estadísticas del servidor. Revisa CPU, RAM y carga. Si están al límite, necesitas optimizar o escalar. -
PHP-FPM mal configurado:
Syspanel usa PHP-FPM. Puedes ajustar los límites desde Panel de control > Configuración del servidor > PHP. Aumentamax_execution_time,memory_limitomax_childrensi tu sitio lo requiere. -
Base de datos lenta:
Si usas MySQL/MariaDB, revisa las consultas lentas. Desde la terminal:mysqladmin -u root -p statusSi ves muchas consultas lentas, considera optimizar las tablas con
mysqlcheck -o --all-databases.
### Soluciones prácticas
- Activa la caché de página: Syspanel soporta Varnish o Nginx FastCGI Cache. Pregunta a tu proveedor si está disponible.
- Usa un CDN: Cloudflare es gratuito y reduce la carga del servidor.
- Comprime imágenes y activa Gzip: Desde el panel de control de tu sitio (si usas WordPress, un plugin de caché hará esto).
[WARNING] No instales demasiados plugins de caché a la vez. Pueden entrar en conflicto. Usa uno solo y bien configurado.
## 5. No puedo instalar WordPress u otro CMS con el instalador automático
Syspanel incluye un instalador de aplicaciones (como Softaculous, pero integrado). Si falla, suele ser por permisos o falta de requisitos.
### Solución paso a paso
-
Requisitos previos:
- Asegúrate de que el dominio ya tenga los DNS apuntando al servidor (pueden tardar hasta 24h).
- Verifica que el sitio web esté creado en Syspanel (con su base de datos y usuario FTP asociados).
-
Reintenta la instalación manual:
- Descarga WordPress desde wordpress.org.
- Súbelo por FTP a la carpeta
public_htmlde tu dominio. - Crea la base de datos desde Syspanel (si no lo hizo el instalador).
- Ejecuta la instalación manual desde
tudominio.com/wp-admin/install.php.
-
Errores de permisos:
- Si ves "No se puede escribir en wp-config.php", desde la terminal (como usuario
admin):chmod 644 /home/<usuario>/web/<tudominio>/public_html/wp-config.php chown -R <usuario>:<usuario> /home/<usuario>/web/<tudominio>/public_html/
- Si ves "No se puede escribir en wp-config.php", desde la terminal (como usuario
[TIP] Si el instalador falla constantemente, es más fiable hacer la instalación manual. Te da más control y evitas sorpresas.
## 6. Olvidé mi contraseña de Syspanel
No pasa nada, es muy fácil recuperarla.
### Cómo restablecer la contraseña
-
Desde la terminal (si tienes acceso SSH):
/usr/local/hestia/bin/v-change-user-password <tu_usuario>Te pedirá la nueva contraseña. Escríbela y confírmala.
-
Desde la pantalla de login:
- En la página de inicio de sesión de Syspanel (
https://tudominio.com:2106), busca el enlace "¿Olvidaste tu contraseña?". - Introduce tu nombre de usuario y recibirás un correo con instrucciones (si el servidor de correo funciona).
- En la página de inicio de sesión de Syspanel (
[WARNING] Si no recibes el correo, el problema puede ser el servidor de correo (ver punto 3). En ese caso, usa el método por SSH.
## 7. No encuentro la opción para añadir un subdominio o dominio adicional
Syspanel lo gestiona de forma muy sencilla, pero a veces la interfaz puede no ser intuitiva al principio.
### Pasos para añadir un dominio
- Inicia sesión en tu Syspanel.
- Ve a Panel de control > Sitios Web.
- Haz clic en el botón "Añadir dominio" o "Crear nuevo" (suele estar arriba a la derecha).
- Introduce el dominio (ej:
nuevodominio.comosub.dominio.com). - Selecciona el usuario al que pertenecerá (si tienes varios).
- Marca las opciones adicionales (base de datos, FTP, etc.) y haz clic en "Guardar".
### Para subdominios
- El proceso es idéntico, solo que en el campo del dominio escribes
subdominio.tudominio.com. Syspanel creará la carpeta correspondiente automáticamente.
[INFO] Recuerda que los DNS de ese nuevo dominio o subdominio deben apuntar a tu servidor para que funcione.
## 8. Error "502 Bad Gateway" al navegar por mi sitio
Este error suele indicar que el servidor web (Nginx o Apache) no puede comunicarse con el procesador de PHP (PHP-FPM).
### Soluciones inmediatas
-
Reinicia PHP-FPM:
Desde la terminal:systemctl restart php*-fpm(Sustituye
*por tu versión de PHP, ej:php8.1-fpm). -
Reinicia Nginx:
systemctl restart nginx -
Verifica que el socket de PHP-FPM existe:
ls -la /var/run/php/Deberías ver un archivo como
php8.1-fpm.sock. Si no aparece, el servicio no se inició correctamente. -
Revisa los logs de error:
tail -f /var/log/nginx/error.logBusca mensajes como "connect() to unix:/var/run/php/php8.1-fpm.sock failed".
[WARNING] Si el error persiste, puede ser un problema de configuración en el archivo de sitio de Nginx. Contacta con soporte técnico si no te sientes cómodo editándolo.
## Conclusión: Syspanel es tu aliado, no tu enemigo
Esperamos que esta FAQ te haya ayudado a resolver los errores más comunes. Recuerda que Syspanel (basado en HestiaCP) es una herramienta potente y, con un poco de práctica, te resultará muy fácil de usar.
Si después de seguir estos pasos el problema persiste, no dudes en contactar con nuestro equipo de soporte. Estamos aquí para ayudarte.
[TIP] Guarda esta guía en tus favoritos. Te será útil cada vez que surja una duda. Y recuerda: la práctica hace al maestro.
