Cómo configurar claves SSH e iniciar sesión en un servidor sin contraseña

Genera una clave ed25519, cópiala a tu servidor e inicia sesión sin contraseña. Paso a paso para macOS, Linux y Windows, con refuerzo de seguridad y configuración de git.

Flat illustration of a key and a terminal window linking two computers with a secure connection line

Escribir una contraseña cada vez que te conectas a un servidor cansa enseguida, y las contraseñas se pueden adivinar. Las claves SSH resuelven ambos problemas. Al terminar esta guía tendrás una clave ed25519 protegida con una frase de contraseña, un servidor que la acepta, un alias corto para que solo tengas que escribir ssh myserver y la misma configuración funcionando con tu servicio de git.

Qué necesitas

  • Un ordenador con macOS, Linux o Windows 10/11 con el cliente OpenSSH integrado.
  • Un servidor u otro ordenador al que ya puedas acceder con usuario y contraseña.
  • Una terminal (Terminal en macOS, cualquier shell en Linux, PowerShell en Windows).
  • Unos 15 minutos.

Los ejemplos usan alice como nombre de usuario, server.example.com como servidor y 203.0.113.10 como su dirección. Cámbialos por los tuyos.

Vídeo: «How SSH password-less key based authentication work in 4 minutes» (Cómo funciona la autenticación SSH con claves y sin contraseña en 4 minutos), de Hussein Nasser.

Paso 1: Genera una clave ed25519

Ejecuta esto en el ordenador desde el que te vas a conectar. La opción -C añade un comentario, normalmente tu correo, para que luego puedas distinguir unas claves de otras.

Código
ssh-keygen -t ed25519 -C "alice@example.com"

Las versiones recientes de OpenSSH ya usan ed25519 por defecto, pero indicar el tipo hace que el comando funcione en cualquier sitio. Pulsa Enter para aceptar la ubicación predeterminada. Verás algo así:

Código
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/alice/.ssh/id_ed25519):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/alice/.ssh/id_ed25519
Your public key has been saved in /home/alice/.ssh/id_ed25519.pub

Ahora tienes dos archivos. id_ed25519 es la clave privada: trátala como una contraseña y no la compartas nunca. id_ed25519.pub es la clave pública, que puedes copiar a cualquier sitio sin riesgo.

Paso 2: Añade una frase de contraseña y carga la clave en ssh-agent

Cuando te pida una frase de contraseña (passphrase), pon una. Si alguien llega a copiar tu clave privada, la frase seguirá cerrándole el paso. Si te la saltaste, puedes añadirla después con ssh-keygen -p -f ~/.ssh/id_ed25519.

ssh-agent recuerda la clave desbloqueada, así que solo escribes la frase una vez por sesión.

macOS

Inicia el agente y añade tu clave al Llavero de macOS:

Código
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

Después, añade estas líneas a ~/.ssh/config (crea el archivo si no existe) para que la clave se cargue automáticamente:

Código
Host *
  AddKeysToAgent yes
  UseKeychain yes
  IdentityFile ~/.ssh/id_ed25519

UseKeychain es un añadido de Apple, así que solo funciona en macOS.

Linux

Muchas sesiones de escritorio ya ejecutan un agente. Si la tuya no, inicia uno y añade la clave:

Código
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Windows

El servicio ssh-agent viene desactivado por defecto. Abre PowerShell como administrador y ejecuta:

Código
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent

Luego, en una ventana normal de PowerShell:

Código
ssh-add $env:USERPROFILE\.ssh\id_ed25519

Paso 3: Copia tu clave pública al servidor

El servidor guarda una lista de claves públicas de confianza en ~/.ssh/authorized_keys. La forma más fácil de añadir la tuya es ssh-copy-id, disponible en macOS y en la mayoría de sistemas Linux:

Código
ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com

Te pide la contraseña del servidor por última vez, crea el archivo si hace falta y omite las claves que ya estén instaladas.

Si no tienes ssh-copy-id, por ejemplo en Windows PowerShell, copia el archivo de la clave con scp y luego añádelo a la lista en el servidor:

Terminal
scp $env:USERPROFILE\.ssh\id_ed25519.pub alice@server.example.com:key.pub
ssh alice@server.example.com "mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat ~/key.pub >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys && rm ~/key.pub"

Estos comandos son para un servidor Linux o macOS. Cada uno te pide la contraseña del servidor. Un servidor Windows guarda las claves en otro lugar, y las cuentas de administrador usan C:\ProgramData\ssh\administrators_authorized_keys. En ese caso, sigue la guía de Microsoft enlazada más abajo.

Paso 4: Inicia sesión y comprueba la huella del host

Ahora conéctate:

Terminal
ssh alice@server.example.com

La primera vez que te conectas a un servidor nuevo, SSH muestra su huella digital y te pide que la confirmes:

Código
The authenticity of host 'server.example.com (203.0.113.10)' can't be established.
ED25519 key fingerprint is SHA256:4fXk2...Q9wE.
Are you sure you want to continue connecting (yes/no/[fingerprint])?

No escribas yes en piloto automático. Si puedes, comprueba la huella en el propio servidor, desde una consola o una sesión que ya tengas abierta:

Código
ssh-keygen -l -f /etc/ssh/ssh_host_ed25519_key.pub

Si coinciden, escribe yes. SSH guarda la clave en ~/.ssh/known_hosts y te avisará si alguna vez cambia. Ahora deberías entrar en una shell sin que te pida la contraseña del servidor. Puede que te pida una vez la frase de tu clave si el agente todavía no la tiene.

