Referenz der Tunneleinstellungen
Auf dieser Seite 15 Abschnitte
- Die Einstellungen eines Tunnels öffnen
- Die Seite des Tunneltyps öffnen
- Einstellungen in der Tunnelzeile auswählen
- Eine Einstellung ändern
- Wie Änderungen angewendet werden
- Welcher Tunneltyp hat welche Einstellung
- Was jede Einstellung bewirkt
- Tunneldetails
- Tunnelnotiz
- SslStream aktiv?
- PROXY-Protokoll?
- Legacy-Verbindung?
- Lokale Server-IP
- Tunnel-IP
- Einstellungen in der Tunnelliste
- Den Server wechseln
- Den AuthToken ändern
- Web Application Firewall
- Dieselben Einstellungen über die API
- Fehlerbehebung
- 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 #
-
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.
-
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.
-
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 angewendet | Startet 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.
| Einstellung | HTTP | TCP - UDP | TLS | Dateiserver | Proxy-Server | Rotierender Proxy | MCP-Gateway |
|---|---|---|---|---|---|---|---|
| Nur HTTPS? | Ja | – | – | – | – | – | Ja |
| Pfad umschreiben? | Ja | – | – | – | – | – | – |
| Basic Auth? | Ja | – | – | Ja, Typ Default | – | – | Ja |
| SslStream aktiv? | Ja | Ja, nicht für UDP | Ja | – | – | – | – |
| HTTP/3 aktiv? | Ja | – | – | – | – | – | Ja |
| Reserviert? | – | Ja | – | – | Ja | Ja | – |
| PROXY-Protokoll? | – | Ja, nicht für UDP | – | – | – | – | – |
| Legacy-Verbindung? | Ja | Ja | Ja | Ja | Ja | – | Ja |
| SSL-Modus | – | – | Ja | – | – | – | – |
| SSO-Anbieter | Ja, nicht bei Team-Tunneln | – | – | – | – | – | – |
| Gateway-Token | – | – | – | – | – | – | Ja |
| Header | Ja | – | – | – | – | – | – |
| HTTP-Timeout | Ja | – | – | – | – | – | Ja |
| Server-Port | – | Ja | – | – | Ja, nicht für VLESS | Ja | – |
| Tunnelnotiz | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| Lokale Server-IP | Nur lokaler Server | Nur lokaler Server | Nur lokaler Server | – | Nur lokaler Server | – | Nur lokaler Server |
| Argumente | Ja | Ja | Ja | – | Ja | – | – |
| IP-Beschränkung | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| Ablaufdatum | Ja | Ja | Ja | Ja | Ja | – | Ja |
| Geschwindigkeitslimits | Ja | Ja | Ja | Ja | Ja | – | Ja |
| Ausgehender Port | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| Bandbreitenlimit | Ja | Ja | Ja | Ja | Ja | – | Ja |
| Bandbreitenverkehr | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| Bandbreitennutzung | Ja | Ja | Ja | Ja | Ja | – | Ja |
| Tunnel-IP | – | Ja | Ja | – | Ja | Ja | – |
| Anfrageprotokoll | Ja | Ja | Ja | Ja | Ja | – | Ja |
| Aktivitätsprotokoll | Ja | Ja | Ja | Ja | Ja | Ja | Ja |
| Tunnelzustand | Ja | Ja | Ja | – | Ja | Ja | Ja |
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 #
| Einstellung | Funktion | Details |
|---|---|---|
| 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-Modus | Legt fest, ob Localtonet bei einem TLS-Tunnel HTTPS selbst verarbeitet oder den verschlüsselten Datenverkehr an Ihren Dienst durchreicht. | TLS |
| SSO-Anbieter | Verlangt von Besuchern die Anmeldung bei einem Ihrer Identitätsanbieter, bevor sie den Tunnel öffnen können. | Single Sign-On |
| Gateway-Token | Zeigt das Token, das Ihre MCP-Clients senden, um sich mit dem Gateway zu verbinden. | MCP-Gateway |
| Header | Fügt feste Anfrage- und Antwort-Header hinzu. | Header und Umschreibungen |
| HTTP-Timeout | Legt 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 |
| Tunnelnotiz | Eine private Erinnerung daran, wofür der Tunnel gedacht ist. | Diese Seite |
| Lokale Server-IP | Die Adressen, unter denen Ihr lokaler Server erreichbar ist. | Diese Seite |
| Argumente | Leitet den Tunnel über ein bestimmtes Netzwerk des Geräts. | Netzwerkauswahl |
| IP-Beschränkung | Legt fest, welche IP-Adressen sich mit dem Tunnel verbinden dürfen. | Zugriffskontrolle |
| Ablaufdatum | Stoppt den Tunnel an einem festgelegten Datum. | Limits und Ablauf |
| Geschwindigkeitslimits | Begrenzt die Upload- und Download-Geschwindigkeit. | Limits und Ablauf |
| Ausgehender Port | Hält die Ports fest, zu denen sich die Localtonet-App nach außen verbindet, für strenge Firewalls. | Ports |
| Bandbreitenlimit | Stoppt den Tunnel, nachdem er eine festgelegte Datenmenge übertragen hat. | Limits und Ablauf |
| Bandbreitenverkehr | Stellt die Daten, die durch den Tunnel gelaufen sind, als Diagramm dar. | Limits und Ablauf |
| Bandbreitennutzung | Setzt den Datenzähler des Tunnels auf null zurück. | Limits und Ablauf |
| Tunnel-IP | Zeigt die IP-Adressen des Servers, auf dem der Tunnel läuft. | Diese Seite |
| Anfrageprotokoll | Zeigt die für den Tunnel aufgezeichneten Anfragen oder Verbindungen. | Protokolle und Inspektion |
| Aktivitätsprotokoll | Listet Starts, Stopps und Einstellungsänderungen auf. | Protokolle und Inspektion |
| Tunnelzustand | Zeigt 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.
| Dialog | Was Sie eingeben | Regeln |
|---|---|---|
| Tunnel umbenennen | Ein 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 Adresse | Wo 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 Port | Der 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.
| Einstellung | Pfad nach /api/v2/tunnels/<TUNNEL_ID>/ |
|---|---|
| IP-Beschränkung | ip-restrictions |
| Header | headers, host-header |
| Basic-Authentifizierung | authentication |
| Ablaufdatum | expiration |
| Server-Port | server-port |
| HTTP-Timeout | http-timeout |
| Geschwindigkeitslimits | rate-limit |
| Bandbreitenlimit und Nutzung | bandwidth-limit, bandwidth-usage, bandwidth-usage/reset |
| Argumente | arguments |
| Nur HTTPS?, HTTP/3 aktiv?, Pfad umschreiben? | https-only, http3, path-rewrite |
| SslStream aktiv?, PROXY-Protokoll?, SSL-Modus | ssl-stream, proxy-protocol, pass-through |
| Tunnelnotiz | note |
| Server | server |
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?.