Guide

Joindre votre machine depuis n’importe où

La machine sur laquelle tournent vos agents se trouve en général derrière un NAT — box domestique, réseau d’entreprise, ordinateur portable sur un bureau. Voici comment l’atteindre depuis un iPhone sans exposer SSH sur l’Internet public.

Il existe deux manières de régler le problème. La première consiste à ouvrir et rediriger un port sur le routeur. La seconde place les deux machines sur un réseau maillé privé, de sorte que votre iPhone dispose d’une adresse stable vers cette machine sans que rien n’écoute sur Internet. Ce guide suit la seconde voie, car la première est la meilleure façon de perdre un serveur.

1 Placer le serveur sur un réseau maillé

Tailscale, NetBird, headscale ou WireGuard configuré à la main — tous reposent sur un maillage WireGuard. Une seule commande sur le serveur lui donne une adresse stable que seuls vos propres appareils peuvent joindre.

Tailscale attribue des adresses dans 100.64.0.0/10 et un nom du type m1-pro.your-tailnet.ts.net.

2 Placer l’iPhone sur le même réseau

Installez l’app iOS de votre fournisseur et connectez-vous. Elle ajoute un profil VPN. Moshpit n’intervient à aucun moment à cette étape.

iOS ne fait tourner qu’un seul tunnel VPN à la fois : un VPN d’entreprise et votre réseau maillé ne peuvent généralement pas être actifs en même temps.

3 Ajouter la connexion dans Moshpit

Hôte = le nom ou l’adresse sur le réseau maillé. Port = 22 sauf si vous l’avez changé. Nom d’utilisateur, puis Clé SSH sous AUTHENTIFICATION.

Moshpit se connecte exactement à l’adresse que vous saisissez. L’intégration se résume à cela.

Moshpit n’inclut aucun VPN et aucune intégration Tailscale. Il ne compose pas de tunnel, ne route pas et ne découvre pas vos machines. Il ouvre une connexion TCP vers la chaîne saisie dans le champ Hôte et, pour mosh, envoie de l’UDP vers cette même adresse. Si votre iPhone peut joindre cette adresse, Moshpit le peut aussi.

Il existe un champ useTailscale dans le modèle de connexion enregistré. Rien dans l’app ne le lit et il n’apparaît pas dans le formulaire. C’est un vestige ; mieux vaut vous le dire ici que de vous laisser chercher l’option.

D’abord, ce qu’il ne faut pas faire

N’ouvrez pas le port 22 avec une authentification par mot de passe.

Un port SSH exposé est repéré par les scanners en quelques minutes. L’authentification par mot de passe transforme cela en jeu de devinettes à essais illimités, mené par des robots qui ne font que ça. Un réseau maillé supprime la cible au lieu de la durcir.

Si vous n’avez vraiment aucune autre option

Certains réseaux rendent un maillage impossible. Si vous devez absolument exposer SSH, le strict minimum est l’authentification par clé uniquement — et notez bien que c’est un minimum, pas une recommandation :

# /etc/ssh/sshd_config.d/moshpit.conf
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
AuthenticationMethods publickey
# vérifiez la syntaxe puis rechargez : sudo sshd -t && sudo systemctl reload ssh

Trois détails à connaître sur Moshpit avant de bâtir votre configuration autour :

  • Deux méthodes d’authentification, pas de troisième. Mot de passe et clé publique. Pas de keyboard-interactive : un sshd configuré pour demander un code TOTP ne pourra pas vous authentifier depuis Moshpit.
  • Pas de transfert d’agent SSH (agent forwarding). Si vous devez passer par un bastion ou un nœud de connexion, configurez un hôte de rebond dans Moshpit (un saut en SSH) ; le transfert d’agent (forwardAgent) n’est pas pris en charge.
  • Les clés privées chiffrées par phrase secrète ne fonctionnent pas en collage direct. Une clé PEM collée sur la connexion est chargée sans déchiffrement. Générez plutôt une clé dans Moshpit (Réglages → Clés SSH → +) et ajoutez sa partie publique sur le serveur — elle peut être protégée par la Secure Enclave et Face ID.

Pourquoi l’UDP compte

L’UDP intervient deux fois, pour deux raisons différentes.

