Guide

Deinen Rechner von überall erreichen

Der Rechner, auf dem deine Agents laufen, steckt meistens hinter NAT – hinter einem Heimrouter, in einem Büronetz, als Laptop auf dem Schreibtisch. So erreichst du ihn vom iPhone, ohne SSH ins öffentliche Internet zu stellen.

Dafür gibt es zwei Wege. Entweder du leitest einen Port am Router weiter – oder du hängst beide Geräte in ein privates Mesh-Netzwerk, sodass dein iPhone eine stabile Adresse für den Rechner hat und im öffentlichen Internet überhaupt nichts lauscht. Dieser Guide nimmt den zweiten Weg, weil man auf dem ersten Server verliert.

1 Server ins Mesh hängen

Tailscale, NetBird, headscale oder eigenes WireGuard – unter der Haube sind alle ein WireGuard-Mesh. Ein Befehl auf dem Server, und er hat eine stabile Adresse, die nur deine eigenen Geräte erreichen.

Tailscale vergibt Adressen aus 100.64.0.0/10 und Namen wie m1-pro.your-tailnet.ts.net.

2 iPhone ins selbe Mesh hängen

Installiere die iOS-App des Anbieters und melde dich an. Sie richtet ein VPN-Profil ein. Moshpit ist an diesem Schritt überhaupt nicht beteiligt.

iOS führt immer nur einen VPN-Tunnel gleichzeitig aus; ein Firmen-VPN und dein Mesh laufen in der Regel nicht nebeneinander.

3 Verbindung in Moshpit anlegen

Host = Mesh-Name oder -Adresse. Port = 22, falls nicht geändert. Benutzername, dann SSH-Schlüssel unter ANMELDUNG.

Moshpit verbindet sich exakt mit der Adresse, die du eingibst. Das ist die gesamte Integration.

Moshpit bringt keinerlei VPN mit und hat keine Tailscale-Integration. Es wählt nichts an, routet nichts und sucht keine Geräte. Es öffnet eine TCP-Verbindung zu dem Host, der im Formular steht, und schickt für mosh UDP an dieselbe Adresse. Kann dein iPhone die Adresse erreichen, kann Moshpit es auch.

Im gespeicherten Verbindungsmodell gibt es ein Feld useTailscale. Nichts in der App liest es, und es steht nicht im Formular. Es ist ein Überbleibsel – wir sagen es lieber hier, bevor du nach dem Schalter suchst.

Zuerst, was du lassen solltest

Leite Port 22 nicht mit Passwort-Anmeldung weiter.

Ein frisch geöffneter SSH-Port wird innerhalb von Minuten von Scannern gefunden. Passwort-Anmeldung macht daraus ein Ratespiel mit unbegrenzten Versuchen, betrieben von Leuten, die nichts anderes tun. Ein Mesh entfernt das Ziel, statt es nur zu härten.

Wenn es wirklich keine Alternative gibt

In manchen Netzen ist ein Mesh unmöglich. Musst du SSH freigeben, ist reine Schlüssel-Anmeldung das Minimum – ausdrücklich Minimum, keine Empfehlung:

# /etc/ssh/sshd_config.d/moshpit.conf
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin no
AuthenticationMethods publickey
# Syntax prüfen, dann neu laden: sudo sshd -t && sudo systemctl reload ssh

Drei Dinge über Moshpit, die du vorher wissen solltest:

  • Zwei Anmeldemethoden, keine dritte. Passwort und öffentlicher Schlüssel. Es gibt kein keyboard-interactive; ein sshd mit TOTP-Abfrage lässt sich aus Moshpit also nicht bedienen.
  • Kein ProxyJump, kein Bastion, kein Agent-Forwarding im alten Modell. Beachte für aktuelle Jump-Host-Verbindungen die Jump-Host-Doku; Agent-Forwarding unterstützt Moshpit nicht. Das Feld forwardAgent existiert im Modell, wird aber nicht gelesen.
  • Passphrase-geschützte Inline-PEMs funktionieren nicht. Der Schlüssel wird ohne Entschlüsselungsschlüssel geladen, daher scheitert ein verschlüsseltes PEM. Erstelle stattdessen einen Schlüssel direkt in Moshpit (Einstellungen → SSH-Schlüssel → +) und leg seinen öffentlichen Teil auf dem Server ab – die liegen wahlweise in der Secure Enclave hinter Face ID.

