~/.ssh/config

Salvar opções recorrentes na configuração do cliente.

Antes de executar

O primeiro bloco é conteúdo de arquivo, não comando: edite ~/.ssh/config localmente. Em geral, vale o primeiro valor encontrado; coloque blocos Host específicos antes de Host *. Proteja o arquivo, normalmente com chmod 600 ~/.ssh/config. Não inclua senhas nem conteúdo de chaves privadas. ServerAlive detecta falta de resposta do par SSH, não toda falha de aplicativo. ssh -G mostra a configuração efetiva sem conectar e pode revelar endereços internos ou caminhos.

Exemplos

Definir o alias lab com porta, chave e manutenção da conexão SSH.

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

Conectar pelo alias ou consultar sua configuração efetiva.

ssh lab
ssh -G lab

Opções e exemplos

Host patternComum

Inicie um bloco que corresponda a um alias SSH ou padrão de host. Coloque blocos específicos antes dos gerais: é utilizado o primeiro valor obtido.

Exemplo

Host lab
    HostName server.example.com

HostName / User / PortComum

Defina o endereço real do servidor, o nome de login e a porta SSH para o host correspondente.

Exemplo

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

IdentityFile / IdentitiesOnlyComum

Selecione uma chave privada e, quando definida como sim, limite as identidades oferecidas às configuradas.

Exemplo

Host lab
    IdentityFile ~/.ssh/id_ed25519
    IdentitiesOnly yes

ProxyJumpComum

Conecte-se por meio de um ou mais hosts de salto SSH.

Exemplo

Host lab
    ProxyJump alice@bastion.example.com

LocalForward

Configure um ouvinte local encaminhado para um destino alcançado pelo servidor SSH.

Exemplo

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

RemoteForward

Configure um ouvinte remoto encaminhado para um destino alcançado pelo computador local; a política do servidor se aplica.

Exemplo

Host lab
    RemoteForward 127.0.0.1:18080 127.0.0.1:8080

DynamicForward

Configure um ouvinte SOCKS local. Os clientes devem ser configurados separadamente.

Exemplo

Host lab
    DynamicForward 127.0.0.1:1080

ExitOnForwardFailure

Falha na conexão SSH se os ouvintes de encaminhamento inicial solicitados não puderem ser estabelecidos.

Exemplo

Host lab
    ExitOnForwardFailure yes

ServerAliveInterval / ServerAliveCountMaxComum

Configure verificações de pares no nível SSH e o número de verificações não respondidas antes de desconectar.

Exemplo

Host lab
    ServerAliveInterval 30
    ServerAliveCountMax 3

ConnectTimeout

Defina o tempo limite de conexão em segundos.

Exemplo

Host lab
    ConnectTimeout 10

ForwardAgent

Controle o encaminhamento do agente. Um host remoto comprometido pode solicitar assinaturas; habilite apenas para hosts confiáveis.

Exemplo

Host lab
    ForwardAgent no

Include

Inclui arquivos de configuração SSH adicionais; a ordem afeta quais valores são selecionados.

Exemplo

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

Referências oficiais

Revisado em 27 de outubro de 2026