Website-Weiterleitungen in ServBay konfigurieren

Website-Weiterleitungen sind Prozesse, bei denen Besucher automatisch von einer URL zu einer anderen weitergeleitet werden. Die Konfiguration von Weiterleitungen in einer lokalen Entwicklungsumgebung ist entscheidend, um das Verhalten der Produktionsumgebung zu simulieren, Änderungen an der URL-Struktur zu testen oder sicherzustellen, dass alte Links auch in neuen Entwicklungsständen weiterhin funktionieren. ServBay als leistungsstarke lokale Webentwicklungsumgebung ermöglicht es Ihnen, Weiterleitungen über die integrierten Webserver (Caddy oder Nginx) ganz einfach einzurichten.

Übersicht

In ServBay wird jede von Ihnen erstellte Website durch eine eigene Webserver-Konfiguration verwaltet. Weiterleitungen werden durch Anpassungen dieser Webserver-Konfigurationsdateien umgesetzt. ServBay unterstützt sowohl Caddy als auch Nginx als Webserver – je nach Projektbedarf oder persönlicher Präferenz können Sie einen der beiden wählen. Die Konfiguration von Weiterleitungen beinhaltet in der Regel die Angabe von Quell-URL-Mustern, Ziel-URLs und des Weiterleitungstyps (z. B. 301 für permanente Weiterleitung oder 302 für temporäre Weiterleitung).

Anwendungsfälle

Typische Szenarien für den Einsatz von Website-Weiterleitungen in ServBay während der Entwicklung sind:

Produktionsumgebung simulieren: Sie stellen sicher, dass Ihre lokale Konfiguration mit den Weiterleitungsregeln des Produktionsservers übereinstimmt.
HTTPS-Test: Erzwingen Sie die Umleitung aller HTTP-Anfragen auf HTTPS, um sichere Verbindungen zu simulieren.
URL-Kanonisierung: Leiten Sie Domains mit www auf die Variante ohne www um oder umgekehrt, um eine konsistente URL-Struktur zu gewährleisten.
Umgang mit Änderungen der URL-Struktur: Wenn Sie Seitenpfade oder die Struktur Ihrer Website ändern, werden alte URLs auf neue weitergeleitet, um Fehlerseiten im lokalen Test zu vermeiden.
Test bei Domain-Migrationen: Simulieren Sie Weiterleitungseinstellungen vom alten auf einen neuen Domainnamen.

Voraussetzungen

Um Website-Weiterleitungen in ServBay zu konfigurieren, benötigen Sie:

Eine installierte und laufende ServBay-Instanz.
Die gewünschte Website in ServBay hinzugefügt und eingerichtet.
Die Information, ob Ihre Website Caddy oder Nginx als Webserver verwendet.

Vorgehensweise zur Konfiguration

ServBay bietet für jede Website eine eigene Webserver-Konfigurationsdatei. Über die ServBay-Benutzeroberfläche können Sie diese Dateien bequem öffnen und bearbeiten.

Zugriff auf die Website-Konfigurationsdatei

Öffnen Sie die ServBay-Anwendung.
Klicken Sie in der Navigationsleiste links auf Website.
Suchen Sie die Website, für die Sie Weiterleitungen einrichten möchten, und klicken Sie auf den Namen, um die Detailseite zu öffnen.
Auf der Detailseite der Website finden Sie die Option „Konfigurationsdatei“ oder eine ähnlich benannte Schaltfläche (Position und Name können je nach ServBay-Version leicht variieren). Durch einen Klick öffnen Sie die zugehörige Webserver-Konfigurationsdatei.

Je nachdem, ob Sie Caddy oder Nginx als Webserver verwenden, folgen Sie bitte der entsprechenden Anleitung unten.

Weiterleitungen mit Caddy einrichten

Falls Ihre Website Caddy als Webserver verwendet, bearbeiten Sie die zugehörige Caddyfile. Die Syntax des Caddyfile ist schlicht und eingängig.

Hier einige gängige Caddy-Weiterleitungskonfigurationen. Fügen Sie diese in die Caddyfile Ihrer Website ein – meist innerhalb eines Site-Adress-Blocks ({}).

Beispiel 1: HTTP-zu-HTTPS-Weiterleitung