Warum UDP wichtig ist

UDP taucht zweimal auf – aus verschiedenen Gründen.

Einmal darunter, weil WireGuard ein UDP-Protokoll ist. Einmal darüber, weil mosh es ist. Beide scheitern auf unterschiedliche Weise, deshalb lohnt es sich, sie im Kopf sauber zu trennen.

Das Mesh, darunter

wireguard · udp

  • Tailscale versucht, einen direkten UDP-Pfad zwischen beiden Geräten aufzubauen – Standardport 41641, ausgehend von beiden Seiten
  • Klappt das Durchstechen nicht, wird der Verkehr über ein Relay geleitet. Das funktioniert weiter, kostet aber Latenz
  • tailscale status auf einer der Seiten zeigt, was du bekommen hast – direct oder ein Relay
  • Dafür braucht dein Router keinen eingehenden Port

mosh, darüber

im Tunnel

  • Mosh ist durchgehend UDP – über ein Mesh also UDP im Tunnel; dein Router sieht davon nichts
  • mosh-server bindet einen Port pro Sitzung im eingestellten Bereich, Standard 60000–61000
  • Moshpit schickt Datagramme an denselben Host-Namen, den du im Formular eingegeben hast, auf den vom Server gemeldeten Port
  • Ohne funktionierenden SSH-Login startet mosh nicht – TCP muss klappen, bevor UDP überhaupt eine Rolle spielt
Der Start, ganz genau

SSH startet es und geht dann aus dem Weg

Moshpit führt über die angemeldete SSH-Sitzung einen einzigen Befehl aus, liest die eine Antwortzeile und schließt SSH wieder. Alles danach ist UDP.

Darum killt ein nach dem Start blockiertes SSH keine Mosh-Sitzung, blockiertes UDP aber sofort. Und darum fühlt sich mosh in einem Mesh, das TCP sauber trägt, UDP aber schlecht weiterleitet, schlechter an als einfaches 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 Base64-Zeichen = ein 16-Byte-AES-128-Schlüssel>

Was offen sein muss – und wo

WasPortRichtungWarum
SSHTCP 22 (oder dein Port) Eingehend auf dem Server Mosh hat keinen Standalone-Modus – SSH startet mosh-server und liefert den Schlüssel zurück
mosh-SitzungUDP 60000–61000 Eingehend auf dem Server, ausgehend vom iPhone Ein Port pro Sitzung, von mosh-server aus dem Bereich gewählt
Direkter Mesh-PfadUDP 41641 Ausgehend von beiden Enden Tailscales Standard. Blockiert heißt Relay, nicht defekt
Dein RouterNichts — Keine weitergeleiteten Ports. Genau darum geht es

In einem Mesh bedeutet „eingehend auf dem Server“ auf dem Mesh-Interface. Eine Host-Firewall greift dort trotzdem: ufw, firewalld und eine Cloud-Security-Group sitzen zwischen Tunnel und mosh-server. Den Bereich auf tailscale0 freizugeben ist etwas ganz anderes, als ihn ins Internet zu öffnen – und genau der Schritt, den fast alle vergessen.

Den Bereich änderst du unter Einstellungen → MOSH · ROAMING → UDP-Portbereich (Von / Bis, geprüft auf 1–65535 mit Von ≤ Bis). Das Verbindungsformular zeigt denselben Bereich schreibgeschützt. Liegt der Startport außerhalb, lässt Moshpit -p weg und mosh-server nutzt seinen Standard; ein unbrauchbares Ende nagelt die Sitzung auf den einzelnen Startport fest.

Die Falle

Wähle eine Adresse und nutze sie überall.

Das ist der Fehler, der am meisten wie ein Bug aussieht und keiner ist. Er kostet Leute regelmäßig einen Abend, also bekommt er einen eigenen Abschnitt.

Moshpit startet mosh-server new -s. Dieses Flag steht für moshs --bind-server=ssh, den Upstream-Standard seit mosh 1.4: Der Server bindet ausschließlich an die Adresse, über die die SSH-Verbindung hereinkam. Das ist bewusst so – die Datagramme nehmen dann denselben Weg wie dein Login.

Die Folge:

  • Eine zu Hause über 192.168.1.30 gestartete Sitzung hat einen mosh-server, der an 192.168.1.30 gebunden ist. Über das Mesh ist dieser Server unerreichbar.
  • Eine über das Mesh gestartete Sitzung bindet an die Mesh-Adresse und ist übers LAN unerreichbar.
  • Nichts davon ist ein Fehler in Moshpit. Genau das bedeutet --bind-server=ssh.

