La secuencia de escape ~. de SSH cierra una sesión colgada desde el propio cliente, sin esperar al servidor: pulsa Intro, luego ~ y después el punto. Funciona porque OpenSSH interpreta el carácter de escape localmente, al principio de una línea, aunque la red o el servidor hayan dejado de responder.

Cómo funciona ~. en SSH: el carácter de escape de OpenSSH

El carácter de escape por defecto de OpenSSH es ~, y el cliente solo lo reconoce al principio de una línea, es decir, justo después de pulsar Intro. Si escribes ~. en mitad de un comando, se envía tal cual al servidor. Si lo escribes tras un salto de línea, lo intercepta tu ssh local y nunca sale por la red.

De ahí viene su utilidad. Cuando la conexión TCP está bloqueada, Ctrl-C y exit no sirven porque necesitan llegar al servidor. ~. no depende del servidor: corta la conexión desde tu lado y te devuelve el prompt local. Las secuencias solo están disponibles cuando se ha pedido una pseudoterminal, que es lo normal en una sesión interactiva. La lista completa está en la página de manual de ssh.

Secuencias de escape de SSH más útiles: ~., ~?, ~C y ~~

OpenSSH documenta estas secuencias, y todas se escriben tras pulsar Intro:

  • ~. desconecta la sesión inmediatamente.
  • ~? muestra la lista de secuencias que admite tu versión.
  • ~C abre la línea de comandos de ssh para añadir o cancelar reenvíos de puertos (-L, -R, -D, -KL, -KR, -KD).
  • ~# lista las conexiones reenviadas activas.
  • ~^Z manda ssh a segundo plano (Ctrl-Z tras la tilde).
  • ~B envía un BREAK al sistema remoto.
  • ~R pide renegociar las claves de la conexión.
  • ~v y ~V suben y bajan el nivel de detalle de los mensajes de diagnóstico.
  • ~~ envía una tilde literal, lo que permite actuar sobre sesiones anidadas.
# Pulsa Intro y después la secuencia
~.                           # cerrar esta sesión
~~.                          # cerrar la sesión anidada (ssh dentro de ssh)
~?                           # ver las secuencias disponibles
~C                           # abrir la línea de comandos de ssh
ssh> -L 8080:localhost:80    # añadir un túnel local en caliente
ssh> -KL 8080                # cancelarlo

Un caso típico: desde el portátil saltas a un bastión y desde ahí a otro servidor. ~. cierra la primera conexión y, con ella, todo lo que cuelga de ella. En cambio, ~~. hace que el primer ssh envíe una tilde y un punto al segundo, que es quien cierra. Cada tilde extra baja un nivel.

Las versiones recientes de OpenSSH desactivan ~C por defecto mediante la opción EnableEscapeCommandline. Si ~C no responde, añade EnableEscapeCommandline yes al bloque Host correspondiente. Ejecutar comandos locales con !comando desde esa línea requiere además PermitLocalCommand yes.

Cuándo una sesión SSH está realmente muerta y cuándo solo lo parece

Pulsa Intro y escribe ~?. Si aparece la ayuda, el cliente ssh local funciona y el bloqueo está en la red o en el servidor. Ojo: es una prueba local, así que no demuestra que el servidor siga vivo, solo que tu lado responde. Antes de cortar, descarta tres falsos cuelgues:

  1. Ctrl-S pulsado sin querer. Detiene la salida de la terminal por control de flujo (XOFF), y Ctrl-Q la reanuda.
  2. Un comando en primer plano que tarda. Prueba Ctrl-C: si el servidor contesta, la sesión vive.
  3. Un programa a pantalla completa esperando una tecla. Un editor o un paginador pueden parecer congelados, y Esc o q suelen bastar.

Si nada de eso devuelve eco, la sesión está muerta en la práctica. Es lo habitual tras pasar de wifi a datos, suspender el portátil o reiniciar el servidor. Para no esperar a ciegas, ServerAliveInterval hace que el cliente envíe mensajes de control por el canal cifrado. Si quedan sin respuesta ServerAliveCountMax mensajes seguidos (3 por defecto), ssh se desconecta solo. ServerAliveInterval vale 0 por defecto, es decir, está desactivado.

Cambiar o desactivar el EscapeChar de SSH en ~/.ssh/config