Caddy behandelt standardmäßig HTTP-zu-HTTPS-Weiterleitungen automatisch, sofern Sie ein SSL-Zertifikat für Ihre Website eingerichtet haben (entweder über die ServBay User CA oder ACME). Möchten Sie dennoch eine manuelle bzw. gezielte Kontrolle, nutzen Sie die redir-Direktive:

bash

servbay.demo {
    # ... andere Konfigurationen ...

    # Erzwingen Sie die Umleitung aller HTTP-Anfragen auf HTTPS
    # Wenn Sie die SSL-Funktion von ServBay nutzen, ist diese Regel normalerweise nicht nötig.
    # Für benutzerdefinierte Anpassungen fügen Sie dies hinzu:
    redir http://servbay.demo https://servbay.demo{uri} permanent

    # ... andere Konfigurationen ...
}

Beispiel 2: Weiterleitung von nicht-www auf www

Leiten Sie servbay.demo weiter auf www.servbay.demo:

bash

servbay.demo {
    # Leitet alle Anfragen an servbay.demo dauerhaft auf www.servbay.demo um
    redir https://www.servbay.demo{uri} permanent
}

www.servbay.demo {
    # Normale Konfiguration für www.servbay.demo
    root * /Applications/ServBay/www/your-servbay-demo-site
    file_server
    # ... andere Konfigurationen ...
}

Beispiel 3: Weiterleitung von www auf nicht-www

Leiten Sie www.servbay.demo weiter auf servbay.demo:

bash

www.servbay.demo {
    # Leitet alle Anfragen an www.servbay.demo dauerhaft auf servbay.demo um
    redir https://servbay.demo{uri} permanent
}

servbay.demo {
    # Normale Konfiguration für servbay.demo
    root * /Applications/ServBay/www/your-servbay-demo-site
    file_server
    # ... andere Konfigurationen ...
}

Beispiel 4: Weiterleitung für bestimmte Pfade

Leiten Sie den alten Pfad /old-path auf den neuen Pfad /new-path um:

bash

servbay.demo {
    # ... andere Konfigurationen ...

    # Permanente Weiterleitung von /old-path auf /new-path
    redir /old-path /new-path permanent

    # Temporäre Weiterleitung von /deprecated/page.html auf /new/page/
    redir /deprecated/page.html /new/page/ temporary

    # ... andere Konfigurationen ...
}

Caddy-Weiterleitungstypen

permanent: 301 Permanente Weiterleitung – SEO-freundlich.
temporary: 302 Temporäre Weiterleitung.
internal: Internes Rewriting, URL bleibt gleich (keine echte HTTP-Weiterleitung).

Nach dem Ändern der Caddyfile speichern Sie die Datei; ServBay lädt die Caddy-Konfiguration automatisch neu oder fordert Sie dazu auf.

Weiterleitungen mit Nginx einrichten

Wenn Ihre Website Nginx als Webserver verwendet, bearbeiten Sie die jeweilige Nginx-Konfigurationsdatei (meist eine .conf-Datei). Nginx nutzt return oder rewrite, um Weiterleitungen umzusetzen. return ist einfacher und für einfache, feste Weiterleitungen empfohlen; rewrite eignet sich für komplexere Fälle dank Regex-Unterstützung.

Im Folgenden Beispiele für häufig verwendete Nginx-Weiterleitungskonfigurationen. Fügen Sie diese Ihrer Nginx-.conf-Datei, im Allgemeinen innerhalb eines server-Blocks, hinzu.

Beispiel 1: HTTP-zu-HTTPS-Weiterleitung

Falls Ihre Website in ServBay auf Port 80 und 443 lauscht, können Sie in den server-Block für Port 80 folgende Weiterleitungsregel einfügen:

nginx

server {
    listen 80;
    listen [::]:80;
    server_name servbay.demo www.servbay.demo;

    # Alle HTTP-Anfragen auf HTTPS umleiten
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name servbay.demo www.servbay.demo;

    # ... Weitere HTTPS-Konfiguration ...
    # ssl_certificate ...;
    # ssl_certificate_key ...;

    # Website-Stammverzeichnis etc.
    root /Applications/ServBay/www/your-servbay-demo-site;
    index index.html index.htm index.php;

    # ... Weitere location-Blöcke etc. ...
}

Beispiel 2: Weiterleitung von nicht-www auf www

Leiten Sie servbay.demo zu www.servbay.demo um:

nginx

