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.
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.
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í:
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:
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:
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:
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519
Windows
El servicio ssh-agent viene desactivado por defecto. Abre PowerShell como administrador y ejecuta:
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
Luego, en una ventana normal de PowerShell:
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:
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:
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:
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:
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:
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:
Host myserver
HostName server.example.com
User alice
Port 22
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
Ahora esto es todo lo que necesitas:
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:
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:
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:
sudo nano /etc/ssh/sshd_config.d/00-no-passwords.conf
Añade estas dos líneas:
PasswordAuthentication no
KbdInteractiveAuthentication no
Comprueba que la configuración no tenga errores y reinicia el servicio:
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:
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:
ssh -T git@github.com
Una prueba correcta se ve así:
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:
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:
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:
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.
- OpenSSH ssh-keygen manual
- OpenSSH ssh manual
- OpenSSH ssh_config manual
- OpenSSH sshd_config manual
- ssh-copy-id manual page
- GitHub Docs: Generating a new SSH key and adding it to the ssh-agent
- GitHub Docs: Testing your SSH connection
- Microsoft Learn: Key-based authentication in OpenSSH for Windows
- Ubuntu Server docs: OpenSSH server
- Apple Support: Allow a remote computer to access your Mac





Escribe una respuesta