A sequência de escape SSH ~. fecha uma sessão bloqueada a partir do lado do cliente, sem esperar pelo servidor: prima Enter, depois ~ e depois um ponto. Funciona porque o OpenSSH processa o carácter de escape localmente no início de uma linha, mesmo quando a rede ou o anfitrião remoto deixaram de responder.

Como funciona o ~. no SSH: o carácter de escape do OpenSSH

O OpenSSH usa ~ como carácter de escape predefinido, e o cliente só o reconhece no início de uma linha, logo a seguir a premir Enter. Se escrever ~. a meio de um comando, segue diretamente para o servidor. Se o escrever depois de uma nova linha, o seu ssh local interceta-o e nunca chega à rede.

É isso que o torna útil. Quando a ligação TCP fica presa, Ctrl-C e exit não fazem nada, porque ambos precisam de chegar ao servidor. O ~. não depende do servidor de todo: corta a ligação do seu lado e devolve-lhe o prompt local. Os escapes só estão disponíveis quando foi pedido um pseudoterminal, que é o caso normal numa sessão interativa. A lista completa está na página de manual do ssh.

As sequências de escape SSH que vale a pena memorizar: ~., ~?, ~C e ~~

O OpenSSH documenta estas sequências, e todas têm de vir depois de Enter:

  • ~. desliga de imediato.
  • ~? mostra as sequências de escape que a sua versão suporta.
  • ~C abre a linha de comandos do ssh para adicionar ou cancelar reencaminhamentos de portas (-L, -R, -D, -KL, -KR, -KD).
  • ~# lista as ligações reencaminhadas ativas.
  • ~^Z passa o ssh para segundo plano (Ctrl-Z depois do til).
  • ~B envia um BREAK ao sistema remoto.
  • ~R pede uma renovação das chaves (rekey) da ligação.
  • ~v e ~V aumentam e diminuem o nível de detalhe das mensagens de diagnóstico.
  • ~~ envia um til literal, que é a forma de chegar a sessões aninhadas.
# Press Enter, then the sequence
~.                           # close this session
~~.                          # close the nested session (ssh inside ssh)
~?                           # list available sequences
~C                           # open the ssh command line
ssh> -L 8080:localhost:80    # add a local forward on the fly
ssh> -KL 8080                # cancel it

Uma configuração comum: salta do portátil para um bastion e daí para outro servidor. O ~. mata a primeira ligação e tudo o que passa por ela. O ~~. faz com que o primeiro ssh passe um til e um ponto ao segundo, que é quem desliga. Cada til adicional desce mais um nível.

As versões recentes do OpenSSH desativam o ~C por predefinição através da opção EnableEscapeCommandline. Se o ~C não fizer nada, adicione EnableEscapeCommandline yes ao bloco Host correspondente. Executar comandos locais com !command a partir desse prompt também exige PermitLocalCommand yes.

Quando uma sessão SSH está mesmo morta e quando apenas parece

Prima Enter e escreva ~?. Se a ajuda aparecer, o seu cliente ssh local está bem e o problema está na rede ou no servidor. Tenha em conta que esta é uma verificação local: não diz nada sobre se o servidor está vivo, apenas que o seu lado responde. Antes de cortar a ligação, descarte três falsos bloqueios:

  1. Um Ctrl-S acidental. Pausa a saída do terminal através do controlo de fluxo XOFF, e Ctrl-Q retoma-a.
  2. Um comando lento em primeiro plano. Experimente Ctrl-C: se o servidor responder, a sessão está viva.
  3. Um programa de ecrã inteiro à espera de input. Um editor ou um paginador podem parecer bloqueados, e Esc ou q costumam tirá-lo de lá.

Se nada disto produzir qualquer eco, a sessão está morta para efeitos práticos. É típico depois de mudar de wifi para dados móveis, suspender um portátil ou reiniciar o servidor. Para não ficar à espera às cegas, ServerAliveInterval faz com que o cliente envie mensagens de controlo pelo canal cifrado. Quando ServerAliveCountMax mensagens seguidas ficam sem resposta (3 por predefinição), o ssh desliga-se sozinho. ServerAliveInterval tem o valor predefinido 0, o que significa que está desativado.

Alterar ou desativar o EscapeChar do SSH em ~/.ssh/config

