HTTP-Tunnel erstellen
Auf dieser Seite 10 Abschnitte
- Bevor Sie beginnen
- Schritte
- Die HTTP-Seite öffnen
- Den URL-Typ wählen
- Das Gerät und die Region wählen
- Die lokale Adresse eingeben
- Den Tunnel starten
- Ihre öffentliche Adresse
- HTTPS und Zertifikate
- Der Host-Header
- Einstellungen eines HTTP-Tunnels
- Beispiele
- Eine Web-App freigeben
- Webhooks empfangen
- Die Warnseite im Kostenlosen Plan
- Fehlerbehebung
- Verwandte Seiten
Ein HTTP-Tunnel gibt einer Web-App, einer API oder einem Webhook-Empfänger auf Ihrem Gerät eine öffentliche HTTPS-Adresse. Localtonet stellt das Zertifikat bereit, sodass Ihr lokaler Dienst weiterhin einfaches HTTP verwenden kann.
Bevor Sie beginnen #
- Der Localtonet-Client ist auf dem Gerät installiert und mit einem AuthToken verbunden. Falls nicht, folgen Sie dem Schnellstart.
- Ihr Webdienst läuft und Sie kennen seinen Port, zum Beispiel
3000. - Für Eigene Subdomain oder Eigene Domain: Guthaben auf Ihrem Konto. Für Eigene Domain außerdem eine Domain, die Sie im DNS-Manager hinzugefügt haben. Siehe Eigene Domains.
Schritte #
-
Die HTTP-Seite öffnen #
Öffnen Sie Meine Tunnel › HTTP und wählen Sie HTTP-Tunnel erstellen, um das Formular zu öffnen.
-
Den URL-Typ wählen #
URL-Typ Ihre Adresse Voraussetzung Zufällige Subdomain Ein generierter Name auf der ausgewählten Domain, zum Beispiel https://<RANDOM_NAME>.localto.net.Nichts weiter Eigene Subdomain Der Name, den Sie unter Subdomain eingeben, zum Beispiel https://myapp.localto.net. Erlaubt sind Buchstaben, Ziffern und Bindestriche.Guthaben Eigene Domain Eine eigene Domain, die Sie unter Domain auswählen. Guthaben und eine Domain im DNS-Manager -
Das Gerät und die Region wählen #
Wählen Sie unter Geräte-Token das Token aus, das die Localtonet-App auf Ihrem Gerät verwendet. Wählen Sie unter Serverregion eine Region in der Nähe Ihres Geräts, um die Latenz gering zu halten.
-
Die lokale Adresse eingeben #
Feld Was Sie eingeben Domain localto.netoder eine Ihrer eigenen Domains. Bei Eigene Domain enthält die Liste nur Ihre eigenen Domains.Subdomain Nur für Eigene Subdomain: der Name vor der Domain. Lokale IP-Adresse Adresse des Dienstes auf Ihrem Gerät. Verwenden Sie 127.0.0.1für dieses Gerät. Das Formular akzeptiert eine IPv4- oder IPv6-Adresse oderlocalhost.Lokaler Port Der Port, auf dem Ihr lokaler Dienst lauscht, von 1 bis 65535. Wählen Sie Tunnel erstellen. Der Tunnel erscheint unter Ihre Tunnel als
Tunnel #gefolgt von seiner ID. -
Den Tunnel starten #
Wählen Sie die Start-Schaltfläche in der Spalte Aktionen. Läuft der Tunnel, wird seine Adresse in der Spalte URL zu einem Link. Öffnen Sie ihn in einem Browser. Anfragen an diese Adresse erreichen nun den Dienst auf Ihrem Gerät.
Ist die Localtonet-App dieses Tokens offline, weist Sie ein Dialog darauf hin. Starten Sie die App oder wählen Sie Trotzdem starten; der Tunnel geht dann online, sobald die App sich verbindet.
Ihre öffentliche Adresse #
- Die Adresse lautet
https://gefolgt vom Hostnamen aus der Spalte URL. - Ein HTTP-Tunnel behält seine Subdomain, bis Sie den Tunnel löschen. Stoppen und Starten ändert sie nicht.
- Die Adresse enthält keine Portnummer. Besucher öffnen sie wie jede andere Website.
- WebSocket-Verbindungen laufen durch einen HTTP-Tunnel.
HTTPS und Zertifikate #
Besucher erreichen einen HTTP-Tunnel über HTTPS mit einem Zertifikat, das Localtonet bereitstellt und erneuert. TLS endet am Localtonet-Server. Von dort wandert die Anfrage durch den Tunnel zu Ihrem Gerät, und die Localtonet-App reicht sie an Ihren Dienst weiter.
| Einstellung | Funktion | Wann Sie ihn einsetzen |
|---|---|---|
| Nur HTTPS? | Liefert die öffentliche URL nur über HTTPS aus. Eine Anfrage an http:// wird auf dieselbe Adresse unter https:// umgeleitet. Solange die Einstellung aus ist, antwortet die Adresse auf beides. | Schalten Sie sie für alles ein, was Anmeldungen oder private Daten überträgt. |
| HTTP/3 aktiv? | Erlaubt Clients, die öffentliche URL über HTTP/3 zu erreichen. Bei einem neuen Tunnel ist sie eingeschaltet. | Schalten Sie sie nur aus, wenn ein Client Probleme mit HTTP/3 hat. |
| SslStream aktiv? | Weist die Localtonet-App an, sich per TLS mit Ihrem lokalen Dienst zu verbinden. Die App akzeptiert das Zertifikat des lokalen Dienstes unverändert, daher funktioniert auch ein selbstsigniertes Zertifikat. | Schalten Sie sie ein, wenn Ihr lokaler Dienst selbst HTTPS verwendet, zum Beispiel ein Entwicklungsserver unter https://localhost:5001. |
| Legacy-Verbindung? | Verbindet den Tunnel mit der älteren Methode statt mit der normalen. | Probieren Sie dies, wenn sich der Tunnel mit der normalen Methode nicht verbinden lässt. |
Diese Schalter finden Sie unter Einstellungen im Bereich Tunneleinstellungen. Wenn Sie SslStream aktiv? oder Legacy-Verbindung? bei einem laufenden Tunnel ändern, wird er neu gestartet; die Localtonet-App muss daher verbunden sein.
Verschlüsselung bis zu Ihrem eigenen Dienst nötig? Bei einem HTTP-Tunnel entschlüsselt Localtonet den Datenverkehr auf seinem Server. Verwenden Sie einen TLS-Tunnel, wenn Ihr Dienst sein eigenes Zertifikat vorweisen muss.
Der Host-Header #
Ihr Dienst erhält den Hostnamen, den der Besucher verwendet hat, also die Tunneladresse. Manche lokalen Webserver wählen die Website anhand des Hostnamens und antworten mit der falschen Website oder einem Fehler. Öffnen Sie in diesem Fall Header in den Tunneleinstellungen und fügen Sie einen Request-Header namens Host mit dem Namen hinzu, den Ihr Server erwartet. Ihr Dienst erhält dann diesen Hostnamen statt der Tunneladresse. Siehe Header und Rewrites und Virtual Hosts.
Einstellungen eines HTTP-Tunnels #
Wählen Sie die Einstellungen-Schaltfläche in der Spalte Aktionen, um den Bereich Tunneleinstellungen zu öffnen. Unter Tunneldetails können Sie den Tunnel umbenennen sowie die lokale IP-Adresse und den lokalen Port ändern. Die Tabelle zeigt, was ein HTTP-Tunnel sonst noch bietet und wo es erklärt wird.
| Einstellung | Funktion | Mehr erfahren |
|---|---|---|
| Load Balancing | Verteilen Sie den Datenverkehr auf mehrere Geräte oder nutzen Sie ein Backup-Ziel. | Lastverteilung |
| SSH-Befehl anzeigen | Starten Sie diesen Tunnel mit reinem SSH, ohne die Localtonet-App zu installieren. | SSH ohne Installation |
| Nur HTTPS?, HTTP/3 aktiv?, SslStream aktiv?, Legacy-Verbindung? | Wie sich Besucher und Ihr Dienst verbinden. | Diese Seite, weiter oben |
| Pfad umschreiben? | Ändern Sie den Anfragepfad, bevor er Ihren lokalen Dienst erreicht. | Header und Umschreibungen |
| Header | Verwalten Sie eigene HTTP-Request- und Response-Header für diesen Tunnel. | Header und Umschreibungen |
| HTTP-Timeout | Legen Sie fest, wie lange der Server auf eine Antwort Ihrer lokalen Anwendung wartet, von 1 bis 600 Sekunden. | Header und Umschreibungen |
| Basic Auth? | Fragt Besucher nach Benutzername und Passwort. | Zugriffskontrolle |
| IP-Beschränkung | Festlegen, welche Client-IP-Adressen auf diesen Tunnel zugreifen dürfen. | Zugriffskontrolle |
| SSO-Anbieter | Besucher melden sich bei einem Ihrer Identitätsanbieter an, bevor sie den Tunnel öffnen können. Die Schaltfläche SSO oben auf der Seite verwaltet die Anbieter. | Single Sign-On |
| WAF-Schaltfläche in der Spalte Aktionen | Öffnet WAF-Einstellung. Die Schaltfläche zeigt, ob die Web Application Firewall nicht konfiguriert, aktiv oder inaktiv ist. | Web Application Firewall |
| Ablaufdatum, Geschwindigkeitslimits, Bandbreitenlimit, Bandbreitennutzung, Bandbreitenverkehr | Den Tunnel zu einem Datum stoppen, seine Geschwindigkeit begrenzen, sein Datenvolumen begrenzen, den Datenzähler zurücksetzen und den Verkehr im Zeitverlauf ansehen. | Limits und Ablauf |
| Anfrageprotokoll, Aktivitätsprotokoll, Tunnelzustand | Anfragen untersuchen, Starts, Stopps und Einstellungsänderungen nachvollziehen und die Zustandsprüfungen einsehen. | Protokolle und Inspektion |
| Argumente | Leiten Sie diesen Tunnel über ein bestimmtes Netzwerk Ihres Geräts. | Netzwerkauswahl |
| Ausgehender Port | Verwenden Sie feste ausgehende Ports für die Serververbindung der Localtonet-App, etwa bei strengen Firewalls. | Ports |
| Tunnelnotiz | Speichern Sie eine private Notiz, die Ihnen hilft, diesen Tunnel zu erkennen. | Einstellungsreferenz |
SSO-Anbieter wird bei einem Tunnel, der zu einem Team gehört, nicht angezeigt.
Beispiele #
Eine Web-App freigeben #
Ihre App läuft auf demselben Computer wie der Localtonet-Client und lauscht auf Port 3000.
| Feld | Wert |
|---|---|
| URL-Typ | Zufällige Subdomain |
| Domain | localto.net |
| Lokale IP-Adresse | 127.0.0.1 |
| Lokaler Port | 3000 |
Erstellen und starten Sie den Tunnel und senden Sie die Adresse aus der Spalte URL an die Personen, die die App sehen sollen. Um zuvor ein Passwort abzufragen, schalten Sie Basic Auth? ein.
Läuft die App auf einem anderen Rechner in Ihrem Netzwerk, geben Sie die Adresse dieses Rechners unter Lokale IP-Adresse ein, zum Beispiel 192.168.1.20. Das Gerät, auf dem der Localtonet-Client läuft, muss ihn erreichen können.
Webhooks empfangen #
Ein Webhook-Anbieter benötigt eine öffentliche HTTPS-Adresse, an die er Ereignisse sendet. Erstellen Sie einen HTTP-Tunnel zum Port Ihres Empfängers, starten Sie ihn und tragen Sie beim Anbieter die Tunneladresse plus den Pfad Ihres Endpunkts ein:
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>Testen Sie es von einem beliebigen Computer aus:
curl -X POST https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH> \
-H "Content-Type: application/json" \
-d '{"event":"test"}'Um zu sehen, was angekommen ist, wählen Sie das Symbol in der Spalte Webhooks des Tunnels (Request- & Response-Protokolle anzeigen). Der Tunnel muss zuvor gestartet sein. Siehe Protokolle und Inspektion.
Fügen Sie im Kostenlosen Plan Guthaben hinzu, bevor Sie sich auf Webhooks verlassen. Anfragen an einen HTTP-Tunnel eines kostenlosen Kontos erhalten zuerst eine Warnseite, die ein Webhook-Anbieter nicht bestätigen kann. Siehe den nächsten Abschnitt.
Die Warnseite im Kostenlosen Plan #
Hat ein Konto kein Guthaben, sieht ein Erstbesucher seines HTTP-Tunnels eine Localtonet-Seite mit dem Titel „You are about to navigate to:“ und den Schaltflächen Cancel und Visit Site. Die Seite soll Missbrauch abschrecken. Visit Site speichert ein Cookie im Browser des Besuchers und öffnet Ihre Website. Solange der Browser dieses Cookie behält, wird er nicht erneut gefragt.
Die Seite selbst nennt die beiden Möglichkeiten, sie zu entfernen:
- Senden Sie einen Request-Header namens
localtonet-skip-warningmit einem beliebigen Wert. Das eignet sich für Ihre eigenen Skripte und API-Clients. - Fügen Sie Ihrem Konto Guthaben hinzu. Siehe Pläne und Guthaben.
curl -H "localtonet-skip-warning: 1" https://<YOUR_SUBDOMAIN>.localto.net/Fehlerbehebung #
Der Dialog meldet, das Token sei offline, oder ich erhalte „Die Localtonet-App für den AuthToken … ist nicht verbunden.“
Der Localtonet-Client, der das Token dieses Tunnels verwendet, läuft nicht oder erreicht Localtonet nicht. Starten Sie den Client auf dem Gerät mit demselben Token. Der Dialog startet den Tunnel automatisch, sobald die App sich verbindet. Mit Trotzdem starten wird der Tunnel eingeschaltet und geht später online.
„Starten oder aktualisieren Sie die Localtonet-App.“
Der Tunnel konnte auf dem Gerät nicht gestartet werden. Stellen Sie sicher, dass der Client läuft, und installieren Sie über die Seite Downloads die aktuelle Version, falls Ihre veraltet ist.
Der Browser zeigt „Tunnel Recently Started or Stopped“
Die Anfrage hat Localtonet erreicht, aber der Tunnel nimmt keine Verbindungen an. Der Tunnel wurde gerade erst gestartet oder ist gestoppt. Prüfen Sie, ob er gestartet ist und die Spalte Verbindung den Wert AN zeigt, und laden Sie die Seite dann neu.
Der Browser zeigt eine Localtonet-Fehlerseite, die meine lokale Adresse nennt
Die Seite besagt, dass Datenverkehr zum Localtonet-Agent getunnelt wurde, der Agent sich aber nicht mit dem Upstream-Dienst unter Ihrer lokalen IP und Ihrem lokalen Port verbinden konnte. Die Überschrift ist der Fehler, zum Beispiel ConnectionRefused. An dieser Adresse lauscht nichts. Starten Sie Ihren Dienst und prüfen Sie dann die lokale IP-Adresse und den lokalen Port unter Tunneldetails. Sie können den Dienst auf dem Gerät selbst testen, indem Sie die lokale Adresse in einem Browser öffnen.
„Sie müssen Guthaben kaufen, um diese Funktion zu nutzen.“
Eigene Subdomain und Eigene Domain benötigen Guthaben. Verwenden Sie Zufällige Subdomain oder fügen Sie unter Guthaben Guthaben hinzu.
„Für einen weiteren Tunnel dieses Typs benötigen Sie insgesamt … Guthaben.“
Ihr Guthaben reicht für keinen weiteren Tunnel. Im Kostenlosen Plan können Sie insgesamt nur einen Tunnel erstellen, unabhängig von seinem Typ. Löschen Sie Ihren vorhandenen Tunnel, bevor Sie einen weiteren erstellen, oder fügen Sie Guthaben hinzu.
„… existiert bereits.“ oder „… ist nicht erlaubt.“
Ein anderer Tunnel verwendet diese Subdomain, oder der Name ist von Localtonet reserviert. Wählen Sie eine andere Subdomain.
„WARNUNG! Sie haben keine Domain!“
Sie haben Eigene Domain gewählt, aber noch keine Domain hinzugefügt. Fügen Sie sie zuerst im DNS-Manager hinzu. Wenn Sie „… wird bereits von einem anderen Tunnel verwendet.“ sehen, gehört diese Domain bereits zu einem Ihrer Tunnel. Eine eigene Domain kann nur einen Tunnel bedienen.
„Aktualisieren Sie das Bandbreitenlimit oder setzen Sie die Bandbreitennutzung zurück.“ oder „Aktualisieren Sie das Ablaufdatum.“
Der Tunnel hat sein eigenes Bandbreitenlimit oder sein Ablaufdatum erreicht und kann nicht starten. Ändern Sie das Limit oder das Datum in den Tunneleinstellungen oder setzen Sie den Zähler mit Bandbreitennutzung zurück. Siehe Limits und Ablauf.
„Prüfen Sie die Verbindung des Geräts.“
Sie haben eine Einstellung geändert, die einen laufenden Tunnel neu startet, während die Localtonet-App offline war. Verbinden Sie die App und speichern Sie die Einstellung erneut, oder stoppen Sie zuerst den Tunnel.
Meine App antwortet mit der falschen Website oder erzeugt http://-Links und Weiterleitungen
Ihre App entscheidet anhand des Hostnamens oder des Schemas, das sie erhält. Fügen Sie unter Header einen Request-Header Host hinzu, wenn die App einen festen Hostnamen erwartet. Fügen Sie einen Request-Header X-Forwarded-Proto mit dem Wert https hinzu, damit die App weiß, dass Besucher HTTPS verwenden und https://-Links und -Weiterleitungen erzeugt.