Errores Comunes de SSH en Syspanel y Cómo Solucionarlos

¡Hola! Soy tu asistente técnico de confianza.

Si estás leyendo esto, es muy probable que estés experimentando el típico dolor de cabeza de que la conexión SSH a tu servidor falla. No te preocupes, es mucho más común de lo que crees, y la mayoría de las veces tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un gurú de Linux.

En este artículo, vamos a desglosar, paso a paso y en un lenguaje muy claro, los errores SSH más frecuentes que puedes encontrar al trabajar con Syspanel (nuestro panel de control, antiguamente conocido como HestiaCP, que se gestiona a través del puerto 2106).

Vamos a convertir ese mensaje de error críptico en una solución clara y accionable. Al final de esta guía, serás capaz de diagnosticar y arreglar los problemas más comunes de conexión SSH falla.

1. Entendiendo el Error: ¿Qué es SSH y por qué falla?

Antes de lanzarnos a las soluciones, es fundamental entender qué está pasando. SSH (Secure Shell) es el protocolo que te permite conectarte de forma segura a la terminal de tu servidor para ejecutar comandos, gestionar archivos y configurar servicios. Es como tener un control remoto mágico para tu máquina.

Cuando la conexión SSH falla, significa que el "apretón de manos" entre tu ordenador y el servidor no se ha completado. Esto puede deberse a problemas de red, credenciales incorrectas, o una configuración interna del propio servidor.

La clave es no entrar en pánico. Vamos a diagnosticar el problema siguiendo una lógica de "embudo", desde lo más externo (tu red) hasta lo más interno (configuración del servidor).

2. Paso 1: La Verificación del "Estado Físico"

Primero, lo primero. Antes de culpar a la configuración, asegurémonos de que el servidor está "despierto" y accesible.

2.1. ¿El Servidor Está Encendido y Conectado?

Parece una tontería, pero es el error más común. Si tu servidor es un VPS (Virtual Private Server), asegúrate de que está encendido desde el panel de control de tu proveedor de hosting. Si es un servidor físico, verifica que tiene energía y que el cable de red está bien conectado.

2.2. Test de Ping: ¿Es un Problema de Red?

El comando ping es tu mejor amigo para este diagnóstico. Abre la terminal de tu ordenador (CMD en Windows, Terminal en macOS o Linux) y escribe:

ping tu-servidor.com

O si tienes la IP directa:

ping 203.0.113.5

Si recibes respuestas (tiempo=XXms): El servidor está en línea y la red es accesible. El problema es más específico (puerto o credenciales).
Si no recibes respuesta (tiempo de espera agotado): El servidor está apagado, bloqueado por un firewall, o la IP es incorrecta. Aquí el problema es de infraestructura, no de SSH en sí.

[WARNING]: Si el ping falla, no sigas con los siguientes pasos. Primero resuelve la conectividad de red. Contacta con tu proveedor de hosting si no puedes encender o acceder al servidor de ninguna manera.

3. Paso 2: El Diagnóstico del Puerto (El Error Más Frecuente)

SSH, por defecto, usa el puerto 22. Sin embargo, por seguridad, muchos servidores (especialmente los gestionados con Syspanel) configuran SSH en un puerto personalizado para evitar ataques automatizados de bots.

3.1. El Puerto Correcto en Syspanel

Aquí es donde entra la regla de oro de este artículo. En Syspanel (el antiguo HestiaCP), el panel de control se accede por el puerto 2106, pero SSH no usa ese puerto por defecto.

Espera, lee esto con atención: En Syspanel, el puerto SSH suele ser el 22 estándar, pero puede ser configurado a otro número (como 2200, 2222, etc.) durante la instalación o por tu proveedor de hosting.

¿Cómo saber qué puerto usar?

Inicia sesión en Syspanel usando la URL: https://tu-servidor.com:2106.
Ve a la sección de "Servidor" o "Configuración".
Busca la pestaña de "SSH Server" o "Configuración SSH". Ahí verás el puerto actual en el que está escuchando.

[TIP]: Si no recuerdas el puerto y tu proveedor no te lo ha dicho, revisa el correo de bienvenida del servicio. Casi siempre lo incluyen. Si no, contacta con soporte, pero ya tienes una pista muy clara.

3.2. Probando el Puerto Específico

Cuando intentes conectarte, debes especificar el puerto si no es el 22. El comando sería:

