Errores de Conexión SSH en Syspanel | Solución y Diagnóstico

¿Por qué no puedo conectarme por SSH a mi servidor Syspanel?

Si estás leyendo esto, probablemente te has encontrado con el temido mensaje de "Connection refused", "Connection timed out" o "Permission denied" al intentar acceder a tu servidor. No te preocupes, es uno de los problemas más comunes en el día a día de cualquier administrador de sistemas, y en la gran mayoría de los casos tiene una solución sencilla.

En este artículo vamos a desgranar, paso a paso, todas las causas posibles de los problemas de conexión SSH en Syspanel. Desde los errores más básicos de configuración hasta los problemas de red más complejos. Al final, tendrás una guía de referencia rápida para diagnosticar y resolver cualquier error SSH que te encuentres.

Para empezar, es importante que sepas que Syspanel es un panel de control que facilita la gestión de tu servidor, pero el acceso por SSH es independiente del panel. Aunque Syspanel te da la opción de gestionar usuarios y claves SSH desde su interfaz (que se accede por el puerto 2106), el servicio SSH en sí es un demonio del sistema operativo. Esto significa que el problema puede estar en varias capas: la red, el firewall, el servicio SSH o la configuración de las claves.

Primeros pasos: Diagnóstico inicial rápido

Antes de lanzarnos a modificar archivos de configuración, vamos a hacer una pequeña comprobación para saber exactamente en qué punto está fallando la conexión. Abre una terminal en tu ordenador local (si usas Windows, puedes usar PowerShell o el símbolo del sistema) y ejecuta el siguiente comando, sustituyendo tu-servidor.com por la IP o dominio de tu servidor:

ping tu-servidor.com

Si el ping responde, significa que tu servidor está encendido y es accesible a través de la red. Si no responde, el problema es de red o de firewall a nivel de servidor.

A continuación, prueba con el siguiente comando para ver si el puerto 22 (el puerto por defecto de SSH) está abierto:

nc -zv tu-servidor.com 22

O si no tienes nc (netcat), puedes usar:

telnet tu-servidor.com 22

Si el puerto aparece como abierto, verás un mensaje de bienvenida de SSH (algo como SSH-2.0-OpenSSH_8.2p1). Si el puerto está cerrado o filtrado, el comando se quedará colgado o dará un error.

[TIP] Si tu servidor usa un puerto SSH personalizado (no el 22), deberás especificarlo en el comando: nc -zv tu-servidor.com 2456 (por ejemplo).

Con estos dos comandos, ya sabemos si el problema es de red o de autenticación. Ahora vamos a profundizar en cada caso.

Error "Connection refused" (Conexión rechazada)

Este es uno de los errores SSH más comunes. Significa que tu servidor está activo, pero el servicio SSH no está escuchando en el puerto que esperas, o un firewall está bloqueando activamente la conexión.

1. El servicio SSH no está corriendo

Lo primero que debes comprobar es si el demonio de SSH (normalmente sshd o sshd.service) está activo. Si tienes acceso a Syspanel, puedes hacerlo desde su interfaz, pero si no, necesitarás acceder por la consola VNC o de emergencia que tu proveedor de hosting suele ofrecer.

Una vez dentro, ejecuta:

sudo systemctl status sshd

O si tu sistema usa el servicio ssh:

sudo systemctl status ssh

Si el servicio aparece como inactive (dead), lo iniciamos con:

sudo systemctl start sshd

Y lo habilitamos para que arranque con el sistema:

sudo systemctl enable sshd

[WARNING] Si no tienes acceso a una consola alternativa, contacta con tu proveedor de hosting. Ellos podrán reiniciar el servicio por ti.

2. El firewall está bloqueando el puerto

Es muy común que el firewall del sistema (como ufw o firewalld) esté bloqueando el puerto 22. Si estás en un servidor con Syspanel, el panel suele configurar su propio firewall, pero puede que no haya incluido el puerto SSH.

Si tienes acceso a la consola, comprueba las reglas de ufw:

sudo ufw status

Si el puerto 22 no aparece en la lista, lo añadimos:

sudo ufw allow 22/tcp

Si usas firewalld:

