La séquence d'échappement SSH ~. ferme une session figée côté client, sans attendre le serveur : appuyez sur Entrée, puis sur ~, puis sur un point. Cela fonctionne parce qu'OpenSSH traite le caractère d'échappement localement en début de ligne, même lorsque le réseau ou l'hôte distant ne répond plus.
Comment fonctionne ~. en SSH : le caractère d'échappement d'OpenSSH
OpenSSH utilise ~ comme caractère d'échappement par défaut, et le client ne le reconnaît qu'en début de ligne, juste après avoir appuyé sur Entrée. Tapez ~. au milieu d'une commande et il part directement vers le serveur. Tapez-le après un retour à la ligne et votre ssh local l'intercepte : il ne passe jamais par le réseau.
C'est ce qui le rend utile. Quand la connexion TCP est bloquée, Ctrl-C et exit ne font rien, car tous deux doivent atteindre le serveur. ~. ne dépend pas du tout du serveur : il coupe la connexion de votre côté et vous rend votre invite locale. Les échappements ne sont disponibles que si un pseudo-terminal a été demandé, ce qui est le cas normal pour une session interactive. La liste complète se trouve dans la page de manuel de ssh.
Les séquences d'échappement SSH à retenir : ~., ~?, ~C et ~~
OpenSSH documente ces séquences, et chacune d'elles doit suivre un appui sur Entrée :
~.déconnecte immédiatement.~?affiche les séquences d'échappement prises en charge par votre version.~Couvre la ligne de commande ssh pour ajouter ou annuler des redirections de ports (-L,-R,-D,-KL,-KR,-KD).~#liste les connexions redirigées actives.~^Zmet ssh en arrière-plan (Ctrl-Z après le tilde).~Benvoie un BREAK au système distant.~Rdemande une renégociation des clés de la connexion.~vet~Vaugmentent et diminuent la verbosité des messages de diagnostic.~~envoie un tilde littéral, ce qui permet d'atteindre les sessions imbriquées.
# 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 itUn cas courant : vous passez de votre ordinateur portable à un bastion, puis à un autre serveur. ~. tue la première connexion et tout ce qui transite par elle. ~~. fait transmettre par le premier ssh un tilde et un point au second, qui se charge de la déconnexion. Chaque tilde supplémentaire descend d'un niveau.
Les versions récentes d'OpenSSH désactivent ~C par défaut via l'option EnableEscapeCommandline. Si ~C ne fait rien, ajoutez EnableEscapeCommandline yes au bloc Host concerné. Exécuter des commandes locales avec !command depuis cette invite exige aussi PermitLocalCommand yes.
Quand une session SSH est vraiment morte et quand elle en a seulement l'air
Appuyez sur Entrée et tapez ~?. Si l'aide s'affiche, votre client ssh local fonctionne et le problème se situe dans le réseau ou sur le serveur. Gardez à l'esprit qu'il s'agit d'une vérification locale : elle ne dit rien de l'état du serveur, seulement que votre côté répond. Avant de couper la connexion, écartez trois faux blocages :
- Un Ctrl-S accidentel. Il suspend l'affichage du terminal via le contrôle de flux XOFF, et Ctrl-Q le rétablit.
- Une commande lente au premier plan. Essayez Ctrl-C : si le serveur répond, la session est vivante.
- Un programme plein écran qui attend une saisie. Un éditeur ou un pager peut sembler figé, et Échap ou
qpermet généralement d'en sortir.
Si rien de tout cela ne produit d'écho, la session est morte en pratique. C'est typique après un passage du wifi aux données mobiles, la mise en veille d'un ordinateur portable ou le redémarrage du serveur. Pour éviter d'attendre à l'aveugle, ServerAliveInterval fait envoyer au client des messages de contrôle à travers le canal chiffré. Dès que ServerAliveCountMax messages consécutifs restent sans réponse (3 par défaut), ssh se déconnecte de lui-même. ServerAliveInterval vaut 0 par défaut, ce qui signifie qu'il est désactivé.
Modifier ou désactiver l'EscapeChar SSH dans ~/.ssh/config
La directive EscapeChar définit le caractère d'échappement. Elle accepte un caractère unique, ^ suivi d'une lettre pour une combinaison Ctrl, ou none. En ligne de commande, l'équivalent est -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@serverAvec none, aucun échappement n'est disponible et la connexion est totalement transparente. C'est important lorsque des données binaires transitent par le canal et peuvent contenir un tilde après un retour à la ligne. Un caractère différent est judicieux pour les sessions imbriquées, afin que chaque saut ait le sien, ou lorsque votre disposition de clavier fait de ~ une touche morte. Chaque directive est décrite dans la page de manuel de ssh_config.
Séquences d'échappement SSH et Mosh : tableau comparatif
Mosh utilise une séquence différente : Ctrl-^ suivi d'un point met fin à la session. Voici les différences qui comptent quand une connexion se bloque :
| Élément comparé | SSH (OpenSSH) | Mosh |
|---|---|---|
| Séquence pour quitter | Entrée, puis ~ et un point | Ctrl-^ suivi d'un point |
| Transport | TCP, port 22 par défaut | UDP, ports 60000-61000 par défaut |
| Passage du wifi aux données mobiles | La connexion TCP se bloque généralement | La session reste active |
| Redirection de ports | -L, -R et -D, aussi via ~C | Ni redirection de ports ni redirection X11 |
| Démarrage | Connexion directe au serveur SSH | Lance mosh-server via une connexion SSH initiale |
Mosh n'a pas d'équivalent à ~C car il ne redirige pas de ports : si vous avez besoin d'un tunnel, ouvrez-le avec une connexion ssh séparée. Les détails figurent dans la documentation officielle de Mosh.
Fermer des sessions SSH figées depuis votre téléphone avec termi1
Sur les claviers tactiles d'iOS et d'Android, le tilde se trouve généralement sur une page de symboles secondaire, et la séquence exige aussi un appui préalable sur Entrée. termi1 ajoute sa propre rangée de touches avec Échap, Ctrl, Tab et les flèches, ce qui facilite la saisie de Ctrl-C, Ctrl-Q et de combinaisons comme le Ctrl-^ de Mosh.
Sur un téléphone, la cause la plus fréquente d'une session figée est un changement de réseau. termi1 maintient la session active avec Mosh lorsque vous passez du wifi aux données mobiles, et utilise tmux pour que ce que vous avez laissé tourner soit toujours là à votre retour. Si une connexion SSH classique se bloque malgré tout, fermez-la, reconnectez-vous et reprenez votre travail avec tmux attach. Le terminal termi1 pour iOS et Android est gratuit et fonctionne sans compte.
Questions fréquentes
Pourquoi ~. ne ferme-t-il pas ma session SSH ?
La séquence ~. ne ferme une session SSH que si elle commence une nouvelle ligne : appuyez donc sur Entrée avant le tilde. Elle échoue aussi lorsque EscapeChar vaut none, lorsque le caractère d'échappement a été modifié ou lorsque votre clavier traite ~ comme une touche morte et ne l'envoie jamais.
Quelle est la différence entre ~. et exit en SSH ?
La différence entre ~. et exit en SSH tient au lieu de traitement. exit s'exécute dans le shell distant et exige un serveur réactif. ~. est intercepté par votre client ssh local et coupe la connexion même si le réseau ou le serveur a disparu. Dans une session saine, exit reste la sortie propre.
Comment fermer une session SSH imbriquée sans fermer la session externe ?
Une session SSH imbriquée se ferme avec ~~. après avoir appuyé sur Entrée : le premier client transmet un tilde littéral et le second interprète ~. comme une déconnexion. Chaque tilde supplémentaire descend d'un niveau. Vous pouvez aussi attribuer à chaque saut son propre EscapeChar dans ~/.ssh/config.
Les processus distants s'arrêtent-ils quand je ferme SSH avec ~. ?
Les processus distants au premier plan s'arrêtent généralement lorsque ~. coupe la session SSH, car le shell perd son terminal. Pour qu'ils continuent de tourner, lancez-les dans tmux et rattachez-vous avec tmux attach après vous être reconnecté au serveur.
Quelle est la séquence d'échappement de Mosh ?
La séquence d'échappement de Mosh est Ctrl-^ suivi d'un point, et elle termine la session même lorsque le serveur ne répond plus. Mosh n'a pas de ligne de commande ~C, car il ne fait ni redirection de ports ni X11. Pour les tunnels, ouvrez une connexion SSH séparée avec -L, -R ou -D.