Zum Inhalt springen
Localtonet Localtonet Dashboard

Einen Virtual Host über Localtonet erreichen

Hilfe zu dieser Seite
Auf dieser Seite 10 Abschnitte
  1. Warum ein Virtual Host den richtigen Host-Header braucht
  2. Bevor Sie beginnen
  3. Den Tunnel erstellen
  4. Die HTTP-Seite öffnen
  5. Das Formular ausfüllen
  6. Den Tunnel starten
  7. Option 1: Den Host-Header im Tunnel festlegen
  8. Option 2: Den Namen des Tunnels zum Virtual Host hinzufügen
  9. Apache
  10. Nginx
  11. Option 3: Eine eigene Domain verwenden
  12. Mehrere Virtual Hosts
  13. Absichern
  14. Häufige Probleme
  15. Verwandte Seiten

Bringen Sie eine Website eines lokalen Apache- oder Nginx-Servers online, auch bei XAMPP-, WampServer- und MAMP-Setups mit mehreren Websites: Erstellen Sie einen HTTP-Tunnel und stellen Sie sicher, dass der Webserver einen ihm bekannten Hostnamen erhält.

Warum ein Virtual Host den richtigen Host-Header braucht #

Bei namensbasierten Virtual Hosts beantwortet ein Webserver Anfragen für mehrere Websites auf demselben Port. Er wählt die Website anhand des Host-Headers jeder Anfrage aus: Eine Anfrage für mysite.test erhält die Website, in deren Konfiguration mysite.test steht.

Ein HTTP-Tunnel gibt den Host-Header des Besuchers unverändert an Ihren Webserver weiter. Ein Besucher, der die Adresse des Tunnels öffnet, sendet daher den Hostnamen des Tunnels, zum Beispiel einen Namen, der auf .localto.net endet, und nicht mysite.test. Ihr Webserver kennt diesen Namen nicht und antwortet mit seiner Standardwebsite, meist der ersten in der Konfiguration oder der Startseite von XAMPP oder WampServer.

Es gibt drei Möglichkeiten, das zu beheben. Wählen Sie eine aus:

OptionWas Sie ändernAm besten für
Den Host-Header im Tunnel festlegenEin Request-Header in den Einstellungen des Tunnels. Am Webserver ändert sich nichts.Ein schneller Blick auf eine statische oder einfache Website.
Den Namen des Tunnels zum Virtual Host hinzufügenEine Zeile in der Konfiguration des Webservers.Anwendungen, die Links und Weiterleitungen aus dem Hostnamen aufbauen.
Eine eigene Domain verwendenDer Tunnel verwendet eine Domain, die Ihnen gehört, und der Virtual Host wird nach ihr benannt.Eine Website, die eine feste Adresse behalten soll.

Bevor Sie beginnen #

  • Ein Localtonet-Konto und der Localtonet-Client, verbunden mit Ihrem AuthToken, auf dem Computer, auf dem der Webserver läuft. Siehe Schnellstart.
  • Ein Virtual Host, der in einem Browser auf diesem Computer funktioniert, zum Beispiel http://mysite.test.
  • Der Port, auf dem der Webserver lauscht. XAMPP und WampServer verwenden 80. MAMP verwendet 8888, sofern Sie ihn nicht geändert haben.

Den Tunnel erstellen #

  1. Die HTTP-Seite öffnen #

    Öffnen Sie Meine Tunnel › HTTP und klappen Sie HTTP-Tunnel erstellen auf.

  2. Das Formular ausfüllen #

    FeldWas Sie eingeben
    URL-TypZufällige Subdomain für die Optionen 1 und 2. Wählen Sie für Option 3 Eigene Domain.
    Geräte-TokenDer Token, den der Localtonet-Client auf dem Computer verwendet.
    ServerregionWählen Sie eine Region in der Nähe Ihres Geräts für geringere Latenz.
    Lokale IP-Adresse127.0.0.1. Geben Sie die Adresse ein, nicht den Namen des Virtual Hosts: Der Name wird im Host-Header übertragen.
    Lokaler PortDer Port des Webservers, zum Beispiel 80.

    Wählen Sie Tunnel erstellen.

  3. Den Tunnel starten #

    Der Tunnel erscheint unter Ihre Tunnel. Wählen Sie Starten und notieren Sie die öffentliche Adresse in der Spalte URL. Wenn Sie sie jetzt öffnen, sehen Sie die Standardwebsite des Webservers. Der nächste Schritt behebt das.

