~/.ssh/config

Guardar opciones habituales en la configuración del cliente.

Antes de ejecutar

El primer bloque es contenido de archivo, no un comando: edite ~/.ssh/config localmente. Normalmente prevalece el primer valor obtenido; coloque los bloques Host específicos antes de Host *. Proteja el archivo, normalmente con chmod 600 ~/.ssh/config. No guarde contraseñas ni claves privadas en él. ServerAlive detecta si el extremo SSH no responde, no todos los fallos de aplicaciones. ssh -G muestra la configuración efectiva sin conectarse y puede revelar direcciones internas o rutas.

Ejemplos

Definir el alias lab con puerto, clave y mantenimiento de conexión SSH.

Host lab
    HostName server.example.com
    User alice
    Port 2222
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes
    ServerAliveInterval 30
    ServerAliveCountMax 3

Conectar mediante el alias o consultar su configuración efectiva.

ssh lab
ssh -G lab

Opciones y ejemplos

Host patternFrecuente

Inicie un bloque que coincida con un alias SSH o patrón de host. Anteponer bloques específicos a los generales: se utiliza el primer valor obtenido.

Ejemplo

Host lab
    HostName server.example.com

HostName / User / PortFrecuente

Establezca la dirección real del servidor, el nombre de inicio de sesión y el puerto SSH para el host correspondiente.

Ejemplo

Host lab
    HostName server.example.com
    User alice
    Port 2222

IdentityFile / IdentitiesOnlyFrecuente

Seleccione una clave privada y, cuando esté configurada en Sí, limite las identidades ofrecidas a las configuradas.

Ejemplo

Host lab
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

ProxyJumpFrecuente

Conéctese a través de uno o más hosts de salto SSH.

Ejemplo

Host lab
    ProxyJump alice@bastion.example.com

LocalForward

Configure un oyente local reenviado a un destino al que se llega desde el servidor SSH.

Ejemplo

Host lab
    LocalForward 127.0.0.1:15432 db.internal.example.com:5432

RemoteForward

Configurar un oyente remoto reenviado a un destino al que se llega desde la computadora local; Se aplica la política del servidor.

Ejemplo

Host lab
    RemoteForward 127.0.0.1:18080 127.0.0.1:8080

DynamicForward

Configure un oyente SOCKS local. Los clientes deben configurarse por separado.

Ejemplo

Host lab
    DynamicForward 127.0.0.1:1080

ExitOnForwardFailure

Falla la conexión SSH si no se pueden establecer los oyentes de reenvío iniciales solicitados.

Ejemplo

Host lab
    ExitOnForwardFailure yes

ServerAliveInterval / ServerAliveCountMaxFrecuente

Configure las verificaciones de pares a nivel SSH y la cantidad de verificaciones sin respuesta antes de desconectarse.

Ejemplo

Host lab
    ServerAliveInterval 30
    ServerAliveCountMax 3

ConnectTimeout

Establezca el tiempo de espera de la conexión en segundos.

Ejemplo

Host lab
    ConnectTimeout 10

ForwardAgent

Control de reenvío de agentes. Un host remoto comprometido puede solicitar firmas; habilitar solo para hosts confiables.

Ejemplo

Host lab
    ForwardAgent no

Include

Incluir archivos de configuración SSH adicionales; El orden afecta los valores que se seleccionan.

Ejemplo

Include ~/.ssh/config.d/*.conf

Referencias oficiales

Revisado el 27 de octubre de 2026