Saltar al contenido
opiniones·hosting

Tutoriales

Acceso SSH en cPanel: cómo activarlo, crear tu clave y conectarte (con ejemplo en Nicalia)

Cómo activar el acceso SSH en cPanel, generar una clave ed25519, importarla y autorizarla, conectarte con el puerto de tu proveedor y resolver los errores habituales.

Por

Consultor SEO y desarrollador web 11 min de lectura

Acceso SSH en cPanel: cómo activarlo, crear tu clave y conectarte (con ejemplo en Nicalia)

SSH te da una línea de comandos dentro de tu hosting: con ella puedes usar WP-CLI, Composer o Git, importar una base de datos grande o mover miles de archivos en segundos. En esta guía te explicamos cómo activarlo en cPanel, cómo crear tu clave SSH en Windows, macOS o Linux y qué hacer cuando la conexión falla. Usamos Nicalia como ejemplo porque es donde está alojada esta web, pero los pasos sirven para cualquier cPanel.

Qué necesitas antes de empezar

  • Un plan con SSH habilitado. Nicalia lo ofrece en sus planes compartidos (puedes ver qué incluye cada uno en nuestra opinión sobre Nicalia), y también lo tienen otros hostings con cPanel como Raiola Networks, LucusHost, SeRed o Factoría Digital. Algunos lo dejan desactivado hasta que lo pides.
  • Acceso a cPanel con tu usuario y contraseña.
  • Un cliente SSH. Windows 10 (desde la versión 1809) y Windows 11 incluyen OpenSSH; macOS y Linux lo traen de serie. PuTTY sigue siendo una opción en Windows, pero no hace falta.
  • Los datos de conexión: usuario de cPanel, IP o nombre del servidor y puerto SSH.

En nuestro propio alojamiento en Nicalia, SSH funciona con autenticación por clave en un puerto distinto del 22, el que Nicalia indica en el panel. No publicamos ese número: cada servidor puede tener el suyo y debes usar el que te muestre tu cuenta.

Cómo configurar el acceso SSH con clave en cPanel

  1. 1

    Comprueba que tu plan tiene SSH

    Ruta en el panel: cPanel Seguridad Acceso SSH

    Entra en cPanel y busca Acceso SSH en la sección Seguridad (también puedes escribir «SSH» en el buscador del panel). Si no aparece, tu proveedor no lo ha habilitado en tu cuenta. En Nicalia, su guía indica que SSH puede venir desactivado por defecto en algunos planes y que se activa abriendo un ticket; lo mismo si no ves Terminal en la sección Avanzado.

  2. 2

    Anota el usuario, el servidor y el puerto

    Necesitas tres datos: tu usuario de cPanel (no tu correo ni el usuario del área de cliente), la IP o el nombre del servidor y el puerto SSH. Nicalia muestra el puerto en el bloque Información General de la portada de cPanel. En otros proveedores suele venir en el correo de bienvenida o en su base de conocimiento.

  3. 3

    Genera tu par de claves en tu ordenador

    Abre PowerShell (Windows 10 y 11 traen el cliente OpenSSH) o el Terminal (macOS y Linux) y ejecuta ssh-keygen -t ed25519 -C "portatil-trabajo". El texto tras -C es solo una etiqueta para reconocer la clave después. Pulsa Intro para aceptar la ruta y escribe una frase de contraseña: protege la clave si alguien copia el archivo. Tienes los comandos completos justo debajo.

  4. 4

    Copia la clave pública

    Muestra el contenido de id_ed25519.pub (el archivo que termina en .pub) y cópialo entero: es una sola línea que empieza por ssh-ed25519. Nunca copies ni subas el archivo sin extensión, id_ed25519: esa es la clave privada y no debe salir de tu equipo.

  5. 5

    Importa la clave en cPanel

    Ruta en el panel: cPanel Seguridad Acceso SSH Manage SSH Keys Import Key

    En Acceso SSH pulsa «Manage SSH Keys» y después «Import Key». Pon un nombre que identifique el equipo (por ejemplo, portatil-trabajo), pega la línea en el campo de la clave pública y deja vacío el de la clave privada. Pulsa «Import». Las etiquetas de estos botones pueden salir en inglés o traducidas según el idioma y la versión de tu cPanel.

    https://tudominio.es:2083

    cPanel

    Recreación orientativa

    Ruta en el panel: Seguridad Acceso SSH Manage SSH Keys

    Import SSH Key

    Nombre de la clave (Key Name) portatil-trabajo
    Clave pública (Public Key) ssh-ed25519 AAAAC3Nza…Xq7 portatil-trabajo

    Elemento que debes pulsar o rellenar: Solo la línea del archivo .pub

    Clave privada (Private Key)
    Import

    Elemento que debes pulsar o rellenar: Guarda la clave en tu cuenta

    La clave privada se queda en tu ordenador: aquí solo se pega la pública. Los textos del formulario pueden variar según la versión y el idioma de tu cPanel. Recreación orientativa, no es una captura real: los nombres de menús y botones pueden variar ligeramente según la versión y el idioma de tu panel.
  6. 6

    Autoriza la clave

    Ruta en el panel: Acceso SSH Manage SSH Keys Public Keys Manage Authorize

    Importar no basta: en la lista Public Keys, pulsa «Manage» junto a tu clave y luego «Authorize». Hasta que no lo hagas, el servidor la ignora y obtendrás Permission denied (publickey). Este paso es el que más se olvida.

    https://tudominio.es:2083

    cPanel

    Recreación orientativa

    Ruta en el panel: Seguridad Acceso SSH

    Manage SSH Keys

    Public Keys

    portatil-trabajo: sin autorizar

    Manage

    Elemento que debes pulsar o rellenar: Abre la gestión de la clave

    Authorize

    Elemento que debes pulsar o rellenar: Confirma: la clave queda autorizada

    Una clave importada aparece como no autorizada hasta que la autorizas. Recreación orientativa, no es una captura real: los nombres de menús y botones pueden variar ligeramente según la versión y el idioma de tu panel.
  7. 7

    Conéctate desde tu ordenador

    Escribe ssh -p PUERTO usuario@servidor sustituyendo cada parte por tus datos. Si la clave no es la predeterminada, añade -i con su ruta. Para no repetir todo cada vez, guarda la conexión en ~/.ssh/config (te dejamos el ejemplo más abajo) y te bastará con ssh mihosting.

  8. 8

    Acepta la huella del servidor la primera vez

    En la primera conexión verás un aviso del tipo The authenticity of host … can't be established con la huella (fingerprint) del servidor. Es normal: tu equipo aún no lo conoce. Escribe yes y la huella se guardará en known_hosts. Si quieres ser estricto, pide a soporte la huella de su servidor y compárala antes de aceptar.