Das Tunnelformular ist ausführlich auf der Seite HTTP / HTTPS beschrieben.

Option 1: Den Host-Header im Tunnel festlegen #

Der Tunnel kann den Host-Header ersetzen, bevor eine Anfrage Ihren Webserver erreicht. Die Einstellung ist ein Request-Header mit dem Namen Host:

  1. Wählen Sie in der Zeile des Tunnels Einstellungen.
  2. Wählen Sie neben Header die Option Verwalten. Das Fenster HTTP-Header öffnet sich bei Request-Header.
  3. Wählen Sie unter Vorschläge den Eintrag Host oder wählen Sie Request-Header hinzufügen und geben Sie Host als Namen ein.
  4. Geben Sie als Wert den Namen Ihres Virtual Hosts ein, zum Beispiel mysite.test. Der Vorschlag trägt localhost ein; ersetzen Sie das. Geben Sie nur den Hostnamen ein, ohne http:// und ohne Pfad.
  5. Wählen Sie Speichern.

Das Dashboard beschreibt den Request-Header Host so: Ihr Dienst erhält diesen Hostnamen anstelle der Tunneladresse, was nützlich ist, wenn ein lokaler Webserver die Website anhand des Hostnamens auswählt. Ohne Host-Request-Header erhält Ihr Dienst den Hostnamen, den der Besucher verwendet hat.

Öffnen Sie die Adresse des Tunnels erneut. Der Webserver erhält jetzt Host: mysite.test und antwortet mit dieser Website. Um den Zustand zurückzusetzen, entfernen Sie den Header und speichern Sie.

Auch die Anwendung sieht den lokalen Namen. Software, die Links und Weiterleitungen aus dem Host-Header oder aus einer konfigurierten Website-Adresse aufbaut, schickt Besucher jetzt zu mysite.test, das nur auf Ihrem Computer existiert. Wenn Seiten ohne Stile laden oder eine Anmeldung auf den lokalen Namen weiterleitet, verwenden Sie stattdessen Option 2 oder 3.

Die API hat dieselbe Einstellung als Host-Header-Überschreibung eines HTTP-Tunnels. Siehe API. Weitere Request- und Response-Header behandelt die Seite Header und Rewrites.

Option 2: Den Namen des Tunnels zum Virtual Host hinzufügen #

Teilen Sie dem Webserver mit, dass der Hostname des Tunnels zu Ihrer Website gehört. Kopieren Sie den Hostnamen aus der URL des Tunnels ohne https:// und fügen Sie ihn als Alias hinzu. Lassen Sie die Header des Tunnels leer.

Apache #

In XAMPP befinden sich die Virtual Hosts in apache\conf\extra\httpd-vhosts.conf. Fügen Sie eine ServerAlias-Zeile hinzu:

httpd-vhosts.conf
<VirtualHost *:80>
    ServerName mysite.test
    ServerAlias <TUNNEL_HOST>
    DocumentRoot "C:/xampp/htdocs/mysite"
</VirtualHost>

Starten Sie Apache neu.

Nginx #

Fügen Sie den Hostnamen des Tunnels zu server_name hinzu:

mysite.conf
server {
    listen 80;
    server_name mysite.test <TUNNEL_HOST>;
    root /var/www/mysite;
    index index.html index.php;
}

Prüfen Sie die Konfiguration und laden Sie Nginx neu:

Terminal
sudo nginx -t && sudo nginx -s reload

Ein HTTP-Tunnel behält seine Subdomain, bis Sie den Tunnel löschen, daher bleibt der Alias über Neustarts hinweg gültig.

Option 3: Eine eigene Domain verwenden #

Läuft der Tunnel auf einer Domain, die Ihnen gehört, senden Besucher diese Domain im Host-Header, und Sie benennen den Virtual Host danach. Weder eine Header-Überschreibung noch ein Alias ist nötig, und die Links, die die Anwendung aufbaut, sind korrekt.

  1. Fügen Sie die Domain Ihrem Konto hinzu und erstellen Sie den HTTP-Tunnel mit URL-Typ auf Eigene Domain. Die Schritte finden Sie unter Eigene Domains. Eigene Domains erfordern Guthaben.
  2. Setzen Sie ServerName (Apache) oder server_name (Nginx) des Virtual Hosts auf diese Domain, wie in den obigen Beispielen.