Une première fois dessous, parce que WireGuard repose sur l’UDP. Une seconde fois dessus, parce que mosh aussi. Ils tombent en panne différemment : mieux vaut bien les distinguer.

Le réseau maillé, dessous

wireguard · udp

  • Tailscale tente d’établir un chemin UDP direct entre les deux machines — son port d’écoute par défaut est 41641, en sortie des deux côtés
  • Quand il ne parvient pas à traverser le NAT, il relaie le trafic. Cela fonctionne toujours, au prix d’une latence plus élevée
  • tailscale status de chaque côté vous dit lequel vous avez obtenu — direct ou un relais
  • Rien ici n’exige de port entrant sur votre routeur

mosh, par-dessus

à l’intérieur du tunnel

  • Mosh utilise l’UDP de bout en bout et, sur un réseau maillé, c’est de l’UDP dans le tunnel — votre routeur ne le voit jamais
  • mosh-server occupe un port par session dans la plage configurée, par défaut 60000–61000
  • Moshpit envoie ses datagrammes vers la même adresse d’hôte que celle saisie dans le formulaire, sur le port communiqué par le serveur
  • Mosh ne peut pas démarrer sans une connexion SSH fonctionnelle d’abord — TCP doit passer avant même que l’UDP n’entre en jeu
L’amorçage, exactement

SSH le démarre, puis s’efface

Moshpit exécute une seule commande sur la session SSH authentifiée, lit l’unique ligne qu’elle affiche, puis ferme SSH. Tout ce qui suit passe en UDP.

C’est pourquoi couper SSH après la connexion ne tue pas une session mosh, tandis que bloquer l’UDP la fige. C’est aussi pourquoi un réseau maillé qui transporte bien le TCP mais relaie mal l’UDP rend mosh moins agréable qu’un simple SSH.

PATH="$PATH:/opt/homebrew/bin:/opt/homebrew/sbin:/usr/local/bin:/usr/local/sbin:$HOME/.local/bin" \
  mosh-server new -s -c 256 -p 60000:61000 -l LANG=en_US.UTF-8

MOSH CONNECT 60001 <22 car. base64 = une clé AES-128 de 16 octets>

Ce qui doit être ouvert, et où

ÉlémentPortSensPourquoi
SSHTCP 22 (ou votre Port) Entrant sur le serveur Mosh n’a pas de mode autonome — SSH lance mosh-server et rapporte la clé
Session moshUDP 60000–61000 Entrant sur le serveur, sortant depuis l’iPhone Un port par session, choisi par mosh-server dans la plage
Chemin direct mailléUDP 41641 Sortant des deux côtés Port par défaut de Tailscale. Bloqué signifie relayé, pas cassé
Votre routeurRien — Aucune redirection de port. C’est tout l’intérêt de cette méthode

Sur un réseau maillé, « entrant sur le serveur » signifie sur l’interface du maillage. Un pare-feu hôte s’y applique toujours : ufw, firewalld et un groupe de sécurité cloud se trouvent entre le tunnel et mosh-server. Ouvrir la plage sur tailscale0 n’a rien à voir avec l’ouvrir au monde entier, et c’est généralement l’étape que l’on oublie.

Modifiez la plage dans Réglages → MOSH · ITINÉRANCE → Plage de ports UDP (De / À, validée entre 1 et 65535 avec De ≤ À). Le formulaire de connexion affiche la même plage en lecture seule. Un port de début hors plage supprime totalement -p et laisse mosh-server utiliser sa plage par défaut ; une borne de fin invalide épingle la session sur le seul port de début.

Le piège

Choisissez une adresse et utilisez-la partout.

Voici la panne qui ressemble le plus à un bug alors que ce n’en est pas un. Elle fait perdre une soirée entière, alors elle mérite sa propre section.

Moshpit lance mosh-server new -s. Cette option correspond à --bind-server=ssh, le comportement par défaut depuis mosh 1.4 : le serveur ne s’attache qu’à l’adresse sur laquelle la connexion SSH est arrivée. C’est volontaire, afin que les datagrammes empruntent le même chemin que votre connexion initiale.

Conséquence :

  • Une session démarrée chez vous en vous connectant à 192.168.1.30 lance un mosh-server attaché à 192.168.1.30. Depuis le réseau maillé, ce serveur est injoignable.
  • Une session démarrée via le réseau maillé s’attache à l’adresse du maillage et est injoignable depuis le LAN.
  • Dans aucun des deux cas Moshpit ne se trompe : c’est exactement ce que fait --bind-server=ssh.

