Conectarse por SSH desde Linux: comando, claves y alias
Con SSH controlas otro ordenador desde tu terminal, como si estuvieras sentado delante: un servidor, una Raspberry Pi o el equipo de casa. Todo lo que viaja entre los dos va cifrado.
Es como recoger el correo en un edificio: vas al edificio correcto (la IP), entras por el portal correcto (el puerto), buscas tu buzón (el usuario) y lo abres con tu llave (la contraseña o una clave).
1. Instala el servidor SSH en el equipo a controlar
En Ubuntu o Debian:
sudo apt install openssh-server
Comprueba que está en marcha:
sudo systemctl status ssh
Y apunta la IP del equipo, la necesitarás desde el otro lado:
hostname -I
2. Conéctate por SSH desde tu equipo
ssh usuario@ipservidor
Por ejemplo, ssh [email protected]. La primera vez te preguntará si confías en ese equipo y te mostrará su huella. Responde yes si es el equipo que esperas; SSH la recordará y te avisará si un día cambia.
Así se ve en la prueba de este artículo, con dos contenedores: el usuario luis, en el equipo portatil, entra como ana en el equipo servidor, que escucha en el puerto 2222 (la IP es la interna de la red de Docker):
ssh -p 2222 ana@servidor "hostname; whoami"
The authenticity of host '[servidor]:2222 ([172.21.0.2]:2222)' can't be established.
ED25519 key fingerprint is SHA256:SCDwqSTX85jZsNN01Kv5/AcbyyeeArfwyjapHZakFAg.
This key is not known by any other names.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
Warning: Permanently added '[servidor]:2222' (ED25519) to the list of known hosts.
ana@servidor's password:
servidor
ana
Las dos últimas líneas son la respuesta del servidor: la orden entre comillas se ha ejecutado allí. Si no pasas ninguna orden, SSH te abre una terminal en el otro equipo. La huella queda guardada en ~/.ssh/known_hosts.
Si el servidor escucha en otro puerto, indícalo con -p:
ssh -p 2222 usuario@ipservidor
| Parte | Qué es |
|---|---|
ssh |
El cliente SSH |
-p 2222 |
El puerto del servidor. Solo hace falta si no es el 22, el de por defecto |
usuario |
Tu usuario en el servidor, no en tu equipo |
ipservidor |
La IP o el nombre del servidor |
Para salir del equipo remoto escribe exit o pulsa Ctrl + D.
3. Entra sin contraseña con una clave
Escribir la contraseña cada vez cansa y es menos seguro. Con una clave SSH tienes dos ficheros: uno privado, que no sale de tu equipo, y uno público, que copias al servidor. Es como dejar en la portería una foto tuya: cuando llegas, te reconocen sin preguntar.
Crea la clave (pulsa Intro para aceptar la ruta por defecto y, si quieres, ponle una frase de paso):
ssh-keygen -t ed25519
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/luis/.ssh/id_ed25519):
Created directory '/home/luis/.ssh'.
Enter passphrase for "/home/luis/.ssh/id_ed25519" (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/luis/.ssh/id_ed25519
Your public key has been saved in /home/luis/.ssh/id_ed25519.pub
The key fingerprint is:
SHA256:HEXuwSxzgglYXarY4DvTw3TWlxNA4o3TRx+SMWyM4CM luis@portatil
Las líneas que terminan en dos puntos son las preguntas: aquí se respondieron todas con Intro, así que la clave quedó en la ruta por defecto y sin frase de paso. Se crean dos ficheros: id_ed25519, la clave privada, y id_ed25519.pub, la pública. La salida sigue con un dibujo de caracteres (randomart) que representa la huella; no hace falta guardarlo. La clave de la prueba se generó solo para este artículo y ya no existe.
Copia la parte pública al servidor:
ssh-copy-id usuario@ipservidor
# o, con otro puerto:
ssh-copy-id -p 2222 usuario@ipservidor
Te pedirá la contraseña una última vez (en la prueba se pasó de forma automática, por eso la pregunta no sale en la salida):
ssh-copy-id -p 2222 ana@servidor
/usr/bin/ssh-copy-id: INFO: Source of key(s) to be installed: "/home/luis/.ssh/id_ed25519.pub"
/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed
/usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new keys
Number of key(s) added: 1
Now try logging into the machine, with: "ssh -p 2222 'ana@servidor'"
and check to make sure that only the key(s) you wanted were added.
ssh-copy-id añade la clave pública al final de ~/.ssh/authorized_keys en el servidor, creando el fichero y la carpeta si no existen. Desde entonces, ssh usuario@ipservidor entra directamente. Para comprobar que ha usado la clave, añade -v (modo detallado) y busca estas líneas:
ssh -v -p 2222 ana@servidor true
debug1: Authentications that can continue: publickey,password
debug1: Offering public key: /home/luis/.ssh/id_ed25519 ED25519 SHA256:n+88aQKfv9bSqqEDwnoHMTG07eqvGVZuSvvXcCezYyU
debug1: Server accepts key: /home/luis/.ssh/id_ed25519 ED25519 SHA256:n+88aQKfv9bSqqEDwnoHMTG07eqvGVZuSvvXcCezYyU
Authenticated to servidor ([172.21.0.2]:2222) using "publickey".
La clave privada no se comparte nunca.
4. Un alias para no recordar IPs ni puertos
Si te conectas a menudo, guarda los datos en ~/.ssh/config:
Host servidor
HostName 192.168.1.20
User ana
Port 2222
Y entra con:
ssh servidor
Si tienes varias claves, añade IdentityFile ~/.ssh/id_trabajo dentro del bloque para decir cuál usar. Sin alias, lo mismo se hace con la opción -i: ssh -i ~/.ssh/id_trabajo usuario@ipservidor. Si usas ssh-agent, puede ofrecer antes sus propias claves; para que solo pruebe la indicada, añade también IdentitiesOnly yes (o -o IdentitiesOnly=yes). Comprobado con OpenSSH 10.0p2. En la prueba, con el alias servidor-pruebas:
ssh servidor-pruebas 'echo conectado como $(whoami)'
conectado como ana
El mismo truco sirve para tener dos cuentas de GitHub en el mismo ordenador, cada una con su clave. Lo explica paso a paso el artículo «Git con varias cuentas».
El alias también vale para copiar ficheros con scp:
scp informe.txt servidor:/home/ana/
Si los ficheros que copias no se pueden abrir en el servidor, revisa los permisos en Linux.
Los permisos que exige SSH
SSH se niega a usar ficheros que otros usuarios del equipo podrían leer o cambiar. Es como una llave que dejas en el buzón abierto: el cerrajero no se fía de ella, aunque sea la buena. Estos son los permisos que recomiendan las páginas de manual de OpenSSH:
| Fichero | Dónde | Permisos | Orden |
|---|---|---|---|
~/.ssh/ |
Los dos equipos | Solo tu usuario (700) | chmod 700 ~/.ssh |
~/.ssh/id_ed25519 (privada) |
Tu equipo | Solo tu usuario (600) | chmod 600 ~/.ssh/id_ed25519 |
~/.ssh/id_ed25519.pub (pública) |
Tu equipo | Puede leerla cualquiera (644) | chmod 644 ~/.ssh/id_ed25519.pub |
~/.ssh/config |
Tu equipo | Que nadie más pueda escribir (600) | chmod 600 ~/.ssh/config |
~/.ssh/authorized_keys |
El servidor | Solo el usuario (600) | chmod 600 ~/.ssh/authorized_keys |
| Tu carpeta personal | El servidor | Que nadie más pueda escribir | chmod go-w ~ |
ssh-keygen y ssh-copy-id ya los dejan bien. Se estropean al copiar ficheros a mano, al restaurar una copia de seguridad o con un chmod -R 777 de más. Si los números de chmod no te suenan, están explicados en permisos en Linux.
Errores frecuentes
Todas las salidas son reales, de la prueba entre los dos contenedores.
1. «Connection refused»
ssh: connect to host servidor port 22: Connection refused
El equipo existe, pero nadie escucha en ese puerto. En la prueba, el servidor estaba en el 2222 y faltaba -p 2222. Si el puerto es el correcto, comprueba que el servidor SSH está instalado y en marcha.
2. «Could not resolve hostname»
ssh: Could not resolve hostname servidr: Temporary failure in name resolution
El nombre está mal escrito o tu equipo no sabe traducirlo a una IP. El final del mensaje cambia según el sistema (fuera de Docker suele ser Name or service not known). Prueba con la IP directamente.
3. «REMOTE HOST IDENTIFICATION HAS CHANGED!»
El servidor presenta una huella distinta de la que SSH guardó la primera vez. En la prueba se regeneraron las claves del servidor:
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that a host key has just been changed.
The fingerprint for the ED25519 key sent by the remote host is
SHA256:CU+ZvorB/aZawa+TZNz3TciEVm8RnCsyRFhiizNv8M0.
Please contact your system administrator.
Add correct host key in /home/luis/.ssh/known_hosts to get rid of this message.
Offending ECDSA key in /home/luis/.ssh/known_hosts:3
remove with:
ssh-keygen -f '/home/luis/.ssh/known_hosts' -R '[servidor]:2222'
Host key for [servidor]:2222 has changed and you have requested strict checking.
Host key verification failed.
¿Por qué habla de una clave ECDSA si la conexión usó ED25519? Porque la opción UpdateHostKeys, activada por defecto, hace que el cliente guarde en known_hosts todas las claves que el servidor anuncia tras autenticarse: aquí, tres (ED25519, ECDSA y RSA). Ahora no coincide ninguna, y SSH señala una de las guardadas, la ECDSA de la línea 3.
Pasa de forma legítima si se ha reinstalado el servidor o si la IP ahora es de otro equipo. Pero es justo el aviso que verías si alguien se hiciera pasar por él, así que confirma el cambio con quien administra el servidor antes de borrar la huella antigua:
ssh-keygen -R "[servidor]:2222"
# Host [servidor]:2222 found: line 1
# Host [servidor]:2222 found: line 2
# Host [servidor]:2222 found: line 3
/home/luis/.ssh/known_hosts updated.
Original contents retained as /home/luis/.ssh/known_hosts.old
Con el puerto 22, basta con ssh-keygen -R servidor o ssh-keygen -R 192.168.1.20. La siguiente conexión vuelve a preguntar como la primera vez.
Un caso parecido: si la conexión la lanza un script, sin nadie que responda yes, la primera vez falla solo con Host key verification failed..
4. «UNPROTECTED PRIVATE KEY FILE!»
La clave privada tiene permisos demasiado abiertos (aquí, 644) y SSH la ignora:
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@ WARNING: UNPROTECTED PRIVATE KEY FILE! @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
Permissions 0644 for '/home/luis/.ssh/id_ed25519' are too open.
It is required that your private key files are NOT accessible by others.
This private key will be ignored.
Load key "/home/luis/.ssh/id_ed25519": bad permissions
ana@servidor: Permission denied (publickey,password).
Se arregla con chmod 600 ~/.ssh/id_ed25519.
5. La clave está copiada y aun así pide contraseña
El problema está en el servidor. Si authorized_keys o la carpeta personal del usuario tienen permisos de escritura para otros, el servidor no se fía de la clave y pasa a pedir contraseña. Desde tu equipo solo ves esto (con -o BatchMode=yes, que impide preguntar):
ana@servidor: Permission denied (publickey,password).
La explicación está en el registro del servidor, por ejemplo con sudo journalctl -u ssh:
Authentication refused: bad ownership or modes for file /home/ana/.ssh/authorized_keys
Authentication refused: bad ownership or modes for directory /home/ana
Es la opción StrictModes del servidor, activada por defecto: revisa los permisos y quién es el dueño de la carpeta personal y de ~/.ssh antes de aceptar una clave. Corrige los permisos de la tabla de arriba; no desactives StrictModes.
6. «Bad owner or permissions» y «Bad configuration option» en ~/.ssh/config
Si otros pueden escribir en tu config (aquí, 666), SSH no lo usa y no se conecta:
Bad owner or permissions on /home/luis/.ssh/config
Y si escribes mal una opción (HostNam en vez de HostName), tampoco:
/home/luis/.ssh/config: line 7: Bad configuration option: hostnam
/home/luis/.ssh/config: terminating, 1 bad configuration options
El mensaje te da la línea exacta.
Entrar solo con clave
Cuando ya entras con tu clave, puedes cerrar la puerta a las contraseñas en el servidor. Antes, abre una segunda sesión SSH y déjala abierta: si algo sale mal, te queda una puerta para deshacerlo.
En Debian y Ubuntu, el sshd_config incluye los ficheros de /etc/ssh/sshd_config.d/, así que basta con crear uno:
printf "PasswordAuthentication no\nPermitRootLogin no\n" | sudo tee /etc/ssh/sshd_config.d/10-solo-claves.conf
sudo sshd -t && echo "configuración válida"
sudo systemctl reload ssh
configuración válida
sshd -t comprueba la configuración sin aplicarla, y sudo sshd -T muestra todos los valores que quedan en vigor. Filtrado a los cuatro que importan aquí:
sudo sshd -T | grep -E '^(permitrootlogin|pubkeyauthentication|passwordauthentication|strictmodes) '
permitrootlogin no
pubkeyauthentication yes
passwordauthentication no
strictmodes yes
Desde entonces, quien no tenga una clave autorizada recibe esto, sin que se le llegue a pedir contraseña:
ana@servidor: Permission denied (publickey).
Según la página de manual de sshd_config, PasswordAuthentication vale yes por defecto y PermitRootLogin, prohibit-password (root puede entrar, pero solo con clave). PermitRootLogin no lo cierra del todo. Si ejecutas el mismo sshd -T en un Debian recién instalado, verás permitrootlogin without-password: según la página de manual de sshd_config, es el alias obsoleto de prohibit-password: la misma opción con otro nombre.
Cuándo no hacerlo así
- Entrar con contraseña a un servidor abierto a internet. Los robots prueban contraseñas sin parar contra el puerto 22. Usa claves y desactiva las contraseñas, como en la sección anterior.
- Compartir una clave entre varias personas o copiar tu clave privada a otro equipo. Cada persona y cada equipo, su propia clave. Si un portátil se pierde, borras su línea de
authorized_keysy los demás siguen funcionando. - Entrar como
root. Entra con tu usuario y usasudo: queda registrado quién hizo qué. - Una clave sin frase de paso en un equipo que no controlas. La frase de paso cifra la clave en el disco; con
ssh-agentsolo la escribes una vez por sesión. - Contestar
yessin mirar al aviso de huella cambiada.
Ejercicio de cinco minutos
- Ejecuta
ls -la ~/.sshen tu equipo y compara los permisos con la tabla. Si alguno no coincide, corrígelo conchmod. - Añade un bloque a tu
~/.ssh/configpara el servidor al que más entras, conHostName,User,PorteIdentityFile, y conéctate conssh -v alias. Busca la línea «Authenticated to» para ver con qué método has entrado. - Si administras un servidor de prueba, crea el fichero de
sshd_config.dde la sección anterior, compruébalo consshd -te intenta entrar desde un equipo sin clave autorizada. Debe responder «Permission denied (publickey)».
Tu chuleta
| Quiero… | Orden |
|---|---|
| Instalar el servidor | sudo apt install openssh-server |
| Conectarme | ssh usuario@ip |
| Conectarme a otro puerto | ssh -p 2222 usuario@ip |
| Crear una clave | ssh-keygen -t ed25519 |
| Copiar la clave al servidor | ssh-copy-id usuario@ip |
| Conectarme con una clave concreta | ssh -i ~/.ssh/id_trabajo usuario@ip |
| Copiar un fichero | scp fichero usuario@ip:/ruta/ |
| Ver qué pasa al conectar | ssh -v usuario@ip |
| Olvidar una huella antigua | ssh-keygen -R ip |
| Arreglar la clave privada | chmod 600 ~/.ssh/id_ed25519 |
| Comprobar la configuración del servidor | sudo sshd -t |
Una vez dentro del servidor, quizá quieras consultar su base de datos: mira la conexión a MySQL desde consola.
Fuentes
Comprobado el 11 de noviembre de 2026 en la documentación oficial: las páginas man de OpenSSH ssh(1) (permisos recomendados de ~/.ssh/, config, authorized_keys y las claves privadas; modo -v), ssh-keygen(1) (-t ed25519, -R), ssh_config(5), sshd_config(5) (StrictModes, activado por defecto; PasswordAuthentication, yes por defecto; PermitRootLogin, prohibit-password por defecto) y scp(1); ssh-copy-id(1) en Debian, que no forma parte de las páginas de OpenBSD (añade las claves al final de ~/.ssh/authorized_keys y crea el fichero y la carpeta si hace falta), y la guía de OpenSSH server de Ubuntu Server, que recomienda las claves ed25519 y usa el servicio ssh.
Prueba del 11 de noviembre de 2026: dos contenedores Docker debian:stable (Debian 13.7) lanzados con --rm en una red de Docker creada para la prueba y borrada después. El servidor, servidor, con openssh-server 1:10.0p1-7+deb13u4 escuchando en el puerto 2222 y una usuaria de prueba, ana; el cliente, portatil, con OpenSSH 10.0p2 y un usuario de prueba, luis. Se ejecutaron la primera conexión con su pregunta de huella, ssh-keygen -t ed25519, ssh-copy-id, la entrada con clave y con -v, el alias de ~/.ssh/config, scp y todos los errores frecuentes: puerto equivocado, nombre mal escrito, huella cambiada (regenerando las claves del servidor) y ssh-keygen -R, permisos abiertos de la clave privada, de config, de authorized_keys y de la carpeta personal del servidor, la opción mal escrita y el servidor con PasswordAuthentication no y PermitRootLogin no, comprobado con sshd -t y sshd -T. Las contraseñas se pasaron con sshpass para automatizar la prueba, y la pregunta de la huella se respondió desde una pseudoterminal. La salida de ssh-keygen es de una ejecución interactiva aparte, en un contenedor con el mismo nombre de equipo, para mostrar sus preguntas: por eso su huella no coincide con la de la salida de -v. Las claves, los nombres de equipo y las IP son solo de la prueba; las IP de los ejemplos del principio, de ejemplo. El 12 de noviembre de 2026 se comprobó en otro contenedor debian:stable recién instalado que sshd -T da permitrootlogin without-password por defecto; la opción UpdateHostKeys está descrita en ssh_config(5). systemctl y journalctl no se han podido ejecutar en los contenedores (no tienen systemd): los mensajes del servidor se leyeron en su salida de registro.
Lo comprobado en la revisión del 8 de noviembre de 2026 (Debian 13.7, OpenSSH 10.0p2) sigue valiendo: servidor en el puerto 2222, conexión con contraseña, clave, ssh-copy-id, alias y scp.