Mosh survit au passage du wifi à la 4G/5G parce qu'il ne repose pas sur une connexion TCP. Il envoie des datagrammes UDP, sur les ports 60000-61000 par défaut. Son protocole SSP synchronise l'état de l'écran, et le serveur accepte un client dont l'adresse IP change. SSH ne sert qu'au démarrage, pour s'authentifier et lancer mosh-server.

Comment Mosh démarre : SSH d'abord, puis mosh-server en UDP

Mosh ouvre d'abord une connexion SSH normale, généralement vers le port TCP 22, et s'en sert pour lancer mosh-server sur la machine distante. mosh-server choisit un port UDP dans la plage 60000-61000, génère une clé de session et la renvoie au client par ce canal SSH. La connexion SSH se ferme ensuite, et tout le trafic circule chiffré en UDP.

Cela a trois conséquences pratiques. Le serveur doit avoir mosh-server installé. L'authentification est du SSH classique : une clé Ed25519, une clé FIDO2 ed25519-sk ou un mot de passe. Et le pare-feu doit autoriser l'UDP en plus du TCP 22. Avec seulement le port 22 ouvert, la connexion réussit, mais le client ne reçoit jamais de réponse du serveur et vous n'arrivez jamais à l'invite de commande.

SSH ou Mosh en 4G/5G : ce qui se passe quand le réseau change

Une connexion TCP est identifiée par l'adresse IP et le port à chaque extrémité. Quand un téléphone passe du wifi aux données mobiles et obtient une nouvelle IP, cette connexion n'est plus valide. La session SSH meurt alors que le serveur fonctionne toujours.

CritèreSSH sur TCPMosh sur UDP
TransportFlux TCP, généralement port 22Datagrammes UDP, ports 60000-61000 par défaut
Changement d'IP du clientLa connexion se coupe ; il faut se reconnecterLe serveur répond à la nouvelle adresse
Brève perte de couvertureLa session se fige, puis finit par tomberL'écran actuel se synchronise au retour du réseau
Écho de la saisieAttend l'aller-retour vers le serveurPrédiction locale instantanée
Redirection de ports et X11OuiNon
Ports du pare-feuTCP 22TCP 22 pour démarrer, plus la plage UDP

SSP et itinérance IP : comment Mosh suit un téléphone d'un réseau à l'autre

SSP (State Synchronization Protocol) est le protocole de Mosh qui synchronise des objets d'état entre client et serveur au lieu de transporter un flux d'octets. Du serveur vers le client, l'objet est l'écran du terminal. Du client vers le serveur, ce sont vos frappes au clavier.

Chaque datagramme est chiffré et authentifié avec la clé de session. Quand le serveur reçoit un datagramme valide depuis une nouvelle adresse IP ou un nouveau port, il commence à répondre à cette adresse. C'est l'itinérance IP. Il n'y a ni renégociation ni nouvelle connexion : le nouveau réseau, qu'il s'agisse du wifi, de la 4G ou de la 5G, se met simplement à acheminer les paquets.

Comme Mosh synchronise un état plutôt qu'un flux, il n'a pas à renvoyer tout ce qui a été perdu pendant une coupure. Il envoie la différence entre le dernier écran confirmé et l'écran actuel. Si un processus affiche beaucoup de sortie pendant que vous êtes hors couverture, vous voyez l'écran final en vous reconnectant. Vous n'attendez pas qu'un arriéré de texte périmé finisse de défiler.

Prédiction locale de Mosh : écho instantané en 4G/5G à forte latence

Le client Mosh affiche ce que vous tapez avant que le serveur ne le confirme. C'est la prédiction locale, contrôlée par l'option --predict. En mode adaptive, celui par défaut, elle ne s'active que lorsque la latence le justifie. always la garde active et never la désactive.

Tant que le serveur n'a pas confirmé une prédiction, Mosh l'affiche soulignée. Si la réponse réelle diffère, par exemple dans un programme qui ne renvoie pas l'écho des touches, le client redessine l'écran. Sur un téléphone, on le remarque surtout en éditant dans vim ou nano sur données mobiles : le curseur réagit sans attendre chaque aller-retour.

Commandes Mosh pour les pare-feu, les ports SSH non standard et tmux

Ces commandes utilisent des options documentées de mosh, ufw et tmux. Remplacez l'utilisateur, l'hôte et les ports d'exemple par les vôtres.

# On the server: open Mosh's default UDP range (ufw)
sudo ufw allow 60000:61000/udp

# SSH listens on another port (2222 is an example)
mosh --ssh="ssh -p 2222" user@server