Donc : enregistrez la connexion avec son nom sur le réseau maillé et utilisez-la aussi chez vous. Sur votre propre LAN, le trafic maillé prend de toute façon un chemin local direct. Une adresse, une connexion enregistrée, aucune surprise en sortant de chez vous.

Les processus mosh-server orphelins s’accumulent

Chaque connexion démarre un nouveau mosh-server. Quand la liaison meurt, l’ancien ne quitte pas : il reste en place en gardant son port UDP. Au fil des semaines de reconnexions, ils s’empilent. Moshpit ne les nettoie pas, et c’est une vraie lacune, pas un choix de conception.

pgrep -fl mosh-server                 # ce qui tourne encore
lsof -nP -iUDP | grep mosh-server     # et sur quelle adresse chacun écoute
pkill -f mosh-server                  # la méthode radicale ; tue aussi les sessions actives

Les adresses d’écoute de la deuxième commande servent aussi de diagnostic : elles révèlent depuis quel réseau chaque session a été créée, ce qui suffit presque toujours à expliquer pourquoi l’une d’elles a cessé de répondre.

iOS

L’autorisation Réseau local, et ce qui arrive si vous la refusez

iOS protège l’accès aux adresses du réseau local derrière une demande unique. Si vous l’avez refusée il y a des mois, voici le symptôme que vous obtiendrez.

Demande

N’apparaît qu’une fois

Lors de la première connexion à une adresse LAN. Le message de Moshpit est : « Moshpit se connecte en SSH et mosh (UDP) aux serveurs de votre réseau local. Sans cette autorisation, les connexions à des hôtes comme 192.168.x.x échouent. »

Refusée

SSH se connecte, mosh reste noir

iOS jette silencieusement les paquets UDP vers les adresses LAN sans prévenir personne. TCP n’est pas affecté : SSH fonctionne donc parfaitement et seul mosh reste sur un écran noir avec un curseur actif.

Correctif

Réglages → Moshpit → Réseau local

La demande ne revient jamais d’elle-même. Activez l’option dans Réglages, puis reconnectez la session.

Portée, dite clairement : cela contrôle les adresses LAN — 192.168.x.x, 10.x.x.x et consorts. Le trafic vers une adresse du réseau maillé passe quant à lui par l’interface tunnel VPN. Accordez l’autorisation quand même s’il y a la moindre chance que vous joigniez la machine par son adresse LAN, car la panne produite est impossible à distinguer d’un problème de pare-feu et vous ferait chercher au mauvais endroit toute la soirée.

Vérifier

Six vérifications, dans cet ordre

Chacune écarte la couche en dessous. Ne sautez pas d’étape : la réponse se trouve presque toujours à l’étape 1 ou 2.

1 · Le pair est-il en ligne, et en direct ?

tailscale status          # la ligne du pair se termine par « direct » ou un nom de relais
tailscale ip -4           # l’adresse à mettre dans le champ Hôte

Un pair relayé fonctionne quand même. Il est plus lent, et les mauvais jours c’est ce qui sépare un terminal utilisable d’un terminal pénible.

2 · Un simple SSH fonctionne-t-il depuis un ordinateur sur le même maillage ?

ssh -v user@m1-pro.your-tailnet.ts.net

Si cela échoue, arrêtez-vous là. Rien au-dessus ne peut marcher : mosh n’a pas de mode autonome, et Moshpit est un client SSH avant tout.

3 · L’UDP fait-il vraiment l’aller-retour ?

C’est la vérification que personne ne fait, et celle qui trouve le problème. Choisissez un port dans votre plage, écoutez sur le serveur, envoyez depuis une machine sur le même réseau que l’iPhone :

# sur le serveur
echo REPLY | nc -u -l 60005 > /tmp/udp-in

# depuis un ordinateur sur le même Wi-Fi que l’iPhone
echo PING | nc -u -w3 m1-pro.your-tailnet.ts.net 60005

Chaque côté doit voir le mot de l’autre. Le serveur voit PING mais le client ne voit jamais REPLY = le chemin de retour est mort, ce qui produit exactement l’écran noir de mosh. C’est un diagnostic réseau, pas un bug de l’app.