La directiva EscapeChar fija el carácter de escape. Acepta un carácter, ^ seguido de una letra para una combinación con Ctrl, o none. En la línea de comandos, el equivalente es -e.

Host *
    ServerAliveInterval 15
    ServerAliveCountMax 3

Host bastion
    HostName bastion.example.com
    EscapeChar ^]

# Una sola conexión sin escapes (sesión totalmente transparente)
ssh -e none usuario@servidor

Con none no hay escapes y la conexión es transparente. Resulta útil cuando por el canal pasan datos binarios que podrían contener una tilde tras un salto de línea. Cambiar el carácter tiene sentido en sesiones anidadas, para que cada nivel tenga el suyo, o si tu distribución de teclado convierte ~ en tecla muerta. Todas las directivas se describen en el manual de ssh_config.

Secuencias de escape de SSH frente a Mosh: tabla comparativa

Mosh usa otra secuencia: Ctrl-^ seguido de un punto cierra la sesión. Estas son las diferencias que importan cuando una conexión se cuelga:

Qué se mideSSH (OpenSSH)Mosh
Secuencia para cerrarIntro, después ~ y puntoCtrl-^ seguido de punto
TransporteTCP, puerto 22 por defectoUDP, puertos 60000-61000 por defecto
Paso de wifi a datosLa conexión TCP suele quedarse colgadaLa sesión se mantiene
Reenvío de puertos-L, -R y -D, también desde ~CNo hace port forwarding ni X11 forwarding
ArranqueConexión directa con el servidor SSHLanza mosh-server mediante una conexión SSH inicial

Mosh no tiene equivalente a ~C porque no reenvía puertos: si necesitas un túnel, ábrelo con ssh aparte. Los detalles están en la documentación oficial de Mosh.

Cerrar sesiones SSH colgadas desde el móvil con termi1

En los teclados táctiles de iOS y Android, la tilde suele estar en una página secundaria de símbolos, y la secuencia exige además pulsar Intro antes. termi1 añade un teclado propio con Esc, Ctrl, Tab y flechas, que facilita Ctrl-C, Ctrl-Q y combinaciones como el Ctrl-^ de Mosh.

En el móvil, la causa más común de una sesión colgada es el cambio de red. termi1 mantiene la sesión con Mosh al pasar de wifi a datos y usa tmux para que lo que dejas corriendo siga ahí al volver. Si una conexión SSH clásica se cuelga, ciérrala, vuelve a conectar y recupera el trabajo con tmux attach. La terminal de termi1 para iOS y Android es gratis y funciona sin cuenta.

Preguntas frecuentes

¿Por qué ~. no cierra mi sesión SSH?

La secuencia ~. no cierra la sesión SSH si no se escribe al principio de una línea, así que pulsa Intro antes de la tilde. Tampoco funciona si EscapeChar vale none, si se cambió el carácter de escape o si tu teclado trata ~ como tecla muerta y no envía el carácter.

¿Qué diferencia hay entre ~. y exit en SSH?

La diferencia entre ~. y exit en SSH está en dónde se procesan. exit lo ejecuta la shell remota y necesita que el servidor responda. ~. lo intercepta el cliente ssh local y corta la conexión aunque la red o el servidor estén caídos. Con una sesión sana, exit es la salida limpia.

¿Cómo cierro una sesión SSH anidada sin cerrar la exterior?

Una sesión SSH anidada se cierra con ~~. tras pulsar Intro: el primer cliente envía una tilde literal y el segundo interpreta ~. como desconexión. Cada tilde adicional baja un nivel. La alternativa es asignar un EscapeChar distinto a cada salto en ~/.ssh/config.

¿Se pierden los procesos remotos al cerrar SSH con ~.?

Los procesos remotos lanzados en primer plano suelen terminar cuando ~. corta la sesión SSH, porque la shell pierde su terminal. Para que sigan vivos, ejecútalos dentro de tmux y recupera la sesión con tmux attach al volver a conectar al servidor.

¿Cuál es la secuencia de escape de Mosh?

La secuencia de escape de Mosh es Ctrl-^ seguida de un punto, y cierra la sesión aunque el servidor no responda. Mosh no ofrece ~C porque no hace port forwarding ni X11 forwarding. Para crear túneles hay que abrir una conexión SSH aparte con -L, -R o -D.