Zum Inhalt springen
Localtonet Localtonet Dashboard

Referenz der Tunneleinstellungen

Hilfe zu dieser Seite
Auf dieser Seite 15 Abschnitte
  1. Die Einstellungen eines Tunnels öffnen
  2. Die Seite des Tunneltyps öffnen
  3. Einstellungen in der Tunnelzeile auswählen
  4. Eine Einstellung ändern
  5. Wie Änderungen angewendet werden
  6. Welcher Tunneltyp hat welche Einstellung
  7. Was jede Einstellung bewirkt
  8. Tunneldetails
  9. Tunnelnotiz
  10. SslStream aktiv?
  11. PROXY-Protokoll?
  12. Legacy-Verbindung?
  13. Lokale Server-IP
  14. Tunnel-IP
  15. Einstellungen in der Tunnelliste
  16. Den Server wechseln
  17. Den AuthToken ändern
  18. Web Application Firewall
  19. Dieselben Einstellungen über die API
  20. Fehlerbehebung
  21. Verwandte Seiten

Jeder Tunnel hat im Dashboard ein Einstellungsfenster. Diese Seite zeigt, wo Sie es öffnen, listet jede Einstellung auf, nennt die Tunneltypen, die sie bieten, und verweist auf die Seite, die sie ausführlich erklärt.

Die Einstellungen eines Tunnels öffnen #

  1. Die Seite des Tunneltyps öffnen #

    Öffnen Sie im Dashboard-Menü Meine Tunnel und wählen Sie den Typ: Meine Tunnel › HTTP, TCP - UDP, TLS, Dateiserver, Proxy-Server, Rotierender Proxy oder MCP-Gateway.

  2. Einstellungen in der Tunnelzeile auswählen #

    Suchen Sie den Tunnel unter Ihre Tunnel und wählen Sie in der Spalte Aktionen die Option Einstellungen. Das Fenster Tunneleinstellungen öffnet sich am Seitenrand.

  3. Eine Einstellung ändern #

    Das Fenster besteht aus diesen Teilen:

    • Tunneldetails: Angaben wie die Adresse des Tunnels, das Erstellungsdatum und der Name des AuthToken sowie die Werte, die Sie durch Anklicken bearbeiten können: der Titel bei jedem Tunneltyp, bei HTTP-, TCP - UDP- und TLS-Tunneln zusätzlich die lokale Adresse und der lokale Port.
    • Die Ziele der Lastverteilung des Tunnels, bei den Tunneltypen, die sie unterstützen. Siehe Lastverteilung.
    • SSH-Befehl anzeigen, bei den Tunneltypen, die sich mit einfachem SSH starten lassen. Siehe SSH ohne Installation.
    • Einstellungen: eine Zeile pro Einstellung. Jede Zeile hat entweder einen Schalter Ja / Nein oder eine Schaltfläche (Verwalten, Ändern, Anzeigen oder Leeren), die ein Dialogfenster öffnet. Das Informationssymbol neben einer Bezeichnung erklärt die Einstellung in einem Satz.

    Bei den meisten Schaltern müssen Sie bestätigen, bevor sich etwas ändert, zum Beispiel Nur HTTPS einschalten? mit den Schaltflächen Einschalten und Abbrechen. Wenn Sie Basic Auth? oder Pfad umschreiben? einschalten, öffnet sich stattdessen ein Dialogfenster, und wenn Sie Reserviert? bei einem laufenden Tunnel einschalten, wird der Port ohne Rückfrage reserviert.

Wie Änderungen angewendet werden #

Einige Einstellungen werden bei einem laufenden Tunnel ohne Unterbrechung angewendet. Andere stoppen den Tunnel und starten ihn mit dem neuen Wert neu. Das dauert einen Moment und trennt die offenen Verbindungen.

Ohne Neustart angewendetStartet einen laufenden Tunnel neu
Nur HTTPS?, Pfad umschreiben?, HTTP/3 aktiv?, Reserviert?, Header, HTTP-Timeout, Tunnelnotiz, IP-Beschränkung, Ablaufdatum, Ausgehender Port, Bandbreitenlimit, Bandbreitennutzung, der WAF-Schalter Titel, lokale Adresse und lokaler Port in den Tunneldetails, Basic Auth?, SslStream aktiv?, PROXY-Protokoll?, Legacy-Verbindung?, Server-Port, Argumente, Lokale Server-IP, Geschwindigkeitslimits, Wechsel des Servers, Wechsel des AuthToken