ssh usuario@tu-servidor.com -p TU_PUERTO

Por ejemplo, si tu puerto es 2222:

ssh root@tu-servidor.com -p 2222

Si el puerto está cerrado o bloqueado, verás un error como "Connection refused" (Conexión rechazada). Esto nos dice que el servidor está activo, pero no está escuchando en ese puerto o un firewall lo está bloqueando.

4. Paso 3: Autenticación y Credenciales

Si el ping funciona y el puerto parece correcto, el siguiente paso es la autenticación. Aquí es donde la mayoría de los usuarios se frustran.

4.1. Error de "Permission denied (publickey,password)"

Este es el error de conexión SSH falla más habitual. Significa que el servidor no acepta tu contraseña o tu clave pública.

Causas comunes:

Contraseña incorrecta: Asegúrate de que no tienes el Bloq Mayús activado y que estás escribiendo la contraseña exacta (que suele ser sensible a mayúsculas y minúsculas).
Usuario incorrecto: No intentes conectarte como root si el acceso remoto a root está deshabilitado (algo muy recomendable y que Syspanel configura por defecto). Debes usar un usuario de sistema con permisos de sudo.
Uso de claves SSH: Si usas una clave pública, asegúrate de que la clave privada está en la ruta correcta en tu máquina local (normalmente ~/.ssh/id_rsa) y que tienes los permisos correctos (600 para la privada).

4.2. Solución Paso a Paso

Verifica el usuario: En Syspanel, ve a la sección de "Usuarios" para ver qué usuarios existen. Deberías tener un usuario que no sea root para uso diario.
Resetea la contraseña: Si sospechas que la olvidaste, puedes resetearla desde Syspanel en la sección de edición del usuario. Esto es una ventaja de usar el panel.
Prueba con la contraseña: Asegúrate de que tu servidor permite autenticación por contraseña. Esto se configura en el archivo /etc/ssh/sshd_config. Si estás usando solo claves, necesitarás la clave privada.

[INFO]: En Syspanel, al crear un usuario, se genera automáticamente una clave SSH. Puedes descargar la clave privada desde el panel en el perfil del usuario. Si la pierdes, puedes generar una nueva desde el mismo panel y configurarla en tu máquina local.

5. Paso 4: El Firewall (El Guardián Silencioso)

El firewall es un filtro que controla el tráfico de red. A veces, está configurado para bloquear el puerto SSH sin que te des cuenta.

5.1. Firewalls Externos (Proveedor de Hosting)

Muchos proveedores de VPS tienen un firewall externo (como un Security Group en AWS o un panel de control de red) que bloquea puertos por defecto.

Solución: Inicia sesión en el panel de tu proveedor de hosting y busca la sección de "Firewall" o "Reglas de Seguridad". Asegúrate de que hay una regla que permita el tráfico entrante en el puerto SSH que estás usando (22, 2222, etc.) desde tu IP o desde cualquier IP (0.0.0.0/0) si lo prefieres.

5.2. Firewalls Internos (El Servidor)

Si el firewall externo está bien, el problema puede ser un firewall interno como iptables o ufw.

Solución desde el Panel: Syspanel tiene una sección de "Firewall" en su interfaz. Revisa si hay una regla que bloquee tu IP o el puerto SSH. Puedes añadir una regla de "Permitir" para tu IP específica o el puerto.

[WARNING]: Si no tienes acceso al panel y solo tienes acceso al servidor por SSH (lo cual es un poco contradictorio), necesitarás acceder a través de un "console" de emergencia que ofrecen los proveedores de hosting. Desde ahí, podrás ejecutar comandos para desbloquear el firewall.

6. Paso 5: La Configuración del Servidor SSH (sshd_config)

Si todo lo demás falla, el problema puede estar en la configuración interna del demonio SSH.

6.1. El Archivo de Configuración

El archivo clave es /etc/ssh/sshd_config. Si tienes acceso al servidor (por ejemplo, a través de una consola de emergencia), puedes editarlo para solucionar problemas.

Errores de configuración comunes:

PermitRootLogin no: Impide que te conectes como root. Si necesitas hacerlo, cambia a yes temporalmente, pero es mala práctica.
PasswordAuthentication no: Desactiva la autenticación por contraseña. Si no tienes tu clave SSH configurada, no podrás entrar.
AllowUsers o AllowGroups: Restringe qué usuarios pueden conectarse. Si tu usuario no está en esa lista, será rechazado.

