termal.in

← Blog

As flags de SSH que você vai realmente usar (um cheat sheet prático)

· atualizado 12 de nov. de 2026 · Termalin Team sshcheat-sheetproductivitytutorial

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. (-p minúsculo; o -P maiú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 prefixo user@. ssh -l deploy host equivale a ssh deploy@host; você verá -l em 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/null para 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 -v mostra os métodos de autenticação testados e as chaves oferecidas; -vvv mostra o handshake completo. Quando algo falha, rode de novo com -vvv antes 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.com traz um banco de dados remoto para o seu 127.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 para 127.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 o ssh para segundo plano depois que ele conecta. Combine com -N para 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ó o 127.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 -J para “alcançar o próximo salto” e guarde o -A para 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 do sudo e 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:

  • -t força um TTY para um comando que precisa de um — ssh -t user@host 'sudo systemctl restart nginx' dá ao sudo um 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

FlagO que fazEquivalente no ssh_config
-p 2222Porta fora do padrãoPort 2222
-l user / user@Usuário de loginUser user
-i ~/.ssh/keyIdentidade específicaIdentityFile ~/.ssh/key
-F fileArquivo de configuração alternativo— (isto é a configuração)
-v … -vvvVerboso / debugLogLevel DEBUG3
-o Opt=valQualquer opção de configuração inline(a própria opção)
-L a:host:bEncaminhamento localLocalForward a host:b
-R a:host:bEncaminhamento remotoRemoteForward a host:b
-D 1080Encaminhamento dinâmico (SOCKS)DynamicForward 1080
-NSem comando remotoRequestTTY no (+ sem comando)
-fSegundo plano após conectar— (só pontual)
-gAbrir encaminhamento para a sua LANGatewayPorts yes
-J hostSaltar por um bastionProxyJump host
-AEncaminhar o agenteForwardAgent yes
-tForçar um TTYRequestTTY force
-qSilenciosoLogLevel QUIET
-CCompressãoCompression yes
-o BatchMode=yesNunca perguntarBatchMode 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.

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