4 · La plage est-elle ouverte sur l’interface qui reçoit le trafic ?

sudo ufw status verbose                       # Debian / Ubuntu
sudo firewall-cmd --list-all                  # Fedora / RHEL
sudo ufw allow in on tailscale0 to any port 60000:61000 proto udp

Vérifiez ensuite séparément le groupe de sécurité cloud s’il y en a un. Et assurez-vous qu’il s’agit bien de la même plage que celle configurée dans Moshpit : 60000–61000 par défaut, mais modifiable.

5 · Demandez à l’app ce qu’elle voit

Appuyez longuement sur la pilule de transport en haut du terminal lors d’une session mosh pour ouvrir DIAGNOSTIC MOSH : datagrams, applied, parse fails, gaps. La ligne la plus importante n’est pas un nombre :

DIAGNOSTIC MOSH
   Aucun datagramme reçu.

Cela signifie littéralement que rien n’est revenu — le compteur s’incrémente avant tout déchiffrement ou analyse. Chemin de retour coupé. Inutile de déboguer Moshpit : revenez à l’étape 3.

6 · Prenez la sortie de secours

Si un réseau avale vos paquets UDP et que vous avez besoin d’un terminal tout de suite, touchez Basculer vers SSH sur la bannière, ou la pilule MOSH dans la barre du haut puis confirmez « Basculer vers SSH ? ». SSH passe en TCP par le même chemin qui rejetait les datagrammes. La bannière se ferme sans bloquer le terminal : vos frappes arrivaient au serveur depuis le début, seul l’affichage était affamé.

⚠  Mosh ne reçoit aucune donnée. Votre réseau bloque
   peut-être l’UDP (VPN, proxy ou pare-feu).

   Basculer vers SSH                                ×

Un point de mesure, pas une promesse

Plutôt que des adjectifs vagues, voici les mesures relevées sur un hôte de développement contre lequel nous testons régulièrement.

Un Mac via Tailscale, chemin direct sur une sortie mobile chinoise : RTT de 433 à 640 ms, environ 13 % de perte de paquets. La négociation SSH prend de 5,8 à 9 secondes sur cette liaison. Mosh y fonctionne. Le premier écran d’une session mosh nue arrive en une dizaine de secondes ; mosh plus tmux nécessite deux négociations SSH et prend de 20 à 25 secondes avant que le fil d’Ariane natif ne se remplisse.

Ce n’est qu’une liaison, mesurée une fois sur notre propre matériel. Ce n’est pas un benchmark et votre connexion sera différente. Elle est là parce qu’une promesse comme « survit à la perte de paquets » mérite un chiffre en face.

Deux leçons de cette liaison à garder en tête : un ordinateur portable qui se met en veille disparaît complètement du réseau maillé (direct → relayé → hors ligne), et un serveur tmux chargé de plugins peut se bloquer au premier démarrage. Aucun des deux n’est un problème réseau, mais les deux y ressemblent à s’y méprendre.

Limites à connaître avant de compter dessus

Ce qui ne fonctionne toujours pas une fois la machine jointe.

L’app est suspendue en arrière-plan iOS suspend Moshpit, son minuteur keepalive de 12 secondes et ses requêtes périodiques. L’état en direct des agents cesse de se mettre à jour jusqu’à votre retour dans l’app, puis rattrape son retard — les alertes d’agents arrivent quand même, car c’est l’hôte qui les envoie lui-même, chiffrées de bout en bout. Au-delà de 20 secondes d’absence, Moshpit force une reconnexion propre au retour plutôt que de faire confiance à une sonde qui pourrait répondre faussement sur un socket à moitié ouvert.

Sur mosh, tmux et herdr affichent leur propre TUI Mosh transmet des différences d’écran déjà rendues, pas un flux d’octets découpé en lignes : tmux -CC et le protocole de trames de herdr ne peuvent donc pas y circuler. Tous deux se rabattent sur leur interface plein écran dans le shell mosh. Les feuilles natives sont alimentées par une seconde connexion SSH légère à côté — si votre réseau maillé passe l’UDP mais bloque SSH, vous aurez tmux sans les listes natives.