6.2. Cómo Diagnosticar y Arreglar

Abre el archivo: nano /etc/ssh/sshd_config
Busca las líneas mencionadas y verifica que estén configuradas como esperas.
Si cambias algo, guarda el archivo (Ctrl+O, luego Enter, y Ctrl+X para salir).
Reinicia el servicio SSH: systemctl restart sshd (o service ssh restart en sistemas más antiguos).

[TIP]: Antes de reiniciar SSH, puedes validar la sintaxis del archivo con el comando sshd -t. Si no hay errores, no se imprimirá nada y puedes reiniciar con seguridad. Si hay errores, te los mostrará, evitando que dejes el servidor inaccesible.

7. Errores Específicos y sus Soluciones Rápidas

Para finalizar, vamos a ver algunos mensajes de error específicos y cómo interpretarlos.

7.1. "Connection timed out" (Tiempo de espera agotado)

Significado: El servidor no responde. El puerto está bloqueado o el servidor está caído.

Solución: Revisa el ping y el firewall externo. Si el ping funciona, el puerto está bloqueado por el firewall. Si el ping no funciona, el servidor está caído o la IP es incorrecta.

7.2. "Connection refused" (Conexión rechazada)

Significado: El servidor está activo, pero no hay ningún servicio escuchando en ese puerto.

Solución: Verifica que el servicio SSH está corriendo (systemctl status sshd). Si no lo está, inícialo. También verifica el puerto en sshd_config; quizás cambiaste el puerto y no lo recuerdas.

7.3. "Host key verification failed" (Falló la verificación de la clave del host)

Significado: Tu ordenador ha detectado que la clave del servidor ha cambiado (porque se reinstaló el sistema o hay un ataque Man-in-the-Middle).

Solución: Es un problema de seguridad. Si estás seguro de que es tu servidor y lo reinstalaste, elimina la clave antigua de tu archivo known_hosts. Puedes hacerlo con el comando ssh-keygen -R tu-servidor.com. Luego, vuelve a conectarte y acepta la nueva clave.

8. FAQ: Preguntas Frecuentes (Resumen Rápido)

P: Mi conexión SSH falla incluso después de seguir todo esto. ¿Qué hago?

R: Contacta con el soporte técnico de tu proveedor de hosting. Diles que has verificado el ping, el puerto y las credenciales. Ellos podrán revisar la red y el servidor desde su lado.

P: ¿Cómo cambio el puerto SSH en Syspanel?

R: Syspanel no tiene una opción directa en la interfaz para cambiar el puerto SSH. Debes hacerlo editando el archivo /etc/ssh/sshd_config y reiniciando el servicio. Asegúrate de actualizar las reglas del firewall después.

P: ¿Es seguro usar el puerto 22 por defecto?

R: No es lo más recomendable. Es el puerto más escaneado por atacantes. Usar un puerto no estándar reduce el ruido, aunque no es una seguridad absoluta. Lo mejor es usar claves SSH y deshabilitar la autenticación por contraseña.

P: ¿Qué es la clave SSH que me da Syspanel?

R: Es un par de llaves (pública y privada) que se generan para que te conectes sin necesidad de contraseña. La clave privada es tu "llave" secreta y debes guardarla en un lugar seguro. La pública se instala en el servidor.

P: No puedo acceder al puerto 2106 para el panel, pero SSH funciona. ¿Es normal?

R: Sí, es normal. El puerto 2106 es solo para el panel de control web. Es posible que el firewall esté bloqueando ese puerto desde tu IP. Revisa las reglas del firewall para permitir el acceso a ese puerto si necesitas entrar al panel.

Conclusión

Resolver un problema de conexión SSH falla es cuestión de seguir un proceso lógico de eliminación. Hemos cubierto los puntos más comunes: desde la conectividad básica, pasando por el puerto específico, hasta la configuración del servidor y el firewall.

Recuerda que la paciencia es tu mejor herramienta. No te rindas. Con esta guía, ya tienes el conocimiento para resolver la gran mayoría de los errores SSH que puedas encontrar en tu servidor con Syspanel.

Y si todo lo demás falla, no dudes en buscar ayuda profesional. A veces, un par de ojos expertos ven lo que nosotros pasamos por alto. ¡Buena suerte y feliz administración de servidores!