Eigene Subdomain funktioniert genauso, mit einem Namen Ihrer Wahl statt eines zufälligen. Auch dafür ist Guthaben erforderlich.

Mehrere Virtual Hosts #

Ein HTTP-Tunnel hat eine öffentliche Adresse und erreicht eine Website. Erstellen Sie für jeden weiteren Virtual Host einen weiteren HTTP-Tunnel zur selben Lokalen IP-Adresse und zum selben Lokalen Port und wenden Sie eine der Optionen darauf an. Der Kostenlose Plan erlaubt insgesamt einen Tunnel. Siehe Pläne und Guthaben.

Absichern #

Eine Entwicklungswebsite ist oft nicht bereit für Fremde. Ein HTTP-Tunnel kann Besucher auffordern, sich zu identifizieren, bevor eine Anfrage Ihren Webserver erreicht:

  • Basic Auth? in den Einstellungen des Tunnels fragt Besucher nach einem Benutzernamen und einem Passwort.
  • IP-Beschränkung › Verwalten lässt nur die von Ihnen aufgelisteten Adressen zu. Dafür ist Guthaben erforderlich.
  • SSO-Anbieter lässt Besucher sich zuerst bei einem Identitätsanbieter anmelden. Dafür ist Guthaben erforderlich.

Alle drei sind unter Zugriffskontrolle beschrieben. Für eine Demo stoppt das Ablaufdatum den Tunnel zu einem von Ihnen festgelegten Datum. Siehe Limits und Ablauf.

Häufige Probleme #

Ich sehe die Startseite von XAMPP oder WampServer oder die falsche Website

Der Webserver hat den Hostnamen nicht erkannt und seine Standardwebsite ausgeliefert. Wenden Sie eine der drei Optionen an. Prüfen Sie bei Option 1, ob der Name des Headers Host lautet und sein Wert mit ServerName oder server_name der Website übereinstimmt. Prüfen Sie bei Option 2 den Alias auf Tippfehler und starten Sie den Webserver neu.

Die Seite lädt ohne Stile, oder Links führen zu mysite.test

Die Anwendung baut ihre Adressen aus dem lokalen Namen auf. Verwenden Sie Option 2 oder 3, damit die Anwendung den öffentlichen Namen sieht. Bei Anwendungen mit gespeicherter Website-Adresse muss auch diese Adresse geändert werden: Aktualisieren Sie bei WordPress die Website-URL auf die Adresse des Tunnels oder verwenden Sie eine eigene Domain.

Die Website leitet auf http:// weiter, und der Browser zeigt eine Warnung oder eine Schleife

Besucher verwenden HTTPS an der Adresse des Tunnels, während der Tunnel mit Ihrem Webserver per einfachem HTTP spricht. Eine Anwendung, die HTTPS selbst erzwingt, bemerkt möglicherweise nicht, dass der Besucher bereits HTTPS verwendet. Unter Header teilt der Request-Header X-Forwarded-Proto aus den Vorschlägen mit dem Wert https einer solchen Anwendung mit, dass Besucher HTTPS verwenden.

Besucher sehen zuerst eine Localtonet-Warnseite

Bei Konten ohne Guthaben zeigt Localtonet diese Seite jedem Besucher eines HTTP-Tunnels einmal. Anfragen mit einem localtonet-skip-warning-Header mit beliebigem Wert überspringen sie, ebenso Tunnel von Konten mit Guthaben.

Mein Webserver lauscht nur auf HTTPS

Setzen Sie den Lokalen Port des Tunnels auf den HTTPS-Port, meist 443, und aktivieren Sie in den Einstellungen des Tunnels SslStream aktiv?. Dieser Schalter ist für lokale Dienste gedacht, die selbst HTTPS oder TLS verwenden.

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

Eigene Subdomain, Eigene Domain, IP-Beschränkung und SSO-Anbieter erfordern Guthaben. Laden Sie es unter Guthaben auf.

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

Support