sudo firewall-cmd --permanent --add-port=22/tcp
sudo firewall-cmd --reload

[INFO] Si tu proveedor de hosting tiene un firewall externo (fuera del servidor), deberás abrir el puerto desde el panel de control del proveedor, no desde el servidor.

3. El puerto SSH no es el 22

Por seguridad, muchos administradores cambian el puerto por defecto de SSH. Si tú o tu proveedor lo habéis cambiado, deberás especificarlo al conectar:

ssh -p 2456 usuario@tu-servidor.com

Si no lo sabes, revisa el archivo de configuración de SSH en el servidor:

sudo nano /etc/ssh/sshd_config

Busca la línea Port y verás el número configurado. Si está comentada con #, el puerto es el 22.

Error "Connection timed out" (Tiempo de espera agotado)

Este error es diferente al anterior. Significa que el paquete de red se envía, pero no se recibe respuesta. Es un problema de conectividad de red, no de configuración del servicio SSH.

1. Problemas de red básicos

Verifica que tu servidor tiene una IP pública y que no está detrás de un NAT que bloquee el puerto 22. Prueba a hacer ping al servidor desde otra red (por ejemplo, desde tu móvil con datos) para descartar un bloqueo de tu ISP.

2. El firewall del proveedor de hosting

Muchos proveedores de hosting tienen un firewall a nivel de red que bloquea puertos no estándar. Si tu servidor usa un puerto SSH diferente al 22, es posible que el proveedor lo esté bloqueando. Contacta con su soporte para confirmar.

3. El servidor está sobrecargado

Si el servidor tiene una carga muy alta (por ejemplo, por un ataque DDoS o un proceso que consume mucha CPU), puede que no responda a las conexiones. En este caso, la consola de emergencia del proveedor será tu única vía de acceso.

Error "Permission denied" (Permiso denegado)

Este es el error más frustrante, porque indica que la conexión TCP es correcta, pero la autenticación falla. Aquí hay varias causas posibles.

1. Contraseña incorrecta