Eine Einstellung, die den Tunnel neu startet, lässt sich bei einem laufenden Tunnel nur speichern, solange die Localtonet-App seines Geräts verbunden ist. Andernfalls antwortet das Dashboard mit „Prüfen Sie die Verbindung des Geräts.“ und behält den alten Wert. Bei einem gestoppten Tunnel wird der Wert gespeichert und beim nächsten Start verwendet.

Welcher Tunneltyp hat welche Einstellung #

Die Bezeichnungen sind die, die der Abschnitt Einstellungen anzeigt. „Ja“ bedeutet, dass der Tunneltyp die Zeile hat.

EinstellungHTTPTCP - UDPTLSDateiserverProxy-ServerRotierender ProxyMCP-Gateway
Nur HTTPS?Ja–––––Ja
Pfad umschreiben?Ja––––––
Basic Auth?Ja––Ja, Typ Default––Ja
SslStream aktiv?JaJa, nicht für UDPJa––––
HTTP/3 aktiv?Ja–––––Ja
Reserviert?–Ja––JaJa–
PROXY-Protokoll?–Ja, nicht für UDP–––––
Legacy-Verbindung?JaJaJaJaJa–Ja
SSL-Modus––Ja––––
SSO-AnbieterJa, nicht bei Team-Tunneln––––––
Gateway-Token––––––Ja
HeaderJa––––––
HTTP-TimeoutJa–––––Ja
Server-Port–Ja––Ja, nicht für VLESSJa–
TunnelnotizJaJaJaJaJaJaJa
Lokale Server-IPNur lokaler ServerNur lokaler ServerNur lokaler Server–Nur lokaler Server–Nur lokaler Server
ArgumenteJaJaJa–Ja––
IP-BeschränkungJaJaJaJaJaJaJa
AblaufdatumJaJaJaJaJa–Ja
GeschwindigkeitslimitsJaJaJaJaJa–Ja
Ausgehender PortJaJaJaJaJaJaJa
BandbreitenlimitJaJaJaJaJa–Ja
BandbreitenverkehrJaJaJaJaJaJaJa
BandbreitennutzungJaJaJaJaJa–Ja
Tunnel-IP–JaJa–JaJa–
AnfrageprotokollJaJaJaJaJa–Ja
AktivitätsprotokollJaJaJaJaJaJaJa
TunnelzustandJaJaJa–JaJaJa

Die Seiten Proxy-Server und Rotierender Proxy haben weitere eigene Zeilen, etwa Proxy-Authentifizierung, Zugriffskontrolle, Upstream-Einstellung, VPN-Zugang, Speedtest, Tunnel-Token und Nur über IPv4 verbinden?. Sie sind in Proxy-Server und Rotierender Proxy beschrieben. Ein Tunnel, der den Server Lokal verwendet, hat keine Zeile Ausgehender Port. „Nur lokaler Server“ gilt auch für einen Tunnel, dessen Spalte Server den Wert VPN zeigt.

Was jede Einstellung bewirkt #