server {
    listen 80;
    listen [::]:80;
    server_name servbay.demo; # Hört auf die nicht-www Domain

    # Leitet alle Anfragen auf die www-Subdomain um, inkl. Protokoll und URI
    return 301 $scheme://www.servbay.demo$request_uri;
}

server {
    listen 80;
    listen [::]:80;
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name www.servbay.demo; # Hört auf die www Domain

    # ... Normale Website-Konfiguration ...
    # ssl_certificate ...;
    # ssl_certificate_key ...;
    root /Applications/ServBay/www/your-servbay-demo-site;
    index index.html index.htm index.php;
    # ...
}

Beispiel 3: Weiterleitung von www auf nicht-www

Leiten Sie www.servbay.demo zu servbay.demo um:

nginx

server {
    listen 80;
    listen [::]:80;
    server_name www.servbay.demo; # Hört auf die www Domain

    # Leitet alle Anfragen auf die nicht-www Domain um, inkl. Protokoll und URI
    return 301 $scheme://servbay.demo$request_uri;
}

server {
    listen 80;
    listen [::]:80;
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name servbay.demo; # Hört auf die nicht-www Domain

    # ... Normale Website-Konfiguration ...
    # ssl_certificate ...;
    # ssl_certificate_key ...;
    root /Applications/ServBay/www/your-servbay-demo-site;
    index index.html index.htm index.php;
    # ...
}

Beispiel 4: Weiterleitungen für bestimmte Pfade (mit `location` und `return` oder `rewrite`)

Leiten Sie den alten Pfad /old-path auf den neuen Pfad /new-path um:

nginx

server {
    # ... Weitere Server-Konfigurationen ...

    location = /old-path {
        # Genaue Übereinstimmung von /old-path, leitet dauerhaft auf /new-path um
        return 301 /new-path;
    }

    location /deprecated/ {
        # Leitet alle Anfragen unter /deprecated/ temporär auf /archive/
        rewrite ^/deprecated/(.*)$ /archive/$1 temporary;
    }

    # ... Weitere location-Blöcke ...
}

Nginx-Weiterleitungstypen

301: Permanente Weiterleitung.
302: Temporäre Weiterleitung.
redirect: Entspricht 302.
permanent: Entspricht 301.

Speichern Sie die geänderte Nginx-.conf-Datei; ServBay lädt die Webserver-Konfiguration automatisch neu oder fordert Sie dazu auf.

Hinweise

Konfigurationsdateien sichern: Erstellen Sie vor jeder Änderung eine Sicherung der Originaldatei, um sie bei Problemen wiederherstellen zu können.
Syntax prüfen: Nach Anpassungen empfiehlt sich eine Syntaxüberprüfung. ServBay prüft beim Speichern die Grundsyntax, trotzdem ist ein manueller Test sinnvoll. Bei Nginx kann z. B. der Befehl nginx -t (sofern im Systempfad oder in einer von ServBay bereitgestellten Shell) genutzt werden.
Weiterleitungen testen: Testen Sie alle relevanten Fälle gründlich im Browser – mit und ohne www, für HTTP und HTTPS sowie sämtliche von Ihnen eingerichtete spezielle Weiterleitungen. So stellen Sie sicher, dass alles wie gewünscht funktioniert.
Browser-Cache beachten: Browser speichern permanente 301-Weiterleitungen im Cache. Wenn Sie häufig 301-Regeln während des Tests ändern, kann dies zu unerwartetem Verhalten führen. Leeren Sie in diesem Fall den Browser-Cache oder nutzen Sie den Inkognito-Modus bzw. deaktiviertes Caching in den Entwicklertools. Für kurzfristige Tests ist eine temporäre 302-Weiterleitung meist praktischer – final sollten Sie dann zu 301 wechseln.
ServBay-Neuladen: Nach Änderungen sicherstellen, dass ServBay die Webserver-Konfiguration erfolgreich neu geladen hat. In der Regel erfolgt dies automatisch, andernfalls erhalten Sie einen Hinweis bzw. eine Schaltfläche in der UI.

Häufig gestellte Fragen (FAQ)

Frage: Ich habe Weiterleitungen eingerichtet, aber der Browser leitet nicht weiter. Woran kann das liegen?

Antwort: Mögliche Gründe sind:

