El error Permission denied (publickey) significa que el servidor OpenSSH solo acepta autenticación por clave y no ha aceptado ninguna de las claves que ofreció tu cliente para ese usuario. Casi siempre se debe a cuatro causas: usuario equivocado, clave no cargada, permisos incorrectos en ~/.ssh o authorized_keys, o un algoritmo de clave rechazado.
Qué indica Permission denied (publickey) en un servidor OpenSSH
OpenSSH devuelve este mensaje cuando el método publickey ha fallado y no queda ningún otro método de autenticación permitido. El texto entre paréntesis enumera los métodos que admite el servidor. Si solo aparece publickey, la contraseña está desactivada y no hay alternativa. Por diseño, sshd no explica al cliente por qué rechaza una clave. El diagnóstico se hace por los dos lados: la salida detallada del cliente y el log del servidor.
Paso 1: leer la salida de ssh -vvv para ver qué clave SSH se ofrece
La opción -v de ssh aumenta la verbosidad y admite hasta tres niveles. Con -vvv se ve cada clave que prueba el cliente y la respuesta del servidor. Filtrar la salida ahorra leer cientos de líneas:
ssh -vvv -p 22 [email protected] 2>&1 | grep -E 'Connecting to|Offering|Trying|Authentications|Server accepts|No more'Estas son las líneas que importan:
- Connecting to: el host y el puerto reales después de aplicar ~/.ssh/config. El puerto por defecto es el TCP 22.
- Offering public key: la clave que se envía. Si no aparece ninguna, el cliente no encuentra la clave (paso 3).
- Authentications that can continue: publickey después de cada oferta: el servidor ha rechazado esa clave.
- Server accepts key: la clave es válida. Si la conexión falla después, el problema está en la passphrase o en el agente.
- No more authentication methods to try: el cliente ha agotado todas las claves.
Paso 2: confirmar el usuario remoto de la conexión SSH
Si no indicas usuario, ssh usa tu nombre de usuario local. Desde el móvil o desde otro equipo, ese nombre rara vez coincide con la cuenta del servidor. ssh -G muestra la configuración efectiva sin llegar a conectar:
ssh -G servidor.ejemplo.com | grep -E '^(user|hostname|port|identityfile) 'Cada usuario tiene su propio authorized_keys. Una clave autorizada en /home/ana/.ssh/authorized_keys no sirve para entrar como root ni como cualquier otra cuenta. Las imágenes de nube suelen crear un usuario propio distinto de root: revisa la documentación del proveedor antes de seguir buscando.
Paso 3: comprobar que la clave SSH está cargada en el agente y se ofrece
ssh-add -l lista las claves cargadas en el agente. Si responde que no hay identidades, el cliente solo probará los ficheros por defecto de ~/.ssh. Para forzar una clave concreta y comparar huellas:
ssh-add -l
ssh-add ~/.ssh/id_ed25519
ssh -i ~/.ssh/id_ed25519 -o IdentitiesOnly=yes [email protected]
ssh-keygen -lf ~/.ssh/id_ed25519.pub
# en el servidor:
ssh-keygen -lf ~/.ssh/authorized_keysIdentitiesOnly=yes evita que el agente ofrezca muchas claves antes de la correcta. sshd corta la conexión cuando se alcanza su límite MaxAuthTries. Si la huella SHA256 de tu clave pública no aparece entre las de authorized_keys, has copiado otra clave.
En termi1, las claves se pueden generar en el propio móvil y se guardan en el almacén seguro del sistema. La clave privada no sale del dispositivo, así que lo que copias al servidor es siempre la pública. En un Mac, termi1 Companion instala esa clave pública al emparejar con un código de seis cifras.
Paso 4: corregir permisos de ~/.ssh y authorized_keys en el servidor
OpenSSH espera ~/.ssh con permisos 700, y authorized_keys y las claves privadas con 600. Con StrictModes activado, que es el valor por defecto, sshd ignora authorized_keys si el fichero, ~/.ssh o el directorio personal son escribibles por otros usuarios.
chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys
chown -R ana:ana ~/.ssh
chmod go-w ~
ls -ld ~ ~/.ssh ~/.ssh/authorized_keysEn el cliente se aplica la misma regla. Si la clave privada tiene permisos abiertos, ssh muestra el aviso UNPROTECTED PRIVATE KEY FILE y no la usa. Si pides a la IA de termi1 «arregla los permisos de .ssh», el comando se escribe en el prompt sin pulsar Intro. En conexiones etiquetadas como producción, Production Guard retiene cualquier cambio antes de que llegue al prompt.
Paso 5: leer /var/log/auth.log para saber por qué sshd rechaza la clave
En Debian y Ubuntu, sshd registra los intentos de acceso en /var/log/auth.log. En sistemas que solo usan journald, la misma información está en journalctl:
sudo tail -f /var/log/auth.log
sudo journalctl -u ssh -f # Debian/Ubuntu
sudo journalctl -u sshd -f # RHEL, Fedora, Arch
sudo sshd -T | grep -iE 'pubkey|authorizedkeys|strictmodes'- Invalid user: la cuenta no existe en el servidor (paso 2).
- Authentication refused: bad ownership or modes: permisos o propietario incorrectos (paso 4).
- Connection closed by authenticating user … [preauth]: la clave se ofreció, pero no coincide con ninguna de authorized_keys.
- Mensajes que citan ssh-rsa y PubkeyAcceptedAlgorithms: algoritmo rechazado (paso 6).
Si el log no dice nada útil, pon LogLevel VERBOSE en sshd_config para registrar la huella de cada clave probada. Consulta las opciones documentadas de sshd_config. Con el teclado de termi1, Ctrl+C detiene el tail -f, y con tmux la sesión sigue ahí aunque cambies de red.
Paso 6: descartar que OpenSSH rechace la firma ssh-rsa de la clave
Desde OpenSSH 8.8 (septiembre de 2021), la firma ssh-rsa con SHA-1 está desactivada por defecto. Una clave RSA puede fallar aunque esté bien copiada si el cliente o el servidor solo negocian esa firma. La solución más limpia es usar Ed25519, que OpenSSH admite desde la versión 6.5 (enero de 2014):
ssh-keygen -t ed25519 -C "ana@movil"
ssh-copy-id -i ~/.ssh/id_ed25519.pub [email protected]ssh-copy-id necesita otro método de acceso que funcione. Si no lo tienes, añade la línea de la clave pública a authorized_keys desde una consola del proveedor. Las opciones del cliente están en el manual oficial de ssh.
Diagnóstico de Permission denied (publickey) en móvil frente a escritorio
| Comprobación | Escritorio con OpenSSH | Móvil (iOS/Android) |
|---|---|---|
| Detalle de la negociación | ssh -vvv en la terminal local | Depende del cliente; el log del servidor es la referencia |
| Usuario remoto | ssh -G muestra el valor efectivo | Campo de usuario de la conexión guardada |
| Clave ofrecida | ssh-add -l y ssh -i | Clave asignada a la conexión; en termi1, en el almacén seguro |
| Permisos en el servidor | chmod desde la sesión | chmod desde la sesión, con Ctrl y Tab del teclado de termi1 |
| Revisar authorized_keys | cat o un editor remoto | cat o el SFTP integrado de termi1 |
Si gestionas servidores desde el bolsillo, la terminal SSH para iOS y Android funciona sin cuenta.
Preguntas frecuentes
¿Por qué SSH dice Permission denied (publickey) si la clave está en authorized_keys?
SSH muestra Permission denied (publickey) aunque la clave esté en authorized_keys cuando sshd descarta ese fichero o no es el del usuario correcto. Las causas típicas son permisos abiertos con StrictModes activo, un propietario incorrecto, conectar con otra cuenta o una firma ssh-rsa rechazada.
¿Qué permisos necesita la carpeta .ssh?
La carpeta .ssh necesita permisos 700, es decir, solo el propietario puede leer, escribir y entrar. El fichero authorized_keys y las claves privadas deben tener 600. Además, el directorio personal no debe ser escribible por el grupo ni por otros usuarios, o sshd rechazará la clave.
¿Dónde está el log de SSH en Ubuntu?
El log de SSH en Ubuntu está en /var/log/auth.log, y se puede seguir en directo con sudo tail -f /var/log/auth.log. También está disponible en journald con sudo journalctl -u ssh -f. Con LogLevel VERBOSE en sshd_config se registra la huella de cada clave probada.
¿Puede Mosh evitar el error Permission denied (publickey)?
Mosh no evita el error Permission denied (publickey), porque arranca mosh-server a través de una conexión SSH inicial. Si esa autenticación por clave falla, Mosh no llega a abrir la sesión UDP. Primero hay que resolver el acceso SSH; después Mosh mantiene la sesión al cambiar de red.