Paso 5: Crea un alias Host en ~/.ssh/config

Añade una entrada a ~/.ssh/config en tu propio ordenador:

Código
Host myserver
  HostName server.example.com
  User alice
  Port 22
  IdentityFile ~/.ssh/id_ed25519
  IdentitiesOnly yes

Ahora esto es todo lo que necesitas:

Terminal
ssh myserver

IdentitiesOnly yes le dice a SSH que ofrezca solo la clave que has indicado.

Paso 6: SSH entre dos de tus propios equipos en casa

Los mismos pasos funcionan entre dos ordenadores de tu red doméstica. El equipo al que te conectas solo necesita tener un servidor SSH en marcha.

En un Mac, abre Ajustes del Sistema, ve a General y luego a Compartir, y activa Remote Login (Sesión remota). Haz clic en el botón de información que hay al lado para ver el comando ssh exacto para ese Mac.

En Ubuntu, instala el paquete del servidor:

Terminal
sudo apt install openssh-server

Busca la dirección local del equipo de destino en sus ajustes de red. Después, desde el otro ordenador, copia tu clave y conéctate como antes usando esa dirección. En este ejemplo es un marcador de posición:

Código
ssh-copy-id alice@192.168.1.50
ssh alice@192.168.1.50

Paso 7 (opcional): Desactiva el inicio de sesión con contraseña

Cuando el acceso con clave funcione, puedes hacer que el servidor deje de aceptar contraseñas por completo. Así, los bots que intentan adivinarlas no tienen nada que adivinar.

Mantén abierta tu sesión SSH actual mientras haces esto. Si algo sale mal, esa sesión abierta es tu forma de arreglarlo. Prueba desde una segunda terminal antes de cerrar nada.

En Ubuntu, los ajustes de /etc/ssh/sshd_config.d/ tienen prioridad sobre el archivo principal, y gana el primer valor que se lee. Los archivos se cargan por orden de nombre, así que uno cuyo nombre empiece por 00- se lee primero:

Terminal
sudo nano /etc/ssh/sshd_config.d/00-no-passwords.conf

Añade estas dos líneas:

Código
PasswordAuthentication no
KbdInteractiveAuthentication no

Comprueba que la configuración no tenga errores y reinicia el servicio:

Terminal
sudo sshd -t
sudo systemctl restart ssh.service

Desde una terminal nueva, ejecuta ssh myserver para confirmar que sigues pudiendo entrar. Luego prueba ssh -o PubkeyAuthentication=no myserver: debería rechazarte. Mantener actualizado el software del servidor importa igual.

Paso 8: Conecta un servicio de git

Los servicios de git como GitHub aceptan la misma clave. Muestra tu clave pública y cópiala:

Código
cat ~/.ssh/id_ed25519.pub

Pégala en la sección de claves SSH de los ajustes de tu cuenta, siguiendo la guía de tu servicio de git (la de GitHub está enlazada abajo). Después, prueba:

Terminal
ssh -T git@github.com

Una prueba correcta se ve así:

Código
Hi alice! You've successfully authenticated, but GitHub does not provide shell access.

Tu cuenta de git es una parte clave de tu identidad en internet, así que merece la pena revisar también el resto de tus cuentas.

Errores comunes y cómo solucionarlos

Permission denied (publickey)

El servidor no aceptó ninguna de las claves que ofreciste. Comprueba que la clave pública está en ~/.ssh/authorized_keys en el servidor, que usas el nombre de usuario correcto y que el agente tiene tu clave. Ejecuta ssh -v myserver para ver qué claves se prueban.

Permisos incorrectos en ~/.ssh

Por defecto, el servidor SSH ignora tus claves si tus archivos tienen permisos demasiado abiertos. En el servidor, corrígelos con:

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

WARNING: UNPROTECTED PRIVATE KEY FILE!

Tu clave privada la pueden leer otros usuarios, así que SSH se niega a usarla. En tu propio ordenador, ejecuta:

Terminal
chmod 600 ~/.ssh/id_ed25519

WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!

La clave del servidor ya no coincide con la de known_hosts. Pasa cuando se reinstala un servidor, pero también puede indicar un ataque. Confirma que el cambio es esperado, luego elimina la entrada antigua y vuelve a conectarte:

Código
ssh-keygen -R server.example.com

The agent has no identities

ssh-add -l muestra este mensaje cuando el agente está en marcha pero no tiene claves. Vuelve a añadir la tuya con ssh-add ~/.ssh/id_ed25519. Si ves «Could not open a connection to your authentication agent», inicia primero el agente, como se muestra en el paso 2.

En resumen

Ahora inicias sesión con una clave en lugar de una contraseña, tu clave está protegida con una frase de contraseña y un alias mantiene los comandos cortos. Usa una clave por ordenador en vez de ir copiando una clave privada de un lado a otro. Si pierdes un dispositivo, borra la línea de su clave pública de authorized_keys y de tu servicio de git.

Cuando el acceso con clave se vuelva rutina, los mismos hábitos de terminal te servirán en configuraciones de desarrollo más nuevas. Nuestra guía sobre Chrome DevTools MCP explica cómo dar a un agente de programación un navegador real.

Fuentes y documentación oficial

Enlaces revisados por última vez el 15 de noviembre de 2026.

Escrito por Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Acerca de Mindloop Experience

Respuestas

Escribe una respuesta

Más de Mindloop Experience

Ver todo de Mindloop Experience

Puedes aplaudir hasta 50 veces.