Warum funktioniert ein Reverse-Proxy über eine Domain, aber nicht über eine lokale IP-Adresse?

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Ein Reverse-Proxy funktioniert domainbasiert, weil seine Routing- und TLS-Regeln oft vom angefragten Hostnamen abhängen und nicht nur von der Ziel-IP-Adresse.

Wenn ein Heimnetzwerk-Client https://app.example.com aufruft, liefert DNS eine IP-Adresse, aber der Browser sendet die Domain weiterhin im TLS-Handshake und im HTTP-Host-Header. Beim Aufruf von https://192.168.1.20 ändern sich diese Kennungen. Daher kann der Proxy eine Standardseite auswählen, das Zertifikat ablehnen, die Anwendungsroute verfehlen oder zur konfigurierten öffentlichen URL zurückleiten. Beim richtigen Test bleibt der vorgesehene Hostname erhalten, während nur das Netzwerkziel geändert wird.

Anfrage mit Hostnamen und Anfrage an direkte IP-Adresse vergleichen

Senden Sie eine Anfrage an die Domain und eine an die lokale IP-Adresse und vergleichen Sie anschließend Statuscode, Zertifikat, Antwort-Header, Weiterleitungsziel und Zugriffsprotokoll des Reverse-Proxys. Gehen Sie nicht davon aus, dass beide Anfragen gleichwertig sind, nur weil sie dieselbe Ethernet-Schnittstelle erreichen.

Eine Anleitung zu Reverse-Proxys im Homelab erklärt, dass der Proxy den HTTP-Host-Header prüft, um mehrere Dienste über eine IP-Adresse und einen Port weiterzuleiten.

Wenn die Anfrage an die Domain einer Anwendungsroute entspricht, während die Anfrage an die IP-Adresse eine Standardseite oder einen 404-Fehler liefert, arbeitet der Proxy wie vorgesehen. Als Nächstes ist zu entscheiden, ob der direkte Zugriff über die IP-Adresse tatsächlich erforderlich ist oder ob lokales DNS die Domain beibehalten sollte.

Lokale IP-Adresse testen und dabei den vorgesehenen Host-Header beibehalten

Verwenden Sie ein Client-Tool, das eine Verbindung zur lokalen Proxy-IP-Adresse herstellt und dabei die Anwendungsdomain als Host-Header sendet. Behalten Sie bei HTTPS die Domain auch als TLS-Servernamen bei, statt sie durch die IP-Adresse zu ersetzen.

Server Fault beschreibt, wie ein HTTP-Reverse-Proxy den Host-Header zur Routenauswahl auf dieselbe Weise wie namensbasierte virtuelle Hosts verwenden kann.

Wenn die Anfrage mit erzwungenem Hostnamen erfolgreich ist, funktionieren die Proxy-Route und das Backend; der Fehler beim direkten Aufruf der IP-Adresse ist auf eine Abweichung der Identität zurückzuführen. Schlägt die Anfrage weiterhin fehl, prüfen Sie den Listener, die lokale Firewall, den Proxy-Einstiegspunkt und die Routenpriorität, bevor Sie DNS ändern.

TLS-SNI und Zertifikatszuordnung prüfen

Bei HTTPS wird vor der HTTP-Anfrage eine Entscheidung anhand des Hostnamens getroffen. Der Client sendet während des TLS-Handshakes gewöhnlich die Server Name Indication, damit der Proxy das richtige Zertifikat und den passenden sicheren virtuellen Host auswählen kann.

Eine Beschreibung der SNI-Reverse-Proxy-Implementierung weist darauf hin, dass HTTPS-Backends anhand des SNI-Hostnamens des Clients ausgewählt werden, bevor gewöhnliche HTTP-Header geprüft werden können.

Beim direkten Zugriff über die IP-Adresse wird möglicherweise ein Standardzertifikat angezeigt oder die Hostnamenprüfung schlägt fehl, obwohl der Proxy erreichbar ist. Verwenden Sie die Domain mit lokalem DNS oder stellen Sie ein gezielt verwaltetes Zertifikat bereit, das die IP-Adresse enthält, wenn HTTPS über die direkte IP-Adresse tatsächlich erforderlich ist.

Standardseite und Routenpriorität prüfen

Prüfen Sie, welcher virtuelle Host Anfragen verarbeitet, die keiner konfigurierten Domain entsprechen. Eine Standardseite kann ein Dashboard anzeigen, zu einem anderen Hostnamen weiterleiten, die Verbindung schließen oder einen allgemeinen Fehler offenlegen.

Eine Caddy-Diskussion zeigt, dass eine Anfrage zwar die richtige Proxy-IP erreichen kann, aber der Host-Header und der TLS-Name trotzdem darüber entscheiden, ob der vorgesehene Upstream ausgewählt wird.

Legen Sie die Standardroute ausdrücklich und sicher fest. Richten Sie keinen allgemeinen Catch-all-Proxy zu einem einzelnen Backend ein, nur damit der Zugriff per IP funktioniert. Dadurch könnten unbekannte Hostnamen oder Scan-Anfragen bei einer Anwendung landen, die nur über eine Domain erreichbar sein sollte.

Prüfen, ob die Anwendung zu ihrer kanonischen URL weiterleitet

Selbst wenn der Proxy die IP-Anfrage akzeptiert, erzwingt das Backend möglicherweise eine konfigurierte öffentliche Basis-URL und leitet den Browser zur Domain weiter. Auch Authentifizierungs-Cookies, OAuth-Callbacks, WebSocket-Ursprünge und CSRF-Prüfungen können von diesem kanonischen Host abhängen.

Vergleichen Sie das Proxy-Protokoll mit dem Anwendungsprotokoll und prüfen Sie den Location-Header. Eine Weiterleitung zur Domain ist kein Routingfehler, sondern ein Hinweis darauf, dass die Anwendung eine einzige öffentliche Identität erwartet.

Korrigieren Sie weitergeleitete Host- und Protokoll-Header, wenn die App eine falsche externe URL erzeugt. Ersetzen Sie die kanonische Domain nicht durch eine private IP-Adresse, nur um die Weiterleitung zu umgehen, da dies Zertifikate und den Fernzugriff beeinträchtigen kann.

Lokales DNS verwenden, wenn die Domain die vorgesehene Schnittstelle ist

Erstellen Sie einen internen DNS-Eintrag, der die Anwendungsdomain zur lokalen Adresse des Reverse-Proxys auflöst. Der Browser nutzt dann den effizienten LAN-Pfad, während derselbe Host-Header, SNI-Name, dasselbe Zertifikat, dieselben Cookies und dieselbe Anwendungs-URL erhalten bleiben.

Der ZimaSpace-Vergleich von Reverse-Proxys und privaten Zugriffswegen hilft bei der Entscheidung, ob die Domain als interner und öffentlicher Einstiegspunkt dienen oder hinter einem privaten Netzwerk bleiben soll.

Das Problem ist behoben, wenn die Domain sowohl intern als auch extern dank gezielter DNS-Antworten funktioniert und die direkte IP-Adresse entweder zu einer dokumentierten Standardseite führt oder ausdrücklich abgewiesen wird. Ein domainbasierter Proxy muss sich nicht wie ein Server verhalten, der eine einzelne Website über eine IP-Adresse bereitstellt.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.