powershell Generar la clave en Windows (PowerShell) 
# Comprueba que tienes el cliente OpenSSH
ssh -V

# Genera la clave (pulsa Intro para aceptar la ruta y escribe una frase de contraseña)
ssh-keygen -t ed25519 -C "portatil-trabajo"

# Muestra la clave pública para copiarla
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub
La clave se guarda en C:\Users\tu-usuario\.ssh. Si ssh -V no responde, añade «OpenSSH Client» en Configuración → Características opcionales.
bash Generar la clave en macOS o Linux (Terminal) 
# Genera la clave
ssh-keygen -t ed25519 -C "portatil-trabajo"

# Ajusta permisos (OpenSSH rechaza claves con permisos demasiado abiertos)
chmod 700 ~/.ssh
chmod 600 ~/.ssh/id_ed25519

# Muestra la clave pública para copiarla
cat ~/.ssh/id_ed25519.pub
En macOS puedes copiarla directamente al portapapeles con: pbcopy < ~/.ssh/id_ed25519.pub

Datos de conexión SSH (ejemplo)

Datos de ejemplo
Servidor
203.0.113.10 O el nombre del servidor que te dé tu proveedor
Puerto
PUERTO El que indique tu proveedor; en Nicalia, en «Información General» de cPanel
Usuario
tuusuario Tu usuario de cPanel, no tu correo
Clave privada
~/.ssh/id_ed25519 Solo en tu ordenador
Sustituye cada valor por el de tu cuenta. Son datos ficticios: sustitúyelos por los tuyos.
bash Conectar por SSH 
# Conexión básica (sustituye PUERTO, usuario y servidor)
ssh -p PUERTO [email protected]

# Indicando la clave de forma explícita
ssh -p PUERTO -i ~/.ssh/id_ed25519 [email protected]

# Modo detallado para diagnosticar errores
ssh -v -p PUERTO [email protected]
Datos de ejemplo. PUERTO es el número que te indique tu hosting.
bash Guardar la conexión en ~/.ssh/config 
Host mihosting
    HostName 203.0.113.10
    Port PUERTO
    User tuusuario
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
Con esto te conectas escribiendo solo: ssh mihosting. En Windows el archivo está en C:\Users\tu-usuario\.ssh\config (créalo sin extensión). IdentitiesOnly evita que tu equipo pruebe otras claves y el servidor te bloquee por demasiados intentos.

Tres formas de entrar por SSH en cPanel

Clave creada en tu ordenador (recomendada)

Generas la clave con ssh-keygen, importas solo la parte pública y la privada nunca viaja. Funciona igual en Windows, macOS y Linux, y con herramientas como Git, VS Code o despliegues automáticos.

Clave generada en cPanel + PuTTY