Also: Sichere die Verbindung mit dem Mesh-Namen und nutze sie auch zu Hause. Verkehr ins eigene LAN nimmt über ein Mesh ohnehin den direkten lokalen Weg. Eine Adresse, eine gespeicherte Verbindung, keine Überraschungen, wenn du das Haus verlässt.

Verwaiste mosh-server sammeln sich an

Jeder Verbindungsaufbau startet einen neuen mosh-server. Reißt die Leitung ab, beendet sich der alte nicht – er bleibt stehen und hält seinen UDP-Port. Über Wochen sammeln sie sich an. Moshpit räumt sie nicht ab, und das ist eine echte Lücke, keine Designentscheidung.

pgrep -fl mosh-server                 # was noch läuft
lsof -nP -iUDP | grep mosh-server     # und an welche Adresse jeder gebunden ist
pkill -f mosh-server                  # die grobe Lösung; beendet auch aktive Sitzungen

Die Bind-Adressen im zweiten Befehl taugen auch zur Diagnose: Sie zeigen dir, aus welchem Netz jede Sitzung gestartet wurde – das erklärt meistens schon, warum eine davon nicht mehr antwortet.

iOS

Die Berechtigung „Lokales Netzwerk“ – und wie eine Ablehnung aussieht

iOS sichert den Zugriff auf lokale Netzwerkadressen über eine einmalige Abfrage. Hast du sie vor Monaten weggetippt, bekommst du genau dieses Symptom.

Abfrage

Erscheint einmal

Bei der ersten Verbindung zu einer LAN-Adresse. Moshpits Begründung lautet: „Moshpit verbindet sich per SSH und mosh (UDP) mit Servern in deinem lokalen Netzwerk. Ohne diese Berechtigung schlagen Verbindungen zu Hosts wie 192.168.x.x fehl.“

Abgelehnt

SSH verbindet, mosh bleibt schwarz

iOS verwirft UDP an LAN-Adressen stillschweigend und sagt niemandem Bescheid. TCP bleibt unberührt, SSH läuft also tadellos – nur mosh bleibt hinter einem blinkenden Cursor schwarz.

Behebung

Einstellungen → Moshpit → Lokales Netzwerk

Die Abfrage kommt nicht von selbst zurück. Schalte sie dort ein und verbinde die Sitzung neu.

Geltungsbereich, klar gesagt: Das betrifft LAN-Adressen – 192.168.x.x, 10.x.x.x und Verwandte. Verkehr an eine Mesh-Adresse verlässt das Gerät stattdessen über das VPN-Tunnel-Interface. Erteile sie trotzdem, wenn du den Rechner auch nur vielleicht einmal über seine LAN-Adresse ansprichst – der Fehler sieht exakt aus wie ein Firewall-Problem und kostet dich sonst den Abend an der falschen Stelle.

Prüfen

Sechs Prüfungen, genau in dieser Reihenfolge

Jede schließt die Schicht darunter aus. Überspring nichts – die Antwort steckt fast immer in Schritt 1 oder 2.

1 · Ist der Peer online – und direkt?

tailscale status          # die Zeile endet auf „direct“ oder einem Relay-Namen
tailscale ip -4           # die Adresse fürs Host-Feld

Ein Peer über Relay funktioniert auch. Er ist langsamer, und an einem schlechten Tag ist das der Unterschied zwischen benutzbarem und unbenutzbarem Terminal.

2 · Klappt einfaches SSH von einem Laptop im selben Mesh?

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

Scheitert das, hör hier auf. Darüber kann nichts funktionieren – mosh hat keinen Standalone-Modus, und Moshpit ist zuerst ein SSH-Client.

3 · Kommt UDP wirklich hin und zurück?

Das ist der Test, den niemand macht – und der das Problem findet. Wähle einen Port aus deinem Bereich, lausche auf dem Server und sende von einem Rechner im selben Netz wie das iPhone:

# auf dem Server
echo REPLY | nc -u -l 60005 > /tmp/udp-in

# von einem Laptop im selben WLAN wie das iPhone
echo PING | nc -u -w3 m1-pro.your-tailnet.ts.net 60005

