Zum Inhalt springen
Localtonet Localtonet Dashboard

Einen Tunnel mit dem SSH-Client starten

Kostenloser Plan HTTP- und TCP-Tunnel

Hilfe zu dieser Seite
Auf dieser Seite 11 Abschnitte
  1. Wann Sie es einsetzen
  2. Bevor Sie beginnen
  3. Schritte
  4. HTTP- oder TCP-Tunnel erstellen
  5. SSH-Befehl öffnen
  6. Festlegen, ob die Verbindung wiederhergestellt werden soll
  7. Befehl ausführen
  8. Fenster geöffnet lassen
  9. Über den Tunnel-Einrichtungsassistenten
  10. Der Befehl im Detail
  11. Automatische Wiederverbindung
  12. Wie lange ein Befehl gültig bleibt
  13. Limits
  14. Was Sie im Dashboard sehen
  15. Fehlerbehebung
  16. Meldungen im Dashboard
  17. Meldungen im Terminal
  18. Verwandte Seiten

Bringen Sie einen lokalen Dienst online, ohne Localtonet zu installieren. Das Dashboard liefert Ihnen einen fertigen ssh-Befehl; solange dieser Befehl läuft, ist Ihr HTTP- oder TCP-Tunnel aktiv.

Wann Sie es einsetzen #

Nutzen Sie Zero-install SSH auf einem Rechner, auf dem Sie den Localtonet-Client nicht installieren können oder wollen, zum Beispiel auf einem Server, auf den Sie nur kurz zugreifen, auf einem stark abgesicherten Arbeitsrechner oder für eine schnelle Demo. Der ssh-Client, der mit Windows, macOS und Linux geliefert wird, reicht dafür aus.

Der SSH-Befehl ersetzt den Localtonet-Client für einen einzelnen Tunnel. Alles andere bleibt im Dashboard: die Adresse des Tunnels, seine Einstellungen, seine Protokolle und seine Bandbreite.

TunneltypSSH-Befehl
HTTP / HTTPSVerfügbar
TCPVerfügbar
UDP, UDP / TCP Mixed, TLS, Dateiserver, Proxy-Server und die übrigen TypenNicht verfügbar. Diese Typen benötigen den Localtonet-Client.

Auf dieser Seite geht es nicht darum, einen SSH-Server zu erreichen. Wie Sie Ihren eigenen SSH-Server über einen Tunnel veröffentlichen, lesen Sie unter Localtonet mit SSH verwenden. Wie Sie über das Dashboard eine Shell auf einem Ihrer Geräte öffnen, lesen Sie unter Geräte-Terminal.

Bevor Sie beginnen #

  • Ein Localtonet-Konto und ein bereits laufender Dienst, zum Beispiel eine Web-App auf Port 3000.
  • Ein ssh-Client auf dem Rechner, der den Dienst erreichen kann. Prüfen Sie dies mit ssh -V.
  • Ausgehende TCP-Verbindungen zu Port 223 müssen im Netzwerk dieses Rechners erlaubt sein.
  • Ein AuthToken, den kein laufender Localtonet-Client verwendet. Ein Tunnel gehört immer zu einem Token, doch bei SSH meldet sich kein Client damit an. Ist ein Client mit dem Token des Tunnels verbunden, stellt das Dashboard den Befehl nicht aus.