EinstellungFunktionDetails
Nur HTTPS?Liefert die öffentliche URL ausschließlich über HTTPS aus.Header und Umschreibungen
Pfad umschreiben?Setzt jeder Anfrage einen Pfad voran, bevor sie Ihren lokalen Dienst erreicht.Header und Umschreibungen
Basic Auth?Fragt Besucher nach Benutzername und Passwort.Zugriffskontrolle
SslStream aktiv?Teilt dem Tunnel mit, dass Ihr lokaler Dienst selbst HTTPS oder TLS verwendet.Diese Seite
HTTP/3 aktiv?Erlaubt Clients, die öffentliche URL über HTTP/3 zu erreichen.Header und Umschreibungen
Reserviert?Behält beim Neustart des Tunnels denselben Server-Port bei.Ports
PROXY-Protokoll?Übergibt die ursprüngliche Client-Adresse in einem PROXY-Protokoll-Header an Ihren Dienst.Diese Seite
Legacy-Verbindung?Eine alternative Verbindungsmethode, die Sie ausprobieren können, wenn der Tunnel sich mit der normalen nicht verbinden kann.Diese Seite
SSL-ModusLegt fest, ob Localtonet bei einem TLS-Tunnel HTTPS selbst verarbeitet oder den verschlüsselten Datenverkehr an Ihren Dienst durchreicht.TLS
SSO-AnbieterVerlangt von Besuchern die Anmeldung bei einem Ihrer Identitätsanbieter, bevor sie den Tunnel öffnen können.Single Sign-On
Gateway-TokenZeigt das Token, das Ihre MCP-Clients senden, um sich mit dem Gateway zu verbinden.MCP-Gateway
HeaderFügt feste Anfrage- und Antwort-Header hinzu.Header und Umschreibungen
HTTP-TimeoutLegt fest, wie lange der Tunnel auf die Antwort Ihres Dienstes auf eine Anfrage wartet.Header und Umschreibungen
Server-PortÄndert den Port, mit dem sich Benutzer auf dem Localtonet-Server verbinden.Ports
TunnelnotizEine private Erinnerung daran, wofür der Tunnel gedacht ist.Diese Seite
Lokale Server-IPDie Adressen, unter denen Ihr lokaler Server erreichbar ist.Diese Seite
ArgumenteLeitet den Tunnel über ein bestimmtes Netzwerk des Geräts.Netzwerkauswahl
IP-BeschränkungLegt fest, welche IP-Adressen sich mit dem Tunnel verbinden dürfen.Zugriffskontrolle
AblaufdatumStoppt den Tunnel an einem festgelegten Datum.Limits und Ablauf
GeschwindigkeitslimitsBegrenzt die Upload- und Download-Geschwindigkeit.Limits und Ablauf
Ausgehender PortHält die Ports fest, zu denen sich die Localtonet-App nach außen verbindet, für strenge Firewalls.Ports
BandbreitenlimitStoppt den Tunnel, nachdem er eine festgelegte Datenmenge übertragen hat.Limits und Ablauf
BandbreitenverkehrStellt die Daten, die durch den Tunnel gelaufen sind, als Diagramm dar.Limits und Ablauf
BandbreitennutzungSetzt den Datenzähler des Tunnels auf null zurück.Limits und Ablauf
Tunnel-IPZeigt die IP-Adressen des Servers, auf dem der Tunnel läuft.Diese Seite
AnfrageprotokollZeigt die für den Tunnel aufgezeichneten Anfragen oder Verbindungen.Protokolle und Inspektion
AktivitätsprotokollListet Starts, Stopps und Einstellungsänderungen auf.Protokolle und Inspektion
TunnelzustandZeigt die Ergebnisse der regelmäßigen Zustandsprüfungen.Protokolle und Inspektion

Tunneldetails #

Wählen Sie einen Wert in den Tunneldetails aus, um ihn zu bearbeiten. Das Speichern eines der drei Werte startet einen laufenden Tunnel neu. Die lokale Adresse und der lokale Port lassen sich hier bei HTTP-, TCP - UDP- und TLS-Tunneln bearbeiten; die übrigen Tunneltypen zeigen nur den Titel.

DialogWas Sie eingebenRegeln
Tunnel umbenennenEin Name, den Sie in Ihrer Tunnelliste wiedererkennen, zum Beispiel „Büro-NAS“.Pflichtfeld. Bis zu 30 Zeichen: Der Dialog zählt bis 100, ein Titel mit mehr als 30 Zeichen wird aber mit „Der Titel darf 30 Zeichen nicht überschreiten.“ abgelehnt.
Lokale AdresseWo die Localtonet-App Ihren Dienst findet. Verwenden Sie 127.0.0.1, wenn der Dienst auf demselben Gerät wie die App läuft. Um ein anderes Gerät in Ihrem Netzwerk zu erreichen, geben Sie dessen Adresse ein, zum Beispiel 192.168.1.20.Eine IPv4-Adresse, eine IPv6-Adresse oder ein Hostname. Kein http://, kein Pfad, kein Port.
Lokaler PortDer Port, auf dem Ihr Dienst auf dem Gerät lauscht, das ihn ausführt.Eine Zahl von 1 bis 65535.