Beide Seiten müssen das Wort der anderen sehen. Sieht der Server PING, der Client aber nie REPLY, ist der Rückweg tot – genau der schwarze Mosh-Bildschirm. Das ist eine Netzwerk-Antwort, keine App-Antwort.

4 · Ist der Bereich auf dem Interface offen, über das der Verkehr ankommt?

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

Prüfe danach separat die Cloud-Security-Group, falls vorhanden. Und stelle sicher, dass es derselbe Bereich ist, den Moshpit nutzt – Standard ist 60000–61000, aber er ist änderbar.

5 · Frag die App, was sie sieht

Halte in einer Mosh-Sitzung die Transport-Pille in der oberen Terminalleiste gedrückt für MOSH-DIAGNOSE: datagrams, applied, parse fails, gaps. Die wichtigste Zeile ist die ohne Zahl:

MOSH-DIAGNOSE
   Noch keine Datagramme.

Das heißt: Es ist buchstäblich nichts zurückgekommen – der Zähler zählt schon vor jeder Entschlüsselung oder Auswertung. Toter Rückweg. Hör auf, Moshpit zu debuggen, und geh zurück zu Schritt 3.

6 · Notausgang nehmen

Schluckt ein Netz dein UDP und du brauchst jetzt ein Terminal, tippe im Banner auf Zu SSH wechseln – oder in der oberen Leiste auf die MOSH-Pille und bestätige „Zu SSH wechseln?“. SSH läuft per TCP über genau denselben Pfad, der die Datagramme verschluckt hat. Das Banner lässt sich schließen und blockiert das Terminal nie – deine Tastendrücke kamen die ganze Zeit am Server an; nur die Anzeige verhungerte.

⚠  Mosh empfängt keine Daten. Dein Netzwerk blockiert
   womöglich UDP (VPN, Proxy oder Firewall).

   Zu SSH wechseln                                  ×

Ein Messpunkt, kein Versprechen

Es gibt keine aggregierten Telemetriedaten. Es gibt einen Entwicklungs-Host, gegen den wir testen, und seine Messwerte sind hilfreicher als jedes Adjektiv.

Ein Mac über Tailscale, direkter Pfad über einen chinesischen Mobilfunk-Ausgang: RTT 433–640 ms, rund 13 % Paketverlust. Der SSH-Handshake dauert auf dieser Leitung 5,8–9 Sekunden. Mosh funktioniert darauf. Der erste Bildschirm einer reinen Mosh-Sitzung erscheint nach rund 10 Sekunden; Mosh plus tmux braucht zwei SSH-Handshakes und rund 20–25 Sekunden, bis die native Pfadleiste gefüllt ist.

Das ist eine Leitung, einmal gemessen, auf eigener Hardware. Kein Benchmark – deine Verbindung verhält sich anders. Es steht hier, weil „übersteht Paketverlust“ eine Behauptung ist, an die eine Zahl gehört.

Zwei Dinge, die wir an dieser Leitung gelernt haben und die du erwarten solltest: Ein Laptop im Ruhezustand fällt komplett aus dem Mesh (direct → relayed → offline), und ein tmux-Server mit schwerer Plugin-Konfiguration kann beim ersten Start hängen bleiben. Beides ist kein Netzwerkproblem – sieht aber exakt so aus.

Grenzen, die du kennen solltest, bevor du dich darauf verlässt

Was auch dann nicht klappt, wenn du den Rechner erreichst.

Im Hintergrund pausiert die App iOS pausiert Moshpit, seinen 12-Sekunden-Keepalive-Timer und sein Polling. Der Live-Status der Agents aktualisiert sich erst wieder, wenn du zurückkommst – Agent-Mitteilungen treffen trotzdem ein, weil der Host sie selbst Ende-zu-Ende versiegelt pusht. Warst du länger als 20 Sekunden weg, erzwingt Moshpit beim Zurückkehren eine frische Neuverbindung, statt einer Probe zu trauen, die auf einem halboffenen Socket falsch-positiv antworten kann.

Über mosh laufen tmux und herdr mit eigener TUI Mosh überträgt gerenderte Bildschirm-Diffs, keinen zeilenbasierten Bytestrom, sodass tmux -CC und herdrs Frame-Protokoll nicht darüber laufen können. Beide fallen in der Mosh-Shell auf ihre eigene Vollbild-Oberfläche zurück. Die nativen Listen werden nebenher von einer zweiten, schlanken SSH-Verbindung gespeist – trägt dein Mesh also UDP, blockiert aber SSH, bekommst du tmux ohne die nativen Listen.