Es el método que explica la guía de Nicalia: «Generate a New Key» (RSA, 2048 bits por defecto), autorizarla y descargar la privada convertida a formato PPK para PuTTY. Útil si no quieres tocar la consola, pero la clave privada se crea en el servidor.

Terminal de cPanel

En Avanzado → Terminal tienes una consola en el navegador, sin instalar nada ni configurar claves. Perfecta para un comando puntual; para trabajar a diario, mejor un cliente SSH en tu equipo.

Alternativa: generar la clave en cPanel y usarla con PuTTY

  1. 1

    Genera la clave desde el panel

    Ruta en el panel: Acceso SSH Manage SSH Keys Generate a New Key

    Rellena «Key Name» (por defecto id_rsa), una contraseña para la clave, «Key Type» RSA y «Key Size». cPanel solo ofrece RSA o DSA; elige RSA y el tamaño más alto disponible. Pulsa «Generate Key».

  2. 2

    Autorízala

    Vuelve a la lista, pulsa «Manage» en la clave pública y después «Authorize», igual que con una clave importada.

  3. 3

    Descarga la clave privada en formato PPK

    En la lista de claves privadas pulsa «View/Download», escribe la contraseña de la clave en el apartado de conversión a PPK y descarga el archivo. Guárdalo en una carpeta privada y bórralo de Descargas.

  4. 4

    Configura PuTTY

    En Session escribe el servidor y el puerto; en Connection → SSH → Auth selecciona el PPK; en Connection → Data pon tu usuario de cPanel como «Auto-login username». Guarda la sesión y conéctate.

Cómo comprobar que funciona

Si la conexión va bien, verás el indicador de la consola del servidor con tu usuario. Prueba estos comandos:

  • whoami: debe devolver tu usuario de cPanel.
  • pwd: te muestra tu carpeta personal (algo como /home/tuusuario).
  • ls public_html: lista los archivos de tu web principal.
  • wp --info: si tu proveedor incluye WP-CLI, como Nicalia, verás su versión y la de PHP.

Para confirmar que entras con la clave y no con contraseña, conéctate con ssh -v y busca una línea que diga que la autenticación ha tenido éxito con publickey.

Errores frecuentes y cómo solucionarlos

Permission denied (publickey)

Causa: el servidor no acepta ninguna de las claves que ofrece tu equipo. Casi siempre es una clave importada pero no autorizada, un usuario equivocado o que tu equipo está ofreciendo otra clave. Solución: revisa en «Manage SSH Keys» que la clave figura como autorizada, usa tu usuario de cPanel y fuerza la clave con -i ~/.ssh/id_ed25519. Si aparece (publickey,password) y entras con contraseña, recuerda que es la de cPanel, no la del área de cliente.

Connection refused o Connection timed out

Causa: el puerto no es el correcto, SSH no está activado en tu plan o el cortafuegos del servidor ha bloqueado tu IP tras varios intentos fallidos. Solución: comprueba el puerto en el panel (en Nicalia, «Información General»), no uses el 22 por costumbre y, si todo parece correcto, abre un ticket indicando tu IP pública para que revisen si está bloqueada o si falta activar SSH.

WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED

Causa: la huella del servidor ya no coincide con la que guardó tu equipo. Pasa tras una migración de servidor, pero también podría indicar que alguien intercepta la conexión. Solución: si no esperabas un cambio, para y pregunta a soporte. Si te confirman la migración, borra la huella antigua con ssh-keygen -R 203.0.113.10 (tu servidor) y vuelve a conectar.

UNPROTECTED PRIVATE KEY FILE o «bad permissions»

Causa: OpenSSH se niega a usar una clave privada que otros usuarios del equipo pueden leer. En macOS y Linux suele pasar al copiar la clave desde otro sitio; en Windows, al guardarla fuera de tu perfil (en una carpeta compartida, por ejemplo). Solución: en macOS y Linux, chmod 600 sobre la clave y chmod 700 sobre ~/.ssh. En Windows, deja la clave en C:\Users\tu-usuario\.ssh, donde solo tu usuario tiene acceso; si la moviste, revisa en Propiedades → Seguridad que no tengan permiso otros usuarios o grupos.

Algunos comandos no funcionan o «command not found»

Causa: en hosting compartido no tienes una consola completa del servidor, sino una restringida: muchos proveedores asignan una jailed shell (consola enjaulada) de cPanel y, con CloudLinux, cada cuenta queda aislada en su propio entorno. No puedes usar sudo, instalar paquetes del sistema ni ver otras cuentas. Solución: trabaja dentro de tu carpeta personal con las herramientas que ofrezca el proveedor (WP-CLI, Composer, Git, PHP). Si necesitas acceso root, eso ya es un VPS: te lo explicamos en qué es un VPS y cuándo lo necesitas.

Me sigue pidiendo contraseña

