A resposta curta: As flags que você mais usa: -p <port> (porta fora do padrão), -i <key> (forçar uma chave específica), -L / -R / -D (encaminhamentos local, remoto e dinâmico), -J <bastion> (saltar por um bastion), -N -f (colocar um túnel em segundo plano sem shell), -t (forçar um TTY para o sudo), -o Option=value (definir qualquer diretiva do ssh_config na própria linha) e -vvv (depurar uma conexão que falha). Qualquer coisa que você passa duas vezes pertence ao ~/.ssh/config, então ssh web1 já a carrega sem flag nenhuma.
O ssh --help despeja quarenta flags em ordem alfabética, que é o jeito menos útil de aprendê-las. Você recorre a uma flag pelo que está tentando fazer — conectar como outro usuário, encaminhar uma porta, saltar por um bastion, depurar uma recusa — então aqui está o mesmo conjunto organizado por tarefa, com uma observação sobre quais parar de digitar e colocar no seu ssh_config (em inglês) em vez disso.
A regra por trás de tudo: flags são para casos pontuais; a configuração é para a permanência. Qualquer coisa que você passa duas vezes pertence ao arquivo.
O básico da conexão
As flags que respondem “quem, onde e com qual chave”.
-p <port>— conectar a uma porta fora do padrão.ssh -p 2222 user@host. (-pminúsculo; o-Pmaiúsculo é a flag de porta do scp, o que pega todo mundo de surpresa uma vez.)-l <user>— o usuário de login, uma alternativa ao prefixouser@.ssh -l deploy hostequivale assh deploy@host; você verá-lem scripts e em documentações mais antigas.-i <identity>— apontar para uma chave privada específica.ssh -i ~/.ssh/work_ed25519 user@host. A flag mais útil quando a autenticação falha: ela força a chave exata em vez de deixar o agente adivinhar.-F <configfile>— usar um arquivo de configuração diferente.ssh -F ./project.sshconfig web1, ou-F /dev/nullpara ignorar a sua configuração pessoal e testar com zero customização.-v/-vv/-vvv— verbosidade, e a flag que encerra a maioria dos mistérios. Um-vmostra os métodos de autenticação testados e as chaves oferecidas;-vvvmostra o handshake completo. Quando algo falha, rode de novo com-vvvantes de teorizar — ler esse rastro é uma habilidade à parte.
A válvula de escape do -o
Esta é a flag que vale entender a fundo, porque ela engloba dezenas de outras. O -o define inline qualquer opção do ssh_config. Tudo o que você poderia escrever no ~/.ssh/config dentro de um bloco Host pode ser passado como -o Option=value — não uma lista curta de opções abençoadas, mas todo o vocabulário de configuração, disponível para uma única conexão.
Algumas que aparecem o tempo todo:
ssh -o IdentitiesOnly=yes -i ~/.ssh/right_key user@host # oferecer só esta chave
ssh -o StrictHostKeyChecking=accept-new user@host # confiar em hosts novos, ainda pegando mudanças
ssh -o ServerAliveInterval=30 user@host # keepalive para um link instável
ssh -o ProxyJump=bastion.example.com db.internal # saltar por um bastion inline
-o IdentitiesOnly=yes é a correção para Too many authentication failures quando o seu agente oferece seis chaves e um servidor rígido te corta depois de cinco. -o StrictHostKeyChecking=accept-new é o meio-termo sensato — confiar automaticamente em um host que você nunca viu, mas ainda gritar se a chave de um host conhecido mudar.
A questão: você não precisa de uma flag especial para cada comportamento. Se você conhece a diretiva de configuração, você conhece a flag — é -o Directive=value. Quando você estiver passando três ou quatro toda vez, mova-as para a configuração de uma vez por todas.
Encaminhamento e túneis
As flags de encanamento de portas. O modelo mental — qual lado abre a porta — tem a sua própria leitura em encaminhamento de portas SSH explicado; aqui está o resumo das flags.
-L <local>:<host>:<port>— encaminhamento local. Abre uma porta na sua máquina que faz o túnel até um destino acessível a partir do servidor.ssh -L 5432:localhost:5432 db.example.comtraz um banco de dados remoto para o seu127.0.0.1:5432.-R <remote>:<host>:<port>— encaminhamento remoto. Abre uma porta no servidor que faz o túnel de volta para o seu lado — o truque do túnel reverso para alcançar uma máquina atrás de NAT.-D <port>— encaminhamento dinâmico. Um proxy SOCKS na sua máquina; o destino é escolhido por conexão.ssh -D 1080 jump.example.com, depois aponte um navegador para127.0.0.1:1080.-N— não executar um comando remoto. Combine com qualquer encaminhamento quando você quer apenas o túnel e nenhum shell.-f— manda osshpara segundo plano depois que ele conecta. Combine com-Npara um túnel do tipo dispare e esqueça:ssh -fN -L 5432:localhost:5432 db.example.com.-g— deixa outras máquinas da sua LAN usarem um encaminhamento local (-L/-D), não só o127.0.0.1. Uma pequena exposição — você está abrindo o túnel para toda a sua rede, então use com intenção.
Hosts de salto e o agente
Alcançar o próximo salto, e a flag com a qual você deve ter cautela.
-J <jumphost>— ProxyJump. Faz o túnel através de um bastion e autentica de ponta a ponta do seu notebook até o destino.ssh -J bastion.example.com db.internal. O bastion só transporta bytes criptografados; a sua chave nunca para nele — o jeito certo de passar por um gateway. O caso completo: ProxyJump: alcance servidores atrás de um bastion.-A— encaminhamento de agente. Expõe um socket no host remoto que repassa os pedidos de assinatura de volta para o seu agente local, de modo que um processo lá pode autenticar como você no próximo servidor. Conveniente e mais arriscado do que parece: qualquer um com root naquele host pode tomar emprestada a sua identidade enquanto a sessão está aberta. Use-Jpara “alcançar o próximo salto” e guarde o-Apara hosts em que você confia plenamente — os motivos estão em o encaminhamento de agente é conveniente e perigoso (em inglês).
Entre as duas: o -J leva o seu shell até um host atrás do bastion sem emprestar as suas chaves a ninguém; o -A empresta o uso ao vivo das suas chaves à máquina em que você conectou. Não é o mesmo trade.
Controle de sessão
As pequenas flags que resolvem aborrecimentos específicos.
-t— força um pseudo-terminal. Necessário para um comando remoto que espera um TTY interativo:ssh -t host 'sudo systemctl status nginx'te dá um terminal de verdade para o prompt dosudoe para a saída colorida. Dobre-a (-tt) para forçar um quando não há TTY local.-q— modo silencioso. Suprime avisos e banners; útil em scripts em que você quer apenas a saída do próprio comando.-C— pede compressão. Um ganho real em links lentos e de alta latência; desprezível ou levemente negativo em uma LAN rápida.-o BatchMode=yes— nunca pergunta. Se a autenticação precisasse de uma senha ou frase-senha, falha na hora em vez de travar. É isso que torna o SSH seguro dentro do cron e de CI — um prompt travado em um script sem supervisão trava para sempre.
Qual porta o SSH usa?
O SSH usa a porta TCP 22 por padrão — é o que o ssh, o scp, o sftp e o git-sobre-SSH presumem quando você não diz o contrário. Para alcançar um servidor escutando em outro lugar, passe a porta com -p:
ssh -p 2222 user@host
Para mudar a porta em que o servidor escuta, defina Port no /etc/ssh/sshd_config e reinicie o sshd — depois abra a nova porta tanto no firewall do host quanto no security group da nuvem antes de sair, porque mudar o SSH sem liberar a nova porta é o jeito mais rápido de se trancar para fora. (Sair da 22 silencia os scanners de passagem; não é segurança de verdade por si só.) Defina-a uma vez por host no seu ssh_config (em inglês) como Port 2222 e você nunca mais digita -p.
Como rodar um comando por SSH sem um shell
Ponha o comando entre aspas depois do host e o SSH o executa, imprime a saída e sai — nenhum shell interativo abre:
ssh user@host 'df -h /'
ssh user@host 'systemctl is-active nginx'
Esta é a espinha dorsal de scripts e do cron: uma conexão, um comando, um código de saída que você pode testar. Ponha o comando entre aspas para que o seu shell local não o expanda antes. Duas flags importam aqui:
-tforça um TTY para um comando que precisa de um —ssh -t user@host 'sudo systemctl restart nginx'dá aosudoum prompt interativo de verdade.-o BatchMode=yes(ou-n) impede que ele fique esperando entrada, então um job sem supervisão falha rápido em vez de travar em um prompt.
Como sair de uma sessão SSH
Digite exit, ou pressione Ctrl-D, para fechar o shell e derrubar a conexão. Os dois enviam fim de arquivo ao shell remoto, que faz o seu logout e te devolve ao prompt local:
exit # ou pressione Ctrl-D
Quando uma sessão está congelada — o link morreu e o terminal ignora tudo, até Ctrl-C — o exit não ajuda, porque nada do que você digita chega à outra ponta. Use a sequência de escape do próprio SSH: pressione Enter, depois digite ~. (til, depois ponto). Isso diz ao seu ssh local para derrubar a conexão na hora, por mais travado que o lado remoto esteja. O escape ~ só é lido logo depois de uma quebra de linha, e é por isso que você pressiona Enter primeiro.
A referência compacta
| Flag | O que faz | Equivalente no ssh_config |
|---|---|---|
-p 2222 | Porta fora do padrão | Port 2222 |
-l user / user@ | Usuário de login | User user |
-i ~/.ssh/key | Identidade específica | IdentityFile ~/.ssh/key |
-F file | Arquivo de configuração alternativo | — (isto é a configuração) |
-v … -vvv | Verboso / debug | LogLevel DEBUG3 |
-o Opt=val | Qualquer opção de configuração inline | (a própria opção) |
-L a:host:b | Encaminhamento local | LocalForward a host:b |
-R a:host:b | Encaminhamento remoto | RemoteForward a host:b |
-D 1080 | Encaminhamento dinâmico (SOCKS) | DynamicForward 1080 |
-N | Sem comando remoto | RequestTTY no (+ sem comando) |
-f | Segundo plano após conectar | — (só pontual) |
-g | Abrir encaminhamento para a sua LAN | GatewayPorts yes |
-J host | Saltar por um bastion | ProxyJump host |
-A | Encaminhar o agente | ForwardAgent yes |
-t | Forçar um TTY | RequestTTY force |
-q | Silencioso | LogLevel QUIET |
-C | Compressão | Compression yes |
-o BatchMode=yes | Nunca perguntar | BatchMode yes |
A coluna da direita é a pista. Quase toda flag tem um equivalente na configuração, e esse é o fluxo: use a flag uma vez para provar que uma conexão funciona, depois mova as que você vai repetir para o ~/.ssh/config, de modo que ssh web1 carregue todas elas sem flag nenhuma. As flags sem equivalente na configuração — -f, -F, a verbosidade de debug — são as genuinamente pontuais.
Onde um cliente guarda o estado por você
Tanto as flags quanto a configuração vivem nos seus dot-files, por máquina, e isso dói em escala: configurações copiadas de notebook em notebook na mão, túneis reexecutados depois de cada suspensão, nenhuma forma de ver qual dos quarenta hosts está no ar. O Termalin guarda os mesmos fatos que uma flag carregaria — porta, usuário, chave, host de salto, keepalives, encaminhamentos locais/remotos/dinâmicos salvos — anexados ao host como dados estruturados, organizados em pastas e tags, sincronizados entre as suas máquinas com criptografia de ponta a ponta. Ele verifica cada servidor na primeira conexão, mostra o status ao vivo por host e inicia os túneis junto com a conexão em vez de um comando redigitado. As flags te ensinam o que está acontecendo; um cliente te livra de redigitá-las toda manhã.
O Termalin é um cliente SSH multiplataforma e gratuito que guarda configurações, chaves e túneis por host por você — baixe o app ou leia como ele cuida das suas chaves com segurança.