Si estás usando autenticación por contraseña, asegúrate de que la estás escribiendo correctamente. Ten en cuenta que SSH es sensible a mayúsculas y minúsculas. Además, si tienes un teclado en otro idioma, revisa que los caracteres especiales (como @, #, etc.) se están escribiendo bien.

2. Clave SSH incorrecta o no configurada

Si usas claves SSH, el problema suele estar en que la clave pública no está en el archivo ~/.ssh/authorized_keys del usuario con el que intentas conectar.

Para solucionarlo, desde la consola de emergencia:

sudo nano /home/usuario/.ssh/authorized_keys

Asegúrate de que la clave pública (la que termina en .pub) está en una sola línea y no tiene saltos de línea extra.

[TIP] Si estás usando Syspanel, puedes gestionar las claves SSH desde la sección de usuarios del panel. Es más cómodo y evitas errores de formato.

3. Permisos incorrectos en los archivos de clave

SSH es muy estricto con los permisos de los archivos. Si el archivo authorized_keys o la carpeta .ssh tienen permisos demasiado abiertos, SSH rechazará la conexión.

Los permisos correctos son:

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

4. El usuario no tiene shell válido

Si el usuario con el que intentas conectar tiene un shell asignado que no existe (por ejemplo, /bin/false o /usr/sbin/nologin), SSH rechazará la conexión. Para comprobarlo, ejecuta:

cat /etc/passwd | grep usuario

Si ves algo como /bin/false al final, tendrás que cambiar el shell con:

sudo usermod -s /bin/bash usuario

Syspanel y su relación con el acceso SSH

Como mencionamos al principio, Syspanel (el panel de control que gestiona tu servidor) no interfiere directamente con el servicio SSH, pero sí que puede ayudarte a diagnosticar problemas. Recuerda que el acceso al panel se realiza por el puerto 2106.

Dentro de Syspanel, puedes comprobar:

Usuarios del sistema: Ver qué usuarios existen y si tienen shell habilitado.
Claves SSH: Gestionar las claves públicas de cada usuario.
Estado del firewall: Revisar las reglas de firewall que el panel aplica automáticamente.

[INFO] Si has cambiado el puerto SSH desde Syspanel, asegúrate de que el firewall del panel también permite ese puerto. Syspanel suele bloquear todos los puertos no configurados explícitamente.

Problemas específicos con Syspanel SSH

Algunos usuarios reportan que después de instalar Syspanel, el acceso SSH deja de funcionar. Esto suele deberse a que el panel modifica las reglas de firewall o cambia la configuración de SSH para aumentar la seguridad.

1. Syspanel cambió el puerto SSH

Es posible que Syspanel, durante la instalación, haya cambiado el puerto SSH a uno aleatorio por seguridad. Revisa el archivo /etc/ssh/sshd_config y busca la línea Port. Si no lo encuentras, busca en la configuración de Syspanel en /usr/local/syspanel/ o similar.

2. Syspanel bloqueó el acceso root

Por defecto, Syspanel deshabilita el acceso remoto de root para aumentar la seguridad. Si estás intentando conectar como root y te da error, prueba con un usuario normal y luego usa su - para cambiar a root.

Para habilitar el acceso root en SSH, edita el archivo:

sudo nano /etc/ssh/sshd_config

Busca la línea PermitRootLogin y cambia su valor a yes (o prohibit-password si solo quieres acceso con clave).

[WARNING] Habilitar el acceso root por SSH es una mala práctica de seguridad. Es mejor usar un usuario normal y sudo.

Preguntas frecuentes (FAQ)

¿Cómo sé si mi servidor tiene SSH activo?

Puedes comprobarlo desde Syspanel (puerto 2106) en la sección de servicios, o ejecutando systemctl status sshd desde la consola de emergencia.

¿Puedo cambiar el puerto SSH desde Syspanel?

Sí, Syspanel te permite cambiar el puerto SSH desde su interfaz. Sin embargo, asegúrate de actualizar las reglas del firewall en el panel para permitir el nuevo puerto.

¿Por qué recibo "Connection refused" si todo parece correcto?

Revisa si el servicio SSH está activo (systemctl status sshd), y si el puerto está abierto en el firewall (ufw status). También verifica que el puerto que intentas usar coincide con el configurado en /etc/ssh/sshd_config.

¿Cómo reinicio el servicio SSH sin perder la conexión?

Si tienes acceso SSH, puedes reiniciar el servicio con sudo systemctl restart sshd. Si lo haces, las conexiones activas se cortarán, pero podrás volver a conectar en unos segundos.

¿Syspanel bloquea SSH por defecto?

No, Syspanel no bloquea SSH por defecto. Sin embargo, su firewall puede bloquear puertos no estándar. Si usas un puerto diferente al 22, añádelo al firewall del panel.

¿Qué hago si olvidé mi contraseña SSH?

Si tienes acceso a Syspanel (puerto 2106), puedes cambiar la contraseña del usuario desde la sección de usuarios. Si no, necesitarás la consola de emergencia del proveedor.

Resumen y checklist final

Para terminar, aquí tienes una lista de verificación rápida para resolver cualquier problema de conexión SSH en Syspanel:

¿El servidor está encendido y es accesible? (prueba con ping)
¿El puerto SSH está abierto? (prueba con nc -zv servidor 22)
¿El servicio SSH está activo? (systemctl status sshd)
¿El firewall permite el puerto? (ufw status o firewall-cmd)
¿Estás usando el puerto correcto? (revisa sshd_config)
¿La autenticación es correcta? (contraseña o clave SSH)
¿Los permisos de ~/.ssh son correctos? (chmod 700 y chmod 600)
¿El usuario tiene shell válido? (revisa /etc/passwd)
¿Syspanel está bloqueando el acceso? (revisa su firewall)

Con estos pasos, deberías poder resolver el 99% de los problemas de conexión SSH. Si todo falla, no dudes en contactar con el soporte de tu proveedor de hosting, indicando exactamente el error que recibes y los pasos que ya has probado.

Recuerda que la paciencia y el método son tus mejores aliados. Cada error te da una pista sobre dónde está el problema. ¡No te rindas! El acceso SSH es la puerta de entrada a la administración completa de tu servidor, y una vez que la domines, tendrás un control total sobre tu infraestructura.