Schritte #

  1. HTTP- oder TCP-Tunnel erstellen #

    Öffnen Sie Meine Tunnel › HTTP oder Meine Tunnel › TCP - UDP (Protokoll TCP) und erstellen Sie den Tunnel wie gewohnt. Lokale IP-Adresse und Lokaler Port geben an, wohin der SSH-Client den Datenverkehr sendet: 127.0.0.1 und der Port Ihres Dienstes, wenn Sie den Befehl auf demselben Rechner wie den Dienst ausführen. Lassen Sie den Tunnel gestoppt.

  2. SSH-Befehl öffnen #

    Wählen Sie in der Tunnelliste für den Tunnel Einstellungen und dann SSH-Befehl anzeigen. Der Dialog SSH-Befehl öffnet sich mit dem Befehl für diesen Tunnel. Ein Hinweis nennt Ihnen, wie viele Sekunden Ihnen zum Ausführen bleiben; ein nicht verwendeter Befehl läuft ab, und Sie fordern dann auf dieselbe Weise einen neuen an.

  3. Festlegen, ob die Verbindung wiederhergestellt werden soll #

    Lassen Sie Automatisch wiederverbinden ausgeschaltet, um den einfachen ssh-Befehl zu erhalten. Schalten Sie die Option ein, damit der Befehl in eine Schleife eingebettet wird, die ihn neu startet, sobald die Verbindung abbricht. Wählen Sie dann unter Wo Sie ihn ausführen, für welche Shell die Schleife geschrieben wird: PowerShell, Eingabeaufforderung oder macOS oder Linux.

  4. Befehl ausführen #

    Kopieren Sie den Text unter Befehl. Öffnen Sie ein Terminal auf dem Rechner, auf dem Ihr Dienst läuft, fügen Sie den Befehl ein und drücken Sie Enter. Es wird kein Passwort abgefragt. Sobald die Verbindung steht, zeigt das Terminal die Endpunkte des Tunnels an:

    Terminal
    +--------------------------------------------------------------+
    | Welcome to Localtonet!                                       |
    +--------------------------------------------------------------+
    | Localtonet Tunnel Endpoints                                  |
    +--------------------------------------------------------------+
    | HTTP => http://<YOUR_ADDRESS> => 127.0.0.1:3000               |
    | HTTPS => https://<YOUR_ADDRESS> => 127.0.0.1:3000             |
    +--------------------------------------------------------------+
    | Server Time: ...                                             |
    +--------------------------------------------------------------+
    
    You can view your requests and configure your tunnel settings from the Localtonet Dashboard.

    Ein TCP-Tunnel zeigt stattdessen eine einzelne Zeile: TCP => <YOUR_ADDRESS>:<PORT> => 127.0.0.1:<LOCAL_PORT>.

  5. Fenster geöffnet lassen #

    Der Tunnel startet von selbst, sobald der Befehl eine Verbindung herstellt; Sie wählen nicht Starten. Er bleibt so lange online, wie der Befehl läuft. Schließen Sie das Fenster, endet die Verbindung, und die öffentliche Adresse antwortet nicht mehr. Um den Befehl selbst zu beenden, geben Sie exit ein und drücken Enter, oder drücken Sie Ctrl + C.

    Wenn Sie den Befehl beenden, wird der Tunnel im Dashboard nicht gestoppt. Er bleibt gestartet, seine Verbindung wird als getrennt angezeigt, damit sich derselbe Befehl erneut verbinden kann. Wenn Sie den Tunnel nicht mehr brauchen, wählen Sie im Dashboard für ihn Stoppen. Das Dashboard stellt nur für einen gestoppten Tunnel einen neuen SSH-Befehl aus.

Über den Tunnel-Einrichtungsassistenten #

Der Tunnel-Einrichtungsassistent im Dashboard bietet denselben Befehl an. Wählen Sie im letzten Schritt, in dem Sie Ihre Plattform auswählen, SSH und dann SSH-Befehl holen. Die Auswahl SSH erscheint nur bei HTTP- und TCP-Tunneln. Der Assistent zeigt Warten auf SSH, bis Ihr Befehl eine Verbindung herstellt, und danach Über SSH verbunden. Automatisch wiederverbinden fügt dieselbe Wiederverbindungsschleife hinzu, und Neuen Befehl holen ersetzt einen abgelaufenen Befehl.

Der Befehl im Detail #

Der Befehl hat immer diesen Aufbau. Das Dashboard setzt die Werte für Ihren Tunnel ein:

