termal.in

← Blog

El archivo ~/.ssh/config: deja de reescribir los mismos flags de SSH

· actualizado 12 nov 2026 · Termalin Team sshssh-configproductivitytutorial

Respuesta corta: Crea ~/.ssh/config (y aplícale chmod 600), luego dale a cada servidor un bloque Host con HostName, User, Port e IdentityFile: ahora ssh web1 se expande al comando entero, y scp, sftp, rsync y git leen el mismo alias. Gana la primera coincidencia, así que pon primero los hosts específicos y deja al final los valores por defecto amplios Host *. ProxyJump llega a un host detrás de un bastión; ServerAliveInterval 30 evita que las sesiones inactivas se caigan; IdentitiesOnly yes fija una sola clave para que un servidor estricto no te eche.

Si alguna vez has escrito ssh -i ~/.ssh/work_ed25519 -p 2222 -o ServerAliveInterval=30 deploy@203.0.113.10 más de dos veces, ya has amortizado los diez minutos que cuesta aprender ssh_config. Es el archivo de mayor impacto de toda tu configuración de SSH: convierte esa línea entera en ssh web1, y lo leen automáticamente ssh, las herramientas de transferencia de archivos scp/sftp/rsync, git y cualquier otra cosa que delegue en SSH.

Este es el recorrido práctico: las directivas que de verdad se ganan su sitio y las trampas que conviene conocer.

Dónde vive y cómo se lee

Tu configuración personal es ~/.ssh/config (créala si no existe; chmod 600). También hay una de todo el sistema en /etc/ssh/ssh_config. Las reglas con las que la gente tropieza:

  • Gana la primera coincidencia, no la más específica. SSH lee de arriba abajo y usa el primer valor que ve para cada opción. Pon tus hosts específicos arriba y los valores por defecto amplios Host * abajo.
  • Cada ajuste va bajo un bloque Host (un patrón), indentado por convención (la indentación no es obligatoria, pero tu yo del futuro te agradecerá un archivo legible).

El bloque básico: un alias de host

Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

Ahora ssh web1 se expande al comando completo. También scp file.tar web1:/srv/, sftp web1 y rsync -a ./dist/ web1:/var/www/. El alias es justo lo que importa: nombra el servidor una vez y usa el nombre en todas partes.

Directivas que se ganan su sitio

ProxyJump: llega a servidores a través de un bastión. El reemplazo moderno del viejo conjuro ProxyCommand ... netcat:

Host db1
    HostName 10.0.0.5          # dirección privada, solo alcanzable desde el bastión
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump

ssh db1 salta ahora de forma transparente a través de bastion para llegar a un host sin dirección pública. Encadénalos con comas (ProxyJump a,b,c) para redes más profundas.

Keepalives: evita que las sesiones inactivas mueran. El arreglo para client_loop: send disconnect: Broken pipe cuando apartas la vista:

Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4

Un paquete cada 30 segundos impide que los routers NAT y los firewalls olviden tu conexión; cuatro respuestas perdidas (dos minutos) antes de rendirse.

IdentitiesOnly: ofrece solo la clave correcta. Si llevas varias claves, SSH las ofrece todas y un servidor estricto responde Too many authentication failures. Fija una clave por host y acaba con las conjeturas:

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

AddKeysToAgent: desbloquea una vez una clave protegida con frase de contraseña:

Host *
    AddKeysToAgent yes

Patrones y comodines: configura toda una flota en un bloque:

Host *.staging.example.com
    User deploy
    IdentityFile ~/.ssh/staging_ed25519

Host 10.0.*
    ProxyJump bastion

Una configuración realista, de arriba abajo

# Primero los hosts específicos (gana la primera coincidencia)
Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

Host db1
    HostName 10.0.0.5
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump
    IdentityFile ~/.ssh/work_ed25519

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

# Los valores por defecto amplios al final
Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4
    AddKeysToAgent yes

Divídela a medida que crece: Include ~/.ssh/config.d/* al principio del archivo te permite tener un archivo por proyecto o por cliente.

Dos trampas

  • «Gana la primera coincidencia» te muerde cuando un bloque Host * cerca del principio fija un valor que querías sobrescribir más abajo: no lo sobrescribirá, porque el valor anterior ya ganó. Los valores por defecto van al final.
  • Los comentarios son # al principio de la línea. Un comentario al final, tras un valor, puede interpretarse como parte del valor en algunas opciones: deja los comentarios en líneas propias.

Cuando el archivo de configuración no basta

ssh_config es excelente y todo el mundo debería tener uno. Sus límites aparecen cuando el montaje se hace más grande que un archivo de texto: lo sincronizas entre máquinas a mano, compartes versiones depuradas con tus compañeros, recuerdas qué frase de contraseña va con qué clave, o intentas ver de un vistazo cuál de cuarenta hosts está siquiera en línea.

Esa es la costura que cubre Termalin. Mantiene los mismos ajustes por host —hostname, usuario, puerto, clave, jump host, keepalives— pero adjuntos al host como datos estructurados que organizas en carpetas y etiquetas, desbloquea tus claves una sola vez mediante un agente incorporado, verifica cada servidor en la primera conexión y muestra el estado en vivo de cada host de la lista. Importa tus sesiones de PuTTY existentes, y su lista de hosts se sincroniza entre tus máquinas cifrada de extremo a extremo. El archivo escala hasta cierto punto; un cliente que guarda el estado por ti escala más allá.

En cualquier caso, el principio se sostiene: nombra un servidor una vez y no vuelvas a teclear sus flags de línea de comandos nunca más.


Termalin es un cliente SSH multiplataforma y gratuito que gestiona por ti los ajustes por host, las claves y los jump hosts — descárgalo o lee cómo maneja las claves con seguridad.

Pruébalo en un host.

Termalin es un cliente SSH rápido para ti y para tus agentes.

Plan gratuito · 14 días de Pro de prueba · precios

Añade Termalin como fuente preferida en Google