Tunnelnotiz #

Tunnelnotiz › Verwalten öffnet den Dialog Notiz. Eine Notiz ist eine Erinnerung daran, wofür der Tunnel gedacht ist, und nur Ihr Konto sieht sie.

  • Eine Notiz kann bis zu 499 Zeichen lang sein. Der Dialog zählt sie beim Tippen mit.
  • Die Auswahl unter Label setzt der Notiz ein Label voran: Produktion, Staging, Test, Demo oder Temporär. Die Notiz beginnt dann zum Beispiel mit Staging - . Wenn Sie ein anderes Label wählen, ersetzt es das vorhandene.

SslStream aktiv? #

Schalten Sie SslStream aktiv? ein, wenn Ihr lokaler Dienst selbst HTTPS oder TLS verwendet, zum Beispiel ein Entwicklungsserver, der nur auf https://localhost lauscht. Lassen Sie den Schalter aus bei einem Dienst, der einfaches HTTP oder einfaches TCP spricht. HTTP-, TCP- und TLS-Tunnel haben den Schalter; ein UDP-Tunnel nicht.

PROXY-Protokoll? #

Ist PROXY-Protokoll? eingeschaltet, übergibt der Tunnel die ursprüngliche Client-Adresse in einem PROXY-Protokoll-Header an Ihren Dienst. Schalten Sie es nur ein, wenn Ihr Dienst so eingerichtet ist, dass er diesen Header liest, denn ein Dienst, der ihn nicht erwartet, sieht am Anfang jeder Verbindung unbekannte Bytes. TCP-Tunnel haben den Schalter; ein UDP-Tunnel nicht.

Legacy-Verbindung? #

Legacy-Verbindung? stellt den Tunnel auf eine alternative Verbindungsmethode um. Probieren Sie es aus, wenn sich der Tunnel mit der normalen Methode nicht verbinden kann, und schalten Sie es wieder aus, wenn es nicht hilft.

Lokale Server-IP #

Diese Zeile erscheint nur bei Tunneln, deren Spalte Server den Wert Lokal oder VPN zeigt. Der Dialog Lokale Server-IP enthält die Adressen, unter denen Ihr lokaler Server erreichbar ist: eine IPv4-Adresse und optional eine IPv6-Adresse. Lassen Sie IPv6 leer, wenn Sie es nicht verwenden. Mindestens eine Adresse ist erforderlich. Eine Adresse, die nur auf dem Gerät selbst funktioniert, etwa 127.0.0.1, 0.0.0.0 oder ::1, wird mit „Die lokale Server-IP muss von außen erreichbar sein.“ abgelehnt.

Tunnel-IP #

Tunnel-IP › Anzeigen öffnet den Dialog Server-IP mit der IPv4-Adresse und, sofern der Server eine hat, der IPv6-Adresse des Servers, auf dem der Tunnel läuft. Clients können sich mit dieser Adresse statt mit dem Domainnamen mit dem Tunnel verbinden.

Server-IP-Adressen können sich ändern. Verwenden Sie in Apps und Skripten möglichst den Domainnamen.

Einstellungen in der Tunnelliste #

Zwei Einstellungen ändern Sie in der Tunnelliste, nicht im Einstellungsfenster.

Den Server wechseln #

Wählen Sie in der Spalte Server den Servercode aus, wählen Sie im Dialog Server wechseln einen anderen Server und dann Absenden. Ein laufender Tunnel wird auf dem neuen Server neu gestartet.

  • Für den Serverwechsel ist Guthaben nötig. Ohne Guthaben antwortet das Dashboard mit „Sie müssen Guthaben kaufen, um diese Funktion zu nutzen.“
  • Ist der Server-Port des Tunnels auf dem neuen Server bereits belegt, erhalten Sie „Der Port Ihres Tunnels (PORT) ist auf dem ausgewählten Server nicht verfügbar. Ändern Sie zuerst den Port.“ Ändern Sie den Port wie in Ports beschrieben und versuchen Sie es dann erneut.
  • Tunnel, deren Spalte Server den Wert Lokal oder VPN zeigt, lassen sich nicht verschieben.

