termal.in

← Blog

O arquivo ~/.ssh/config: pare de redigitar as mesmas flags SSH

· atualizado 12 de nov. de 2026 · Termalin Team sshssh-configproductivitytutorial

A resposta curta: Crie o ~/.ssh/config (e dê um chmod 600 nele), depois dê a cada servidor um bloco Host com HostName, User, Port e IdentityFile — agora ssh web1 se expande no comando inteiro, e scp, sftp, rsync e git leem o mesmo alias. A primeira correspondência vence, então liste os hosts específicos primeiro e os padrões amplos de Host * por último. O ProxyJump alcança um host atrás de um bastion; ServerAliveInterval 30 evita que sessões ociosas caiam; IdentitiesOnly yes fixa uma chave para que um servidor rígido não te derrube.

Se você já digitou ssh -i ~/.ssh/work_ed25519 -p 2222 -o ServerAliveInterval=30 deploy@203.0.113.10 mais de duas vezes, já recuperou os dez minutos que leva para aprender o ssh_config. É o arquivo de maior alavancagem na sua configuração de SSH: ele transforma aquela linha inteira em ssh web1, e é lido automaticamente pelo ssh, pelas ferramentas de transferência de arquivos scp/sftp/rsync (em inglês), pelo git e por qualquer outra coisa que invoque o SSH.

Aqui vai o tour prático — as diretivas que realmente valem o seu lugar e as armadilhas que vale a pena conhecer.

Onde ele fica e como é lido

A sua configuração pessoal é o ~/.ssh/config (crie-o se não existir; chmod 600). Há também um /etc/ssh/ssh_config global do sistema. As regras que pegam as pessoas:

  • A primeira correspondência vence, não a mais específica. O SSH lê de cima para baixo e o primeiro valor que encontra para cada opção é o que ele usa. Ponha os seus hosts específicos no topo e os padrões amplos de Host * no fim.
  • Toda configuração fica sob um bloco Host (um padrão), indentada por convenção (a indentação não é obrigatória, mas deixe o arquivo legível — o seu eu do futuro agradece).

O bloco de construção: um alias de host

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

Agora ssh web1 se expande no comando completo. O mesmo vale para scp file.tar web1:/srv/, sftp web1 e rsync -a ./dist/ web1:/var/www/. O alias é todo o propósito: nomeie o servidor uma vez, use o nome em todo lugar.

Diretivas que valem o seu lugar

ProxyJump — alcance servidores através de um bastion. O substituto moderno para o antigo encantamento ProxyCommand ... netcat:

Host db1
    HostName 10.0.0.5          # endereço privado, só alcançável a partir do bastion
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump

ssh db1 agora salta de forma transparente pelo bastion para alcançar um host sem endereço público. Encadeie-os com vírgulas (ProxyJump a,b,c) para redes mais profundas.

Keepalives — impeça que sessões ociosas morram. A correção para o client_loop: send disconnect: Broken pipe quando você desvia o olhar:

Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4

Um pacote a cada 30 segundos impede que roteadores NAT e firewalls esqueçam a sua conexão; quatro respostas perdidas (dois minutos) antes de ele desistir.

IdentitiesOnly — ofereça apenas a chave certa. Se você carrega várias chaves, o SSH oferece todas elas e um servidor rígido responde Too many authentication failures. Fixe uma chave por host e acabe com o chute:

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

AddKeysToAgent — desbloqueie uma chave protegida por frase-senha de uma vez:

Host *
    AddKeysToAgent yes

Padrões e curingas — configure uma frota em um só bloco:

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

Host 10.0.*
    ProxyJump bastion

Uma configuração realista, de cima a baixo

# Hosts específicos primeiro (a primeira correspondência vence)
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

# Padrões amplos por último
Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4
    AddKeysToAgent yes

Divida-o conforme cresce: Include ~/.ssh/config.d/* no topo do arquivo permite manter um arquivo por projeto ou cliente.

Duas armadilhas

  • O “a primeira correspondência vence” te morde quando um bloco Host * lá perto do topo define um valor que você pretendia sobrescrever mais abaixo — ele não vai sobrescrever, porque o valor anterior já venceu. Os padrões vão no fim.
  • Comentários são # no início da linha. Comentários no fim de uma linha, após um valor, podem ser interpretados como parte do valor em algumas opções — mantenha os comentários em linhas próprias.

Quando o arquivo de configuração não basta

O ssh_config é excelente e todo mundo deveria ter um. Seus limites aparecem quando a sua configuração fica maior que um arquivo de texto: você o sincroniza entre máquinas na mão, compartilha versões higienizadas com colegas, tenta lembrar qual frase-senha vai com qual chave ou quer ver num relance qual de quarenta hosts está sequer online.

É essa a costura que o Termalin preenche. Ele mantém as mesmas configurações por host — hostname, usuário, porta, chave, host de salto, keepalives —, mas presas ao host como dados estruturados que você organiza em pastas e tags, desbloqueia as suas chaves uma vez por um agente integrado, verifica cada servidor na primeira conexão e mostra o status ao vivo de todo host na lista. Ele importa as suas sessões existentes do PuTTY, e a sua lista de hosts sincroniza entre as suas máquinas, criptografada de ponta a ponta. O arquivo escala até certo ponto; um cliente que guarda o estado por você escala além disso.

De todo jeito, o princípio se mantém: nomeie um servidor uma vez e nunca mais redigite as flags de linha de comando dele.


O Termalin é um cliente SSH gratuito e multiplataforma que gerencia as configurações por host, as chaves e os hosts de salto por você — baixe o Termalin ou leia como ele cuida das chaves com segurança.

Experimente em um host.

Termalin é um cliente SSH rápido para você — e para seus agentes.

Plano gratuito · 14 dias de Pro grátis · preços

Adicionar o Termalin como fonte preferida no Google