Zum Inhalt springen
Localtonet Localtonet Dashboard

HTTP-Tunnel erstellen

Hilfe zu dieser Seite
Auf dieser Seite 10 Abschnitte
  1. Bevor Sie beginnen
  2. Schritte
  3. Die HTTP-Seite öffnen
  4. Den URL-Typ wählen
  5. Das Gerät und die Region wählen
  6. Die lokale Adresse eingeben
  7. Den Tunnel starten
  8. Ihre öffentliche Adresse
  9. HTTPS und Zertifikate
  10. Der Host-Header
  11. Einstellungen eines HTTP-Tunnels
  12. Beispiele
  13. Eine Web-App freigeben
  14. Webhooks empfangen
  15. Die Warnseite im Kostenlosen Plan
  16. Fehlerbehebung
  17. 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 #

  1. Die HTTP-Seite öffnen #

    Öffnen Sie Meine Tunnel › HTTP und wählen Sie HTTP-Tunnel erstellen, um das Formular zu öffnen.

  2. Den URL-Typ wählen #

    URL-TypIhre AdresseVoraussetzung
    Zufällige SubdomainEin generierter Name auf der ausgewählten Domain, zum Beispiel https://<RANDOM_NAME>.localto.net.Nichts weiter
    Eigene SubdomainDer Name, den Sie unter Subdomain eingeben, zum Beispiel https://myapp.localto.net. Erlaubt sind Buchstaben, Ziffern und Bindestriche.Guthaben
    Eigene DomainEine eigene Domain, die Sie unter Domain auswählen.Guthaben und eine Domain im DNS-Manager
  3. 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.

  4. Die lokale Adresse eingeben #

    FeldWas Sie eingeben
    Domainlocalto.net oder eine Ihrer eigenen Domains. Bei Eigene Domain enthält die Liste nur Ihre eigenen Domains.
    SubdomainNur für Eigene Subdomain: der Name vor der Domain.
    Lokale IP-AdresseAdresse des Dienstes auf Ihrem Gerät. Verwenden Sie 127.0.0.1 für dieses Gerät. Das Formular akzeptiert eine IPv4- oder IPv6-Adresse oder localhost.
    Lokaler PortDer 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.

  5. 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.

EinstellungFunktionWann 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.

EinstellungFunktionMehr erfahren
Load BalancingVerteilen Sie den Datenverkehr auf mehrere Geräte oder nutzen Sie ein Backup-Ziel.Lastverteilung
SSH-Befehl anzeigenStarten 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
HeaderVerwalten Sie eigene HTTP-Request- und Response-Header für diesen Tunnel.Header und Umschreibungen
HTTP-TimeoutLegen 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änkungFestlegen, welche Client-IP-Adressen auf diesen Tunnel zugreifen dürfen.Zugriffskontrolle
SSO-AnbieterBesucher 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, BandbreitenverkehrDen 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, TunnelzustandAnfragen untersuchen, Starts, Stopps und Einstellungsänderungen nachvollziehen und die Zustandsprüfungen einsehen.Protokolle und Inspektion
ArgumenteLeiten Sie diesen Tunnel über ein bestimmtes Netzwerk Ihres Geräts.Netzwerkauswahl
Ausgehender PortVerwenden Sie feste ausgehende Ports für die Serververbindung der Localtonet-App, etwa bei strengen Firewalls.Ports
TunnelnotizSpeichern 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.

FeldWert
URL-TypZufällige Subdomain
Domainlocalto.net
Lokale IP-Adresse127.0.0.1
Lokaler Port3000

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:

Webhook-URL
https://<YOUR_SUBDOMAIN>.localto.net/<YOUR_WEBHOOK_PATH>

Testen Sie es von einem beliebigen Computer aus:

Terminal
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-warning mit 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.
Terminal
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.

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

Support