Nach einem Serverwechsel kann die Aktualisierung des DNS bis zu 3 Stunden dauern.

Den AuthToken ändern #

Wählen Sie in der Spalte AuthToken den Tokennamen aus, um AuthToken ändern zu öffnen, wählen Sie einen anderen AuthToken und dann Absenden. Damit wird der Tunnel auf das Gerät verschoben, auf dem die Localtonet-App mit diesem Token läuft.

  • Ein laufender Tunnel wird gestoppt, wartet 2 Sekunden und startet dann mit dem ausgewählten AuthToken neu. Ein gestoppter Tunnel bleibt gestoppt.
  • Ist die App mit dem neuen Token nicht verbunden, wird das Token trotzdem geändert, und Sie erhalten „Der AuthToken wurde aktualisiert, aber der Tunnel konnte nicht neu gestartet werden. Verbinden Sie die Localtonet-App mit dem ausgewählten Token und starten Sie den Tunnel.“
  • Tunnel mit Rotierender Proxy verwenden AuthToken-Gruppen. Ändern Sie stattdessen die Gruppen.

AuthTokens werden unter AuthTokens erklärt.

Web Application Firewall #

HTTP- und MCP-Gateway-Tunnel haben außerdem in der Spalte Aktionen eine Schaltfläche mit einem Schild. Sie öffnet die Firewall des Tunnels. Siehe Web Application Firewall.

Dieselben Einstellungen über die API #

Die meisten Einstellungen lassen sich auch über die API unter dem Pfad des Tunnels lesen und ändern. Authentifizierung und die vollständige Referenz finden Sie unter API.

EinstellungPfad nach /api/v2/tunnels/<TUNNEL_ID>/
IP-Beschränkungip-restrictions
Headerheaders, host-header
Basic-Authentifizierungauthentication
Ablaufdatumexpiration
Server-Portserver-port
HTTP-Timeouthttp-timeout
Geschwindigkeitslimitsrate-limit
Bandbreitenlimit und Nutzungbandwidth-limit, bandwidth-usage, bandwidth-usage/reset
Argumentearguments
Nur HTTPS?, HTTP/3 aktiv?, Pfad umschreiben?https-only, http3, path-rewrite
SslStream aktiv?, PROXY-Protokoll?, SSL-Modusssl-stream, proxy-protocol, pass-through
Tunnelnotiznote
Serverserver

Fehlerbehebung #

„Prüfen Sie die Verbindung des Geräts.“

Die Einstellung startet den Tunnel neu, und die Localtonet-App auf dem Gerät des Tunnels ist nicht verbunden. Starten Sie die App auf dem Gerät, warten Sie, bis die Spalte Verbindung den Wert AN zeigt, und speichern Sie erneut. Sie können den Tunnel auch zuerst stoppen: Bei einem gestoppten Tunnel wird der Wert ohne Neustart gespeichert.

„Sie müssen Guthaben kaufen, um diese Funktion zu nutzen.“

Die Einstellung erfordert Guthaben auf dem Konto. Das gilt für reservierte Ports, einen eigenen Server-Port, feste ausgehende Ports, IP-Beschränkungen und den Wechsel des Servers. Siehe Pläne und Guthaben.

„Sie haben keine Berechtigung, diesen Tunnel zu aktualisieren.“

Sie arbeiten in einem Team, und Ihre Rolle umfasst nicht das Ändern von Tunneln. Bitten Sie den Teaminhaber, Ihnen diese Berechtigung zu geben. Siehe Teamverwaltung.

Eine Zeile aus der Tabelle fehlt in meinem Fenster

Das Fenster zeigt nur die Zeilen des Tunneltyps, und einige Zeilen hängen vom Tunnel selbst ab: Lokale Server-IP setzt den Server Lokal oder VPN voraus, SSO-Anbieter wird bei Team-Tunneln nicht angezeigt, und ein UDP-Tunnel hat weder SslStream aktiv? noch PROXY-Protokoll?.

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

Support