Cómo configurar ssh-agent en Windows y usar claves SSH sin repetir contraseñas
Publicado el 2026-10-26 por frfrand
SSH agent Windows 11, claves y autenticación remota en VPS
Cada vez que hacés SSH a tu VPS te vuelve a pedir la passphrase de la clave. Eso es normal si la clave está protegida, pero no necesitás escribirla en todas las conexiones: ssh-agent puede mantener la clave desbloqueada durante la sesión autorizada.
Te muestro dónde está el problema, cómo comprobarlo sin adivinar y qué haría en una aplicación que de verdad tiene usuarios. No necesitás memorizar un manual entero para resolver un fallo concreto.
Qué significa ssh-agent en Windows en la práctica
La clave privada permanece en tu equipo; el agente ayuda al cliente SSH a usarla sin copiarla al servidor. Windows moderno puede tener OpenSSH Client y el servicio ssh-agent. Hay diferencias según permisos del servicio, política del equipo y tipo de sesión.
Una aclaración antes de tocar el servidor: si el proyecto ya está en producción, guardá el estado que encontraste y comprobá en qué usuario y máquina vas a ejecutar los comandos. Trabajar como root sin necesidad y cambiar varias cosas a la vez dificulta encontrar la causa de un error.
Comandos útiles para empezar
Get-Service ssh-agent
# En PowerShell elevado, sólo si necesitas configurar el servicio
Set-Service -Name ssh-agent -StartupType Manual
Start-Service ssh-agent
# En una sesión normal, agregar una clave existente
ssh-add "$env:USERPROFILE\.ssh\id_ed25519"
ssh-add -l
ssh usuario@servidorLas rutas, nombres de unidades y dominios son ejemplos. Adaptalos a tu servicio. Si un comando requiere permisos de administrador, revisá qué cambia y por qué. Las consultas de diagnóstico deberían venir antes de las modificaciones.
Paso a paso, con comprobaciones
- Comprueba que Windows tiene el cliente OpenSSH y que existe una clave válida.
- Verifica el estado del servicio; si necesitas iniciarlo, hazlo según la política de tu equipo.
- Agrega la clave con
ssh-add; la passphrase se solicita al cargarla. - Verifica la identidad de host del servidor antes de aceptar una conexión.
- Para revocar la sesión local, usa
ssh-add -Dy comprueba que se vació el agente.
Después de cada paso, verifica un resultado observable: un estado, un archivo, una respuesta HTTP o una entrada de log. Si encuentras un mensaje inesperado, guárdalo para investigar en lugar de ocultarlo con reinicios repetidos.
Ejemplo real: una aplicación que hay que mantener
Administras varios VPS de clientes. Cada servidor acepta tu clave pública individual, sin compartir la privada. Desde PowerShell puedes abrir sesiones SSH con autenticación protegida mientras el agente gestiona el desbloqueo.
Al final, prueba el camino completo: entrar por dominio, llamar a la API, escribir un dato de prueba y verificar que la información sigue ahí tras un reinicio controlado. Un servidor que «arranca» no siempre es una aplicación que funciona.
Errores que vale la pena evitar
El agente no vuelve seguro un equipo comprometido. Bloquea tu sesión, revoca claves cuando cambien accesos y no copies nunca id_ed25519 a un chat. Los comandos de Set-Service requieren permisos elevados.
También es importante que las credenciales no terminen en el historial de la terminal, logs, archivos compartidos o capturas. Para usuarios y servicios, usá permisos mínimos y documentá quién puede revocar el acceso.
Cómo entra ArduMaker en este escenario
En ArduMaker, organizá accesos por VPS y Empresa, idealmente con claves SSH individuales. El agente facilita trabajar desde Windows sin compartir claves con el resto del equipo.
ArduMaker puede ayudarte a administrar los VPS, desplegar repositorios y trabajar con servicios, bases y dominios desde la misma plataforma. No reemplaza lo que acabamos de explicar sobre Linux: precisamente por eso conviene entender el diagnóstico y tener una forma de repetirlo.
Cuándo conviene automatizarlo
Si la tarea se repite, documentá primero el procedimiento manual y sus comprobaciones. Después considerá un script o una tarea programada con errores visibles, logs y permisos limitados. No automatices un comando que todavía no sabés recuperar cuando sale mal.
Preguntas habituales
¿Puedo probarlo sin afectar clientes? En muchos casos sí: un VPS de staging o un servicio de prueba separado permite validar la configuración antes de cambiar producción.
¿Cómo sé si quedó bien? Mirá logs y una operación funcional, no solamente que el comando terminó con código cero.
¿Cuándo necesito más recursos? Cuando las métricas indiquen saturación de CPU, RAM, disco o conexiones. Un fallo de configuración rara vez se arregla contratando más memoria.
Referencias
En una frase: primero entendé el error, después cambiá una cosa concreta y comprobá su efecto. Esa disciplina te ahorra muchas horas de soporte.