A diretiva EscapeChar define o carácter de escape. Aceita um único carácter, ^ seguido de uma letra para uma combinação com Ctrl, ou none. Na linha de comandos, o equivalente é -e.

Host *
    ServerAliveInterval 15
    ServerAliveCountMax 3

Host bastion
    HostName bastion.example.com
    EscapeChar ^]

# One connection with no escapes (fully transparent session)
ssh -e none user@server

Com none, não há escapes disponíveis e a ligação é totalmente transparente. Isso importa quando passam dados binários pelo canal que podem conter um til depois de uma nova linha. Um carácter diferente faz sentido em sessões aninhadas, para que cada salto tenha o seu, ou quando a disposição do teclado transforma o ~ numa tecla morta. Todas as diretivas estão descritas na página de manual do ssh_config.

Sequências de escape SSH versus Mosh: tabela comparativa

O Mosh usa uma sequência diferente: Ctrl-^ seguido de um ponto termina a sessão. Estas são as diferenças que importam quando uma ligação bloqueia:

O que se comparaSSH (OpenSSH)Mosh
Sequência para sairEnter, depois ~ e um pontoCtrl-^ seguido de um ponto
TransporteTCP, porta 22 por predefiniçãoUDP, portas 60000-61000 por predefinição
Mudar de wifi para dados móveisA ligação TCP costuma bloquearA sessão mantém-se ativa
Reencaminhamento de portas-L, -R e -D, também via ~CSem reencaminhamento de portas nem de X11
ArranqueLigação direta ao servidor SSHInicia o mosh-server através de uma ligação SSH inicial

O Mosh não tem equivalente ao ~C porque não reencaminha portas, por isso, se precisar de um túnel, abra-o com uma ligação ssh separada. Os detalhes estão na documentação oficial do Mosh.

Fechar sessões SSH bloqueadas a partir do telemóvel com o termi1

Nos teclados táteis de iOS e Android, o til costuma estar numa página secundária de símbolos, e a sequência também precisa de um Enter antes. O termi1 acrescenta uma fila de teclas própria com Esc, Ctrl, Tab e setas, o que facilita escrever Ctrl-C, Ctrl-Q e combinações como o Ctrl-^ do Mosh.

Num telemóvel, a causa mais comum de uma sessão bloqueada é uma mudança de rede. O termi1 mantém a sessão ativa com o Mosh quando passa de wifi para dados móveis, e usa o tmux para que aquilo que deixou a correr continue lá quando voltar. Se uma ligação SSH simples bloquear, feche-a, volte a ligar-se e retome o trabalho com tmux attach. O terminal termi1 para iOS e Android é gratuito e funciona sem conta.

Perguntas frequentes

Porque é que o ~. não fecha a minha sessão SSH?

A sequência ~. não fecha uma sessão SSH se não estiver no início de uma linha, por isso prima Enter antes do til. Também falha quando EscapeChar está definido como none, quando o carácter de escape foi alterado ou quando o teclado trata ~ como tecla morta e nunca o envia.

Qual é a diferença entre ~. e exit no SSH?

A diferença entre ~. e exit no SSH é onde cada um é processado. exit corre na shell remota e precisa de um servidor que responda. O ~. é intercetado pelo cliente ssh local e corta a ligação mesmo quando a rede ou o servidor desapareceram. Numa sessão saudável, exit é a saída limpa.

Como fecho uma sessão SSH aninhada sem fechar a exterior?

Uma sessão SSH aninhada fecha-se com ~~. depois de premir Enter: o primeiro cliente deixa passar um til literal e o segundo cliente interpreta ~. como ordem para desligar. Cada til adicional chega um nível mais abaixo. Em alternativa, atribua a cada salto o seu próprio EscapeChar em ~/.ssh/config.

Os processos remotos terminam quando fecho o SSH com ~.?

Os processos remotos em primeiro plano costumam terminar quando ~. corta a sessão SSH, porque a shell perde o seu terminal. Para os manter em execução, inicie-os dentro do tmux e volte a ligar-se a eles com tmux attach depois de restabelecer a ligação ao servidor.

Qual é a sequência de escape do Mosh?

A sequência de escape do Mosh é Ctrl-^ seguido de um ponto, e termina a sessão mesmo quando o servidor deixa de responder. O Mosh não tem linha de comandos ~C porque não faz reencaminhamento de portas nem de X11. Para túneis, abra uma ligação SSH separada com -L, -R ou -D.