PuTTY es un cliente SSH ligero y veterano para Windows, útil cuando quieres sesiones guardadas y una ventana gráfica de ajustes. En esta guía te conectarás a tu VPS Linux Infrawire, mantendrás la sesión activa, pasarás a la autenticación por clave con PuTTYgen y Pageant y transferirás archivos con pscp.
📋 Requisitos previos
- Windows 10 u 11.
- Un VPS Linux en marcha (Ubuntu 24.04, Debian 12, AlmaLinux 9 o Rocky 9).
- La dirección IP del VPS y la contraseña de root: desde tu área de cliente encuentras la IP y la contraseña root del VPS.
- PuTTY instalado, que incluye
putty.exe,puttygen.exe,pageant.exeypscp.exe.
Si usas winget, la instalación cabe en una línea de PowerShell:
PowerShellwinget install PuTTY.PuTTY
🔌 Crear y guardar una sesión
- Abre PuTTY. En la categoría Session, escribe
VPS_IPen Host Name (or IP address). - Deja Port en
22(o tu puerto personalizado) y Connection type en SSH. - En el cuadro Saved Sessions escribe un nombre como
myvpsy haz clic en Save. - Opcional: en Connection > Data, rellena Auto-login username con
rootpara que no te lo pida. - Vuelve a Session, selecciona
myvps, pulsa Save otra vez y luego Open.
En la primera conexión PuTTY muestra una PuTTY Security Alert con la huella de la clave del servidor. Pulsa Accept solo si confías en el servidor: la clave quedará recordada en el registro.
⏱️ Evitar desconexiones con keepalive
Las sesiones inactivas suelen ser cortadas por routers y cortafuegos. Abre Connection, pon Seconds between keepalives en 30, vuelve a Session y guarda de nuevo myvps. PuTTY enviará un pequeño paquete cada 30 segundos.
🔑 Generar un par de claves con PuTTYgen
Abre PuTTYgen, elige EdDSA (Ed25519) como tipo de clave y haz clic en Generate moviendo el ratón por la zona en blanco. Después:
- Escribe una Key passphrase y confírmala.
- Pulsa Save private key y guarda el archivo
.ppken un lugar seguro. - Copia el texto de Public key for pasting into OpenSSH authorized_keys file.
Inicia sesión con tu contraseña e instala la clave pública en el VPS (pega la línea copiada en el archivo):
Bashmkdir -p ~/.ssh && chmod 700 ~/.ssh nano ~/.ssh/authorized_keys chmod 600 ~/.ssh/authorized_keys
En PuTTY, ve a Connection > SSH > Auth > Credentials, elige tu .ppk en Private key file for authentication, vuelve a Session y guarda. Para reutilizar una clave privada OpenSSH existente, usa PuTTYgen: Conversions > Import key y luego Save private key.
🧩 Cargar la clave una vez con Pageant
Pageant es el agente de claves de PuTTY. Ejecuta pageant.exe, que se queda en el área de notificación, haz clic derecho en su icono, elige Add Key, selecciona el .ppk y escribe la frase de paso una sola vez. Mientras Pageant esté activo, PuTTY y pscp usan la clave sin volver a pedirla. Cierra Pageant para olvidar la clave.
📂 Transferir archivos con pscp
pscp.exe es la herramienta de copia por línea de comandos de PuTTY. Fíjate en la -P mayúscula para el puerto. Desde PowerShell:
PowerShell# Subir un archivo pscp -P 22 C:\Users\USER\Documents\site.zip root@VPS_IP:/root/ # Descargar un archivo pscp -P 22 root@VPS_IP:/var/log/syslog C:\Users\USER\Downloads\ # Subir una carpeta completa pscp -r -P 22 C:\Users\USER\project root@VPS_IP:/root/ # Usar una clave concreta pscp -i C:\keys\vps.ppk site.zip root@VPS_IP:/root/
Si no se encuentra pscp, llámalo con su ruta completa, por ejemplo & 'C:\Program Files\PuTTY\pscp.exe'.
✅ Verificar la conexión
Una vez dentro, comprueba que se usa la clave y que estás en la máquina correcta:
Bashwhoami hostname cat /etc/os-release sudo grep 'Accepted publickey' /var/log/auth.log | tail -n 3
El último comando funciona en Ubuntu/Debian; en AlmaLinux/Rocky usa sudo journalctl -u sshd | grep Accepted | tail -n 3. La barra de título de PuTTY muestra la sesión conectada y el Event Log (clic derecho en la barra de título) detalla los pasos de autenticación.
🛠️ Solución de problemas
Network error: Connection timed out / refused. Revisa VPS_IP y el puerto, que el VPS esté encendido y que SSH escuche (sudo systemctl status ssh en Ubuntu/Debian, sshd en AlmaLinux/Rocky). Un cortafuegos local o una red de empresa también pueden bloquear el puerto.
Server refused our key / Disconnected: No supported authentication methods available. La clave pública no se pegó en una sola línea, se usa un usuario equivocado o los permisos son demasiado abiertos. Revisa authorized_keys, ejecuta chmod 700 ~/.ssh y chmod 600 ~/.ssh/authorized_keys y confirma que el .ppk corresponde a la clave pública.
Unable to use key file (OpenSSH SSH-2 private key). PuTTY no puede leer ese formato. Convierte la clave con PuTTYgen (Conversions > Import key) o actualiza PuTTY a una versión reciente.
La sesión se congela tras unos minutos. Configura el intervalo de keepalive descrito arriba.
🚀 PuTTY ya está configurado con sesión guardada, acceso por clave y transferencia de archivos. Siguiente paso: desactivar el acceso por contraseña cuando tu clave funcione.