Le rattachement direct de herdr est exclusif par panneau Moshpit se rattache avec --takeover. Deux clients Moshpit pointant sur le même panneau herdr se le disputent, chacun le reprenant toutes les deux secondes environ. C’est inhérent au rattachement exclusif de herdr et le client ne peut pas le masquer. Une TUI herdr sur ordinateur ne détient pas de verrou de rattachement, ce qui devrait rendre cette combinaison sûre — nous ne l’avons pas vérifiée.

herdr 0.7.3 ne signale pas la commande du panneau La version stable Homebrew n’inclut pas la commande du panneau dans ses instantanés, si bien que le fil d’Ariane affiche panneau N. C’est cosmétique, mais comme c’est le seul accès à la feuille Choisir un panneau, il est utile de le savoir.

Les clés d’hôte approuvées ne peuvent pas être listées ni oubliées La première connexion affiche l’empreinte et la commande ssh-keygen pour la vérifier. Ensuite, il n’existe pas d’écran listant les hôtes approuvés ni d’option « oublier cet hôte », et supprimer une connexion laisse son empreinte en mémoire. Un renouvellement légitime se gère en acceptant le changement dans la boîte d’alerte — où le bouton est volontairement en style destructif, avec Se déconnecter par défaut.

Questions

Spécifiquement sur l’accès à la machine.

Dois-je obligatoirement utiliser Tailscale ?

Non. Moshpit se connecte à une adresse ; la manière dont cette adresse devient joignable dépend entièrement de vous. NetBird, headscale, WireGuard nu, ZeroTier, un VPN d’entreprise ou un serveur doté d’une vraie IP publique fonctionnent exactement de la même façon du point de vue de l’app. Tailscale est cité ici parce que c’est le chemin le plus court entre rien et une connexion qui marche.

Moshpit peut-il passer par un hôte de rebond ?

Oui, depuis la version 1.1.0, pour un saut en SSH (équivalent de ssh -J). Enregistrez le bastion comme connexion, puis sélectionnez-le sous Hôte de rebond › Se connecter via sur la machine cible. En revanche, les chaînes de plusieurs sauts, le transfert d’agent SSH et Mosh à travers un hôte de rebond ne sont pas pris en charge — un réseau maillé évite ce détour et permet aussi d’utiliser Mosh en direct.

Pourquoi ça marche en 5G mais pas sur le Wi-Fi du bureau ?

Presque toujours à cause d’un réseau qui laisse sortir l’UDP mais bloque les réponses entrantes — un profil VPN en tunnel partagé, un proxy ou un pare-feu d’entreprise. SSH continue de fonctionner parce qu’il emprunte TCP sur le même chemin. Lancez le test nc -u ci-dessus depuis ce réseau : si la réponse n’arrive jamais là-bas mais passe en cellulaire, vous avez votre réponse.

Puis-je utiliser mon VPN d’entreprise et un réseau maillé en même temps ?

Généralement non sur iOS, qui ne fait tourner qu’un seul tunnel VPN à la fois. Si votre VPN d’entreprise doit rester actif, le réseau maillé ne peut pas l’être et vous dépendez des routes offertes par le réseau de l’entreprise. C’est une contrainte d’iOS, qu’aucune app ne peut contourner.

Moshpit voit-il mon réseau maillé ou mes autres machines ?

Non. Il n’a ni découverte réseau ni compte. Il ne connaît que les connexions que vous avez saisies, et le trafic du terminal n’y va que là. Le seul composant exploité par Moshpit est le relais push, qui transporte des alertes d’agents chiffrées illisibles — il ne touche jamais à votre réseau maillé ni à vos sessions. L’autorisation Réseau local sert uniquement à empêcher iOS de jeter l’UDP vers les adresses LAN, pas à scanner quoi que ce soit.

Ma session mosh est morte en rentrant chez moi. Pourquoi ?

Très probablement à cause de l’adresse. mosh-server ne s’attache qu’à l’adresse sur laquelle votre connexion SSH est arrivée : une session ouverte via le maillage est donc injoignable depuis le LAN, et inversement. Enregistrez la connexion avec le nom sur le réseau maillé et utilisez-la partout, y compris chez vous. Voir Choisissez une adresse ci-dessus.

Poursuivre avec Piloter Claude Code depuis votre iPhone · Retour aux guides