Fehler in der Konfigurationsdatei: Kontrollieren Sie Syntax und Speichervorgang Ihrer Änderungen.
Konfiguration nicht neu geladen: Vergewissern Sie sich, dass die neuen Einstellungen in ServBay übernommen wurden.
Browser-Cache: Cache löschen oder im Inkognito/Privatmodus testen.
Fehlerhafte URL-Regel: Prüfen Sie, ob Quell-URL/Pfad in Ihrer Weiterleitungsregel mit dem tatsächlichen Aufruf übereinstimmt.

Frage: Was ist der Unterschied zwischen 301- und 302-Weiterleitungen? Welche sollte ich in der lokalen Entwicklung verwenden?

Antwort: 301 steht für eine permanente Weiterleitung – Browser und Suchmaschinen lernen dabei, dass Ressourcen dauerhaft umgezogen sind, was auch für SEO relevant ist. 302 ist eine temporäre Weiterleitung, die nur vorübergehend gilt. In der lokalen Entwicklung empfiehlt sich für kurzfristige Tests oder Debugging meist 302, da Browser diese nicht cachen. Simulieren Sie dagegen dauerhafte Änderungen wie Domain-Migrationen, ist eine 301-Weiterleitung sinnvoll.

Frage: Nach dem Bearbeiten der Konfigurationsdatei zeigt ServBay Fehler oder der Webserver startet nicht – was tun?

Antwort: Ursache ist meist ein Syntaxfehler in der Konfiguration. Prüfen Sie gründlich die betroffenen Abschnitte und vergleichen Sie die Änderungen mit der Dokumentation zur Caddyfile- oder Nginx-Syntax. Die Logdateien von ServBay enthalten häufig genaue Fehlermeldungen und unterstützen bei der Fehlersuche.

Fazit

Die Einrichtung von Weiterleitungen in ServBay ist eine Standardaufgabe in der lokalen Webentwicklung – Sie brauchen dazu nur die Caddy- oder Nginx-Konfigurationsdatei zu bearbeiten. Ob zum Simulieren der Produktionsumgebung, zum Testen von HTTPS oder bei Änderungen der URL-Struktur: Wer die Syntaxbefehle (redir bei Caddy, return/rewrite bei Nginx) beherrscht, kann Weiterleitungen in ServBay zuverlässig und effizient realisieren. Testen Sie nach jeder Änderung umfassend – beachten Sie dabei auch den Einfluss des Browser-Caches.

Website-Weiterleitungen in ServBay konfigurieren ​

Übersicht ​

Anwendungsfälle ​

Voraussetzungen ​

Vorgehensweise zur Konfiguration ​

Zugriff auf die Website-Konfigurationsdatei ​

Weiterleitungen mit Caddy einrichten ​

Beispiel 1: HTTP-zu-HTTPS-Weiterleitung ​

Beispiel 2: Weiterleitung von nicht-www auf www ​

Beispiel 3: Weiterleitung von www auf nicht-www ​

Beispiel 4: Weiterleitung für bestimmte Pfade ​

Caddy-Weiterleitungstypen ​

Weiterleitungen mit Nginx einrichten ​

Beispiel 1: HTTP-zu-HTTPS-Weiterleitung ​

Beispiel 2: Weiterleitung von nicht-www auf www ​

Beispiel 3: Weiterleitung von www auf nicht-www ​

Beispiel 4: Weiterleitungen für bestimmte Pfade (mit location und return oder rewrite) ​

Nginx-Weiterleitungstypen ​

Hinweise ​

Häufig gestellte Fragen (FAQ) ​

Fazit ​

Website-Weiterleitungen in ServBay konfigurieren

Übersicht

Anwendungsfälle

Voraussetzungen

Vorgehensweise zur Konfiguration

Zugriff auf die Website-Konfigurationsdatei

Weiterleitungen mit Caddy einrichten

Beispiel 1: HTTP-zu-HTTPS-Weiterleitung

Beispiel 2: Weiterleitung von nicht-www auf www

Beispiel 3: Weiterleitung von www auf nicht-www

Beispiel 4: Weiterleitung für bestimmte Pfade

Caddy-Weiterleitungstypen

Weiterleitungen mit Nginx einrichten

Beispiel 1: HTTP-zu-HTTPS-Weiterleitung

Beispiel 2: Weiterleitung von nicht-www auf www

Beispiel 3: Weiterleitung von www auf nicht-www

Beispiel 4: Weiterleitungen für bestimmte Pfade (mit `location` und `return` oder `rewrite`)

Nginx-Weiterleitungstypen

Hinweise

Häufig gestellte Fragen (FAQ)

Fazit