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.