Bash
ssh -o ExitOnForwardFailure=yes -o ServerAliveInterval=15 -o ServerAliveCountMax=3 -o ConnectTimeout=15 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o LogLevel=ERROR -p 223 -l <COMMAND_KEY> <TUNNEL_ADDRESS> -R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>
TeilFunktion
-p 223Verbindet sich mit Port 223, auf dem Localtonet diese SSH-Verbindungen annimmt.
-l <COMMAND_KEY>Der Anmeldename. Er ist ein Schlüssel, den das Dashboard für diesen Tunnel erzeugt, nicht Ihr AuthToken und nicht Ihr Kontopasswort. Er teilt Localtonet mit, welcher Tunnel gestartet werden soll, weshalb kein Passwort abgefragt wird.
<TUNNEL_ADDRESS>Die Adresse Ihres Tunnels. Die SSH-Verbindung geht an den Server, der ihn hostet.
-R<SERVER_PORT>:<LOCAL_IP>:<LOCAL_PORT>Die Remote-Weiterleitung: Verbindungen, die auf dem Server für den Tunnel eingehen, werden über die SSH-Verbindung an <LOCAL_IP>:<LOCAL_PORT> gesendet. Die letzten beiden Werte sind die Lokale IP-Adresse und der Lokale Port des Tunnels. Der Serverport wird von Localtonet vergeben und darf nicht geändert werden.
-o ExitOnForwardFailure=yesBeendet ssh, wenn die Weiterleitung nicht eingerichtet werden kann, statt ohne funktionierenden Tunnel verbunden zu bleiben.
-o ServerAliveInterval=15 -o ServerAliveCountMax=3Sendet alle 15 Sekunden ein Keep-Alive und beendet die Verbindung nach drei unbeantworteten, sodass eine tote Verbindung nach etwa 45 Sekunden bemerkt wird.
-o ConnectTimeout=15Gibt nach 15 Sekunden auf, wenn der Server nicht erreichbar ist.
-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/nullÜberspringt die Host-Key-Abfrage und trägt den Server nicht in Ihre Datei known_hosts ein.
-o LogLevel=ERRORBlendet Informationsmeldungen von ssh aus. Fehler werden weiterhin angezeigt.

Da <LOCAL_IP> auf dem Rechner aufgelöst wird, auf dem Sie ssh ausführen, muss der Dienst nicht auf diesem Rechner laufen. Mit einer lokalen Adresse wie 192.168.1.20 leitet der Befehl an ein anderes Gerät im selben Netzwerk weiter.

Geben Sie den Befehl nicht weiter. Wer ihn ausführt, solange er gültig ist, beantwortet den Datenverkehr Ihres Tunnels.

Automatische Wiederverbindung #

Ist Automatisch wiederverbinden eingeschaltet, bettet das Dashboard denselben ssh-Befehl in ein kleines Skript für die gewählte Shell ein. Für Eingabeaufforderung wird das Skript als einzelne Zeile powershell -NoProfile -EncodedCommand … geliefert. Das Skript verhält sich in jeder Shell gleich:

  • Wenn ssh endet, wartet es und startet es erneut. Die Wartezeit beginnt bei etwa 10 Sekunden und verdoppelt sich nach jedem fehlgeschlagenen Versuch bis auf etwa 2 Minuten.
  • Eine Verbindung, die mindestens 60 Sekunden bestand, gilt als Erfolg und setzt die Wartezeit zurück.
  • Nach 8 aufeinanderfolgenden Versuchen, die jeweils nach weniger als 60 Sekunden endeten, bricht es ab und gibt SSH reconnect stopped. If a session or bandwidth limit was reached, get a new SSH command from the panel. aus.

Die Wiederverbindung verwendet denselben Befehl. Das funktioniert nach einer Netzwerkunterbrechung, aber nicht, wenn der Tunnel im Dashboard gestoppt wurde oder ein Limit erreicht hat; in diesem Fall gibt das Skript auf, und Sie brauchen einen neuen Befehl.

