Accediendo vía SSH a tu cuenta

SSH permite gestionar los archivos y ejecutar herramientas de tu hosting mediante una conexión cifrada. Resulta útil para Git, Composer, importaciones y tareas que necesitan una terminal. Los comandos se ejecutan con los permisos de tu cuenta de hosting.

Recuerda que el acceso SSH debe estar activado desde las opciones del servicio de hosting disponibles en el área de clientes.

Terminal integrada en cPanel

cPanel incluye una terminal integrada, lo que facilita el acceso si no quieres configurar un cliente SSH.

Conectando a tu cuenta vía SSH

Si quieres iniciarte en el uso de la terminal o el acceso será de forma esporádica, te recomendamos usar la terminal integrada en cPanel.

La forma de conexión depende del sistema operativo que uses, a continuación detallaremos los pasos en cada caso.

• El puerto habitual de SSH en Hostsuar es 93. Comprueba el dato del servicio; un puerto distinto no sustituye a la autenticación con una clave protegida.

Windows

Descarga PuTTYgen desde su web oficial:

• Descargar PuTTY desde su web oficial

Genera en PuTTYgen una clave de tipo EdDSA y curva Ed25519, protégela con una frase de paso larga y única y guarda la clave privada .ppk solo en tu equipo. Copia la clave pública, accede a cPanel, sección SSH Acceso a Shell → Administrar las claves SSH, impórtala y pulsa Administrar autorización para autorizarla. Nunca subas ni envíes la clave privada.

Para terminar abre PuTTY y accede a Connection → SSH → Auth → Credentials. En Private key file for authentication, pulsa Browse y selecciona la clave privada guardada con PuTTYgen.

Ahora accede a Session y cambia el puerto por el 93, en Host Name introduce el nombre del servidor que figura en los datos técnicos del hosting y finalmente pulsa Open. Antes de aceptar la alerta, compara la huella mostrada con la huella del servidor obtenida por un canal independiente y de confianza; nunca pulses Yes sin verificarla. Después introduce el usuario de cPanel y la frase de paso de la clave. Puedes cargar la clave en Pageant para no escribir la frase en cada conexión sin dejarla guardada en sesiones o scripts.

Linux y macOS

Abre la terminal o consola en tu equipo y ejecuta el siguiente comando para generar las llaves públicas y privada (en caso de que no las tengas ya):

ssh-keygen -t ed25519 -a 100

Si ya existe una clave en la ruta propuesta, no la sobrescribas: elige otro nombre y utiliza esa ruta en los comandos siguientes. Introduce una frase de paso larga y única cuando se solicite. Al terminar habrá creado dos archivos en el directorio .ssh: id_ed25519 y id_ed25519.pub; el primero es la clave privada y nunca debe salir de tu equipo, y el segundo es la clave pública.

Es esta llave pública la que tendremos que “subir” a tu cuenta de hosting para que el servicio SSH te permita hacer login con esa identidad. La frase de paso protege la clave privada y es distinta de la contraseña de cPanel.

Accede a cPanel, sección "SSH Acceso a Shell" y haz clic en "Administrar las claves SSH"

Accede a la opción Importar clave y pega el contenido de id_ed25519.pub en "Pegue la clave pública en este cuadro de texto:"

Vuelve a la página anterior y verás que la clave importada aparece en el listado; haz clic en Administrar autorización para autorizar dicha clave.

Si no tienes ya un agente disponible en la sesión, puedes iniciarlo con la primera orden. Añade después la clave para que la frase de paso no se escriba en comandos ni se guarde en scripts:

eval "$(ssh-agent -s)"
ssh-add "$HOME/.ssh/id_ed25519"

Antes de la primera conexión, obtén la huella de la clave del servidor por un canal independiente y de confianza. Compara esa huella con la que muestre el cliente SSH y cancela si no coincide; no respondas yes a ciegas. Después podrás conectar:

ssh -p 93 -i "$HOME/.ssh/id_ed25519" usuario_cpanel@servidor.example.com

Posibles errores

• Todos los pasos se realizan correctamente, consigues acceder pero se muestra el siguiente mensaje:

Shell access is not enabled on your account!
If you need shell access please contact support.

En este caso el acceso Shell se encuentra desactivado, puedes habilitar el acceso SSH desde el área de clientes.

• Cuando escribo el password no se muestra nada.

La terminal no muestra caracteres ni asteriscos al introducir una contraseña o frase de paso. Escríbela y pulsa Intro; el acceso se completará si la autenticación es válida.

Otros errores frecuentes

• Timeout o Connection refused: comprueba el host, el puerto y la salida de red. Un dominio detrás de Cloudflare puede no dirigir SSH al servidor de hosting.
• Permission denied (publickey): revisa el usuario de cPanel, la clave privada seleccionada y la autorización de su parte pública. Importarla no siempre la autoriza automáticamente.
• REMOTE HOST IDENTIFICATION HAS CHANGED: confirma con soporte si ha cambiado la clave del servidor antes de modificar known_hosts.

Para salir utiliza exit. Si dejas de usar una clave o se pierde el equipo, revoca su autorización en cPanel. Cambiar la contraseña de cPanel no revoca por sí solo una clave pública autorizada.