Causa: si te pide la passphrase, es la frase de tu clave y es lo esperado. Si te pide la password del usuario, el servidor no ha aceptado la clave y está probando el siguiente método. Solución: revisa la autorización y la ruta de la clave como en el primer error.

Cómo revocar una clave SSH

Hazlo cuando cambies de ordenador, pierdas un portátil o un colaborador deje de trabajar contigo:

  1. Entra en Acceso SSH → Manage SSH Keys.
  2. En la clave pública, pulsa «Manage» y después «Deauthorize». Desde ese momento ya no permite entrar.
  3. Si no la vas a volver a usar, pulsa «Delete Key» y confirma.
  4. Si la clave estaba en otros servicios (GitHub, otro hosting), quítala también allí y genera una nueva.

Una clave por equipo y por persona, con un nombre que la identifique, hace que revocar sea cuestión de un minuto y no afecte a nadie más.

Siguientes pasos con tu hosting cPanel

Artículo

Cómo instalar WordPress en cPanel

Instala WordPress en minutos con Softaculous: protocolo, dominio, directorio y administrador explicados, los primeros ajustes tras instalar y soluciones a los errores típicos.
Artículo

Copias de seguridad en cPanel con JetBackup

Cómo restaurar y descargar copias con JetBackup 5, crear copias propias con la herramienta Backup de cPanel y montar una estrategia 3-2-1 para tu WordPress.
Artículo

Cambiar la versión de PHP en cPanel

Las dos herramientas de PHP de cPanel, cuándo usar cada una, cómo cambiar extensiones y límites, y el error 500 que nos dio cambiar de alt-php a ea-php (y cómo lo revertimos).
Opinión 8,2

Opinión Nicalia

Nicalia es un hosting español con infraestructura propia en Madrid y soporte 24/7 con respuesta garantizada; más caro que la media, desde 6,24 €/mes en su plan Mini.
Artículo

Cupón descuento Nicalia 2026: código exclusivo -10 % y cómo aplicarlo

Con el código opiniones-hosting tienes un 10 % de descuento exclusivo en Nicalia. Te explicamos cómo aplicarlo, cuánto pagarás y qué plan te conviene.

Preguntas frecuentes

¿Cómo genero una clave SSH?

Abre PowerShell en Windows o el Terminal en macOS y Linux y ejecuta ssh-keygen -t ed25519. Acepta la ruta que te propone, pon una frase de contraseña y obtendrás dos archivos en la carpeta .ssh de tu usuario: id_ed25519, la clave privada que nunca compartes, e id_ed25519.pub, la pública, que es la que copias en cPanel.

¿Dónde está el acceso SSH en cPanel?

En la sección Seguridad, opción Acceso SSH. Desde ahí gestionas las claves con el botón «Manage SSH Keys». Si tu proveedor no ha incluido SSH en tu plan, esa opción no aparece o no podrás conectarte aunque la veas. En Nicalia, si no ves la opción o la Terminal de cPanel, abre un ticket y pide que te lo activen.

¿Qué puerto SSH usa mi hosting?

El estándar es el 22, pero muchos hostings compartidos usan otro para reducir ataques automáticos. En Nicalia el puerto aparece en cPanel, en el bloque Información General, y en nuestro propio alojamiento no es el 22. Si no lo encuentras, búscalo en el correo de bienvenida o pregunta a soporte; probar puertos al azar solo te dará errores de conexión.

¿Es mejor una clave ed25519 o RSA?

Para claves nuevas, ed25519: es corta, rápida y es el tipo que OpenSSH usa por defecto en Windows según Microsoft. El generador integrado de cPanel solo ofrece RSA y DSA, por eso te recomendamos crear la clave en tu ordenador e importar la parte pública. Si algún sistema antiguo no la acepta, usa RSA de 4096 bits.

¿Puedo usar SSH sin contraseña?

Sí, ese es el objetivo de las claves: el servidor no te pide la contraseña de cPanel, sino que comprueba tu clave privada. Lo que sí te pedirá tu ordenador es la frase de contraseña de la clave, si le pusiste una; con ssh-agent la escribes una vez por sesión. Dejar la clave sin frase es cómodo, pero si te roban el portátil, entran en tu hosting.

¿Qué hago si me sale «Permission denied (publickey)»?

El servidor no ha aceptado ninguna de tus claves. Revisa, en este orden, que la clave pública esté autorizada en cPanel (importarla no basta), que el usuario sea el de cPanel y no tu correo, que estés usando la clave privada correcta (-i o IdentityFile) y que los permisos del archivo no sean demasiado abiertos. Con ssh -v verás qué clave ofrece tu equipo.

Fuentes consultadas

Pasos comprobados en la documentación oficial en la fecha indicada. Si algo ha cambiado, dínoslo.