Wie lange ein Befehl gültig bleibt #

  • Vor der ersten Verwendung: Der Befehl muss innerhalb der Zeit ausgeführt werden, die das Dashboard bei der Ausstellung anzeigt. Danach verfällt das Portangebot.
  • Während der Verwendung: eine SSH-Sitzung pro Tunnel. Eine zweite Kopie des Befehls wird abgelehnt, solange die erste verbunden ist.
  • Nach dem Ende der Verbindung: Derselbe Befehl kann sich erneut verbinden, solange der Tunnel im Dashboard nicht gestoppt wurde und kein Limit erreicht ist.
  • Nach einem Stopp: Wurde der Tunnel im Dashboard oder durch ein Limit gestoppt, ist der Befehl verbraucht. Öffnen Sie SSH-Befehl anzeigen erneut, um einen neuen zu erhalten.

Das Dashboard stellt nur dann einen Befehl aus, wenn der Tunnel gestoppt ist. Ein neuer Befehl kann einen anderen Serverport mitbringen; im Kostenlosen Plan erhält jeder neue Befehl einen neuen. Bei einem TCP-Tunnel ist dieser Port Teil der öffentlichen Adresse. Prüfen Sie deshalb nach dem Anfordern eines neuen Befehls die Adresse in der Terminalausgabe oder in der Tunnelliste. Das Aktivitätsprotokoll des Tunnels verzeichnet die Änderung als Server port changed to "…" for SSH.

Limits #

  • Sitzungslimit im Kostenlosen Plan. Ein über SSH gestarteter Tunnel unterliegt derselben Regel wie einer, der mit dem Client gestartet wurde: Im kostenlosen Plan werden TCP-Tunnel nach 30 Minuten gestoppt und können erneut gestartet werden, HTTP-Tunnel haben keine Zeitbegrenzung. Die 30 Minuten zählen ab dem ersten Verbindungsaufbau eines Befehls; ein erneutes Verbinden mit demselben Befehl startet sie nicht neu. Erreicht eine TCP-Sitzung das Limit, schließt der Server die SSH-Verbindung mit der Meldung Session time limit reached. Get a new SSH command from the panel. Siehe Pläne und Guthaben.
  • Bandbreite. Der Datenverkehr wird wie bei jedem anderen Tunnel auf Ihre Bandbreite angerechnet. Ohne verbleibende Bandbreite wird kein Befehl ausgestellt, und der Server schließt eine laufende Sitzung mit der Meldung Bandwidth limit reached. Get a new command after bandwidth is available.
  • Nur Reverse-Weiterleitung. Der SSH-Endpunkt akzeptiert nur die eine Weiterleitung aus dem Befehl. Er gibt Ihnen weder eine Shell auf einem Localtonet-Server noch eine andere Art der Weiterleitung.
  • Ein Tunnel pro Befehl. Um mehrere Tunnel zu betreiben, fordern Sie für jeden einen Befehl an und führen Sie jeden in einem eigenen Terminal aus.

Was Sie im Dashboard sehen #

Solange der Befehl verbunden ist, wird der Tunnel als gestartet angezeigt, und Anfragen erscheinen wie gewohnt in seinen Protokollen. Das Aktivitätsprotokoll des Tunnels verzeichnet Tunnel started over SSH., wenn sich ein Befehl verbindet. Siehe Protokolle und Inspektion.

Fehlerbehebung #

Meldungen im Dashboard #