# Pin a single UDP port for strict firewalls
mosh -p 60001 user@server

# Go straight into tmux: create or reattach the "main" session
mosh user@server -- tmux new-session -A -s main

# Turn local prediction off
mosh --predict=never user@server

Le -- sépare les options de mosh de la commande distante. tmux new-session -A -s main s'attache à la session main si elle existe déjà et la crée dans le cas contraire. La même commande fonctionne donc pour la première connexion comme pour toutes les suivantes.

Ce que Mosh ne fait pas : redirection, X11, historique ou redémarrages

Mosh ne fait ni redirection de ports ni redirection X11. C'est la limite que la documentation officielle de Mosh met le plus en avant, mais ce n'est pas la seule :

  • Tunnels : pour -L, -R ou X11, il vous faut une connexion SSH séparée.
  • Historique de défilement : Mosh synchronise l'écran visible, pas tout ce qui a été affiché auparavant. Utilisez le mode copie de tmux pour retrouver l'historique.
  • Redémarrages : si le serveur redémarre ou si mosh-server s'arrête, la session est perdue. Le travail dans tmux survit à une déconnexion du client, pas à un redémarrage.
  • Réseaux sans UDP : si un réseau bloque l'UDP, Mosh ne peut pas se connecter. Pour les machines sans IP publique ni ports ouverts, un réseau mesh privé sans ports ouverts comme Prialo, ou Tailscale, donne accès sans exposer la plage UDP.
  • Fichiers : Mosh ne transfère pas de fichiers. Utilisez SFTP, ou scp, qui utilise par défaut le protocole SFTP depuis OpenSSH 9.0.

Mosh sur iOS et Android avec termi1 : tmux, clavier et SFTP

termi1 maintient la session avec Mosh quand vous passez du wifi aux données mobiles, et utilise tmux pour que tout ce que vous avez laissé tourner soit toujours là à votre retour. C'est un terminal mobile SSH et Mosh qui fonctionne entièrement sans compte. Le compte est facultatif et ne sert qu'à synchroniser les connexions et les raccourcis entre appareils.

Le clavier personnalisé couvre ce dont tmux a besoin et que le clavier système cache : Ctrl pour le préfixe Ctrl+b, Échap, Tab, les flèches et une couche fn avec F1–F12, PgUp/PgDn, Home et End. Comme Mosh ne transfère pas de fichiers, le SFTP intégré permet de parcourir, d'envoyer et de télécharger sans quitter la session. Les clés SSH sont générées sur le téléphone et stockées dans le stockage sécurisé du système, et la clé privée ne quitte jamais l'appareil.

L'IA transforme une phrase en commande, saisie à l'invite sans appuyer sur Entrée. Sur les connexions marquées comme production, Production Guard retient tout ce qui supprime, arrête ou modifie quelque chose. Pour un Mac, termi1 Companion (macOS 14 ou ultérieur) vérifie la connexion à distance, mosh-server et tmux. Vous pouvez le télécharger sur l'App Store ou sur Google Play.

Questions fréquentes

Quels ports Mosh nécessite-t-il sur le serveur ?

Mosh a besoin du port TCP de SSH, 22 par défaut, pour la connexion initiale qui lance mosh-server. Il lui faut aussi l'UDP sur la plage 60000-61000, sa plage par défaut. Avec mosh -p, vous pouvez fixer un seul port UDP et n'ouvrir que celui-ci dans le pare-feu.

Mosh remplace-t-il SSH ?

Mosh ne remplace pas SSH : il utilise SSH pour s'authentifier et lancer mosh-server, puis bascule la session interactive sur UDP. L'authentification, les clés et authorized_keys restent gérés par OpenSSH. Pour la redirection de ports, X11 ou les transferts de fichiers, il vous faut toujours SSH ou SFTP.

Mosh conserve-t-il la session si le serveur redémarre ?

Mosh ne conserve pas la session si le serveur redémarre, car le processus mosh-server s'arrête avec lui. Il résiste aux changements d'IP, aux pertes de couverture et à la mise en veille du client. Pour protéger un travail de longue durée des déconnexions du téléphone, lancez-le dans tmux.

Pourquoi Mosh n'arrive-t-il pas à se connecter sur certains réseaux mobiles ou d'entreprise ?

Mosh n'arrive pas à se connecter lorsqu'un réseau autorise SSH sur TCP mais bloque le trafic UDP. La connexion SSH réussit, mais le client ne reçoit jamais de réponse de mosh-server. La solution consiste à ouvrir la plage UDP ou à joindre la machine via un réseau mesh privé comme Prialo ou Tailscale.