herdrs Direkt-Attach ist exklusiv pro Panel Moshpit verbindet sich mit --takeover. Zwei Moshpit-Clients auf demselben herdr-Panel kämpfen darum und übernehmen es jeweils etwa alle zwei Sekunden neu. Das liegt an herdrs exklusivem Attach und lässt sich clientseitig nicht kaschieren. Eine Desktop-herdr-TUI hält keinen Attach-Owner, die Kombination gilt also als unproblematisch – geprüft haben wir sie nicht.

herdr 0.7.3 meldet keinen Panel-Befehl Das stabile Homebrew-Release liefert keinen Befehl pro Panel im Snapshot, daher fällt die Pfadleiste auf Panel N zurück. Kosmetisch, aber der einzige Weg zur Ansicht „Panel auswählen“ – gut zu wissen.

Vertraute Host-Schlüssel lassen sich nicht auflisten oder vergessen Bei der ersten Verbindung siehst du den Fingerabdruck und den passenden ssh-keygen-Befehl zum Abgleich. Danach gibt es keine Liste vertrauter Hosts und kein „Host vergessen“; eine Verbindung zu löschen lässt den Fingerabdruck stehen. Einen berechtigten Schlüsselwechsel bestätigst du im Warndialog – bewusst destruktiv markiert, mit Trennen als Standard.

Fragen

Konkret zum Erreichen des Rechners.

Muss ich Tailscale verwenden?

Nein. Moshpit verbindet sich mit einer Adresse; wie sie erreichbar wird, entscheidest komplett du. NetBird, headscale, reines WireGuard, ZeroTier, ein Firmen-VPN oder ein Server mit echter öffentlicher IP funktionieren aus Sicht der App alle identisch. Tailscale steht hier, weil es der kürzeste Weg von null bis fertig ist.

Kann sich Moshpit über einen Jump-Host verbinden?

Ja – seit Version 1.1.0 unterstützt Moshpit einen Jump-Host (ein Hop, über SSH, wie ssh -J). Siehe Jump-Hosts. Agent-Forwarding und Ketten aus mehreren Jump-Hosts gibt es nicht, und Mosh braucht weiterhin direktes UDP zum Ziel; ein Mesh macht einen Jump-Host oft überflüssig und erlaubt Mosh direkt.

Warum klappt es über 5G, aber nicht im Büro-WLAN?

Fast immer ein Netz, das ausgehendes UDP durchlässt, eingehende Antworten aber verwirft – ein Split-Tunnel-VPN-Profil, ein Proxy oder eine Firmen-Firewall. SSH funktioniert weiter, weil es per TCP denselben Weg nimmt. Mach den nc -u-Test oben aus diesem Netz; kommt dort keine Antwort, über Mobilfunk aber schon, hast du deine Ursache.

Kann ich Firmen-VPN und Mesh gleichzeitig laufen lassen?

Unter iOS in der Regel nicht, weil nur ein VPN-Tunnel gleichzeitig aktiv sein kann. Muss dein Firmen-VPN laufen, ist das Mesh aus, und dir bleibt das Routing des Firmennetzes. Das ist eine iOS-Grenze, die keine App umgehen kann.

Sieht Moshpit mein Mesh oder meine anderen Rechner?

Nein. Es gibt keine Netzwerksuche und kein Konto. Die App kennt nur die Verbindungen, die du eingetragen hast, und Terminalverkehr geht ausschließlich dorthin. Der einzige von Moshpit betriebene Teil ist das Push-Relay für versiegelte Agent-Mitteilungen, die es nicht lesen kann – dein Mesh und deine Sitzungen berührt es nie. Die Berechtigung „Lokales Netzwerk“ existiert nur, damit iOS kein UDP an LAN-Adressen verwirft, nicht zum Scannen.

Meine Mosh-Sitzung ist abgebrochen, als ich nach Hause kam. Warum?

Höchstwahrscheinlich wegen der Adresse. mosh-server bindet nur an die Adresse, über die dein SSH-Login ankam; eine über das Mesh gestartete Sitzung ist also aus dem LAN nicht erreichbar und umgekehrt. Sichere die Verbindung mit dem Mesh-Namen und nutze sie überall, auch zu Hause. Siehe Wähle eine Adresse oben.

Weiter mit Claude Code vom iPhone bedienen · Zurück zu den Guides