MeldungWas zu tun ist
Stoppen Sie den Tunnel, bevor Sie einen SSH-Befehl anfordern.Der Tunnel läuft mit dem Localtonet-Client. Stoppen Sie ihn und wählen Sie dann erneut SSH-Befehl anzeigen.
Stoppen Sie den aktuellen SSH-Tunnel, bevor Sie einen neuen Befehl anfordern.Der Tunnel ist weiterhin über SSH gestartet, oder eine SSH-Sitzung von ihm war vor einem Moment noch aktiv. Beenden Sie den laufenden ssh-Befehl, wählen Sie für den Tunnel Stoppen und versuchen Sie es erneut.
Ein Client ist mit dem von Ihnen erstellten AuthToken mit diesem Tunnel verbunden. Erstellen Sie einen neuen AuthToken.Ein Localtonet-Client ist mit dem Token des Tunnels angemeldet. Stoppen Sie diesen Client, oder erstellen Sie unter Meine Tokens ein weiteres Token und verwenden Sie es für diesen Tunnel.
Sie haben nicht genügend verbleibende Bandbreite, um den Tunnel zu starten.Ihre Bandbreite ist aufgebraucht. Siehe Pläne und Guthaben.
Diese Funktion ist für diesen Protokolltyp nicht verfügbar.Der Tunnel ist kein HTTP- oder TCP-Tunnel.
Diese Funktion ist auf diesem Server nicht verfügbar. Verschieben Sie Ihren Tunnel auf einen anderen Server.Der Server dieses Tunnels bietet keine SSH-Befehle an. Erstellen Sie den Tunnel auf einem anderen Server.
Ein Tunnelvorgang läuft gerade. Bitte versuchen Sie es in Kürze erneut.Warten Sie einige Sekunden und versuchen Sie es erneut.
Es konnte kein neuer Server-Port zugewiesen werden.Versuchen Sie es erneut. Wenn der Fehler bestehen bleibt, erstellen Sie den Tunnel auf einem anderen Server.
Der SSH-Port konnte nicht gespeichert werden. Bitte versuchen Sie es erneut.Versuchen Sie es erneut.

Meldungen im Terminal #

Wenn der Server eine Sitzung schließt, sendet er als Grund eine der folgenden Meldungen. Wie der Grund angezeigt wird, hängt von Ihrem ssh-Client ab.

Meldung oder SymptomUrsache und Lösung
ssh endet sofort mit einem Authentifizierungsfehler, typischerweise Permission deniedLocaltonet hat den Befehl nicht akzeptiert. Er wurde nicht rechtzeitig ausgeführt, der Tunnel wurde seit der Ausstellung gestoppt oder hat ein Limit erreicht, eine andere Sitzung desselben Befehls ist bereits verbunden, oder der Text wurde beim Kopieren verändert. Holen Sie sich im Dashboard einen neuen Befehl und fügen Sie ihn unverändert ein.
Port mismatch. Get a new SSH command from the panel.Der Serverport nach -R ist nicht der, den Localtonet vergeben hat. Verwenden Sie den Befehl genau so, wie er ausgestellt wurde.
Session time limit reached. Get a new SSH command from the panel.Die 30-minütige Sitzung eines TCP-Tunnels im Kostenlosen Plan ist abgelaufen. Fordern Sie einen neuen Befehl an, um erneut zu starten.
Bandwidth limit reached. Get a new command after bandwidth is available.Ihre Bandbreite ist aufgebraucht.
Session stopped. Get a new SSH command from the panel.Der Tunnel wurde gestoppt, zum Beispiel über das Dashboard.
Eine Zeitüberschreitung oder Connection refusedDer Rechner kann den Server auf Port 223 nicht erreichen. Erlauben Sie ausgehende TCP-Verbindungen zu Port 223 in der Firewall oder versuchen Sie es aus einem anderen Netzwerk.
Der Tunnel ist aktiv, aber Besucher erhalten einen Fehlerssh ist verbunden, erreicht aber Ihren Dienst nicht. Prüfen Sie, ob der Dienst läuft und ob Lokale IP-Adresse und Lokaler Port des Tunnels stimmen. Fordern Sie nach einer Änderung einen neuen Befehl an, da der alte noch die alten Werte enthält.

Brauchen Sie Hilfe zu dieser Seite? Fragen Sie die Community oder eröffnen Sie ein Support-Ticket.

Support