Home Assistant kann hinter einem Reverse-Proxy laufen, aber die zuverlässige Bereitstellung über einen umgeschriebenen Unterpfad wird im Allgemeinen nicht als unterstützte Bereitstellungsgrenze angesehen.
Eine Seite unter example.com/homeassistant kann HTML zurückgeben, während spätere Anfragen weiterhin auf root-relative Assets, Authentifizierungsrouten, WebSockets oder Integrations-Callbacks zielen. Teste mehr als nur den ersten Bildschirm: Verwende einen frischen Browser, melde dich an, öffne ein Live-Dashboard, lade eine verschachtelte Route neu und schließe einen Callback ab. Wenn irgendeine Ebene das Präfix verliert, verschiebe Home Assistant auf einen eigenen Hostnamen, statt weitere Umschreibungen hinzuzufügen.
Unterstützung für Reverse-Proxys von der Unterstützung für Unterpfade unterscheiden
Ein Reverse-Proxy kann TLS beenden und eine Anfrage an den Stamm des Hostnamens an Home Assistant weiterleiten. Ein Unterpfad stellt eine andere Anforderung: Jede generierte URL, jedes Asset, jeder API-Aufruf, jeder WebSocket, jede Weiterleitung und jeder Callback muss durchgängig ein Präfix beibehalten, das die Anwendung versteht. Erfolg auf der Proxy-Ebene belegt nicht, dass dieser Anwendungsvertrag erfüllt wird.
Tests der Home-Assistant-Community kommen zu einem klaren Ergebnis: Die Anwendung unterstützt keine Bereitstellung unter einem URL-Präfix. Die Antwort auf die Frage Home Assistant in einem Unterpfad einzurichten empfiehlt unabhängig von der Proxy-Wahl eine Subdomain.
BESTANDEN für Reverse-Proxy-Unterstützung bedeutet, dass Home Assistant am Stammverzeichnis eines dedizierten Hostnamens mit korrekter Weiterleitung funktioniert. NICHT BESTANDEN für den vorgeschlagenen Unterpfad bedeutet, dass eine oder mehrere Anwendungsrouten das Präfix verlieren. Fasse diese Urteile nicht zu der Behauptung zusammen, Reverse-Proxys seien grundsätzlich inkompatibel.
Frontend-Assets als ersten risikoarmen Test verwenden
Öffne den vorgeschlagenen Unterpfad in einem privaten Browserprofil und prüfe die Netzwerkanfragen, bevor du Home Assistant änderst. Wenn das Basisdokument geladen wird, JavaScript, Symbole, Manifeste oder Übersetzungen aber Pfade am Stammverzeichnis des Hostnamens anfordern, ist die Topologie bereits bei ihrem ersten reversiblen Unterscheidungstest durchgefallen.
Ein dokumentierter Versuch zur Pfadumschreibung lieferte die Hauptseite, während Frontend-Ressourcen Schrägstrich-präfixierte URLs ohne das Home-Assistant-Präfix anforderten. Dieser Fehler bei root-relativen Assets ist eine Abweichung beim Anwendungspfad und keine fehlende Datei auf dem Proxy.
BESTANDEN bedeutet, dass jede Frontend-Ressource unter der vorgesehenen Route erfolgreich geladen wird. NICHT BESTANDEN bedeutet, dass 404-Antworten oder Anfragen an den Root-Pfad auftreten. Halte dort an und teste einen dedizierten Hostnamen. Das Ersetzen von Inhalten im Antworttext ist fehleranfällig, da zukünftige Frontend-Builds neue Pfade einführen können, die von der Umschreibung nicht abgedeckt werden.
WebSockets, Authentifizierung und verschachtelte Routen testen
Ein statisches Dashboard-Shell ist keine vollständige Sitzung. Melde dich in einem sauberen Profil an, beobachte mehrere Minuten lang die Aktualisierung von Entitäten, lade eine verschachtelte Dashboard-URL neu, melde dich ab und anschließend wieder an. Prüfe dann, ob HTTP-Upgrades, Tokens, Weiterleitungen und das Neuladen von Routen denselben öffentlichen Ursprung und Pfad beibehalten.
Home Assistant ist für die Live-Kommunikation mit dem Frontend stark auf WebSockets angewiesen, daher muss ein Proxy den Upgrade-Pfad und die Header unverändert weiterleiten. Der Erfahrungsbericht eines Betreibers zur WebSocket-Verarbeitung durch Reverse-Proxys zeigt, warum das Laden von HTML allein kein ausreichender Kompatibilitätstest ist.
BESTANDEN bedeutet, dass Anmeldung, Live-Updates, Navigation und direktes Neuladen ohne Fehler bei der Pfadübersetzung funktionieren. Ein FEHLSCHLAG, der sich auf Sockets oder Weiterleitungen beschränkt, lässt das Unterpfad-Design weiterhin durchfallen. Die Korrektur einer einzelnen Proxy-Direktive beweist nicht, dass Callbacks und zukünftige Routen präfixfähig sein werden.
Wähle einen eigenen Hostnamen als stabile Grenze
Stelle Home Assistant am Root eines eigenen Hostnamens wie ha.example.com bereit und leite diesen Hostnamen dann über den Reverse-Proxy an den internen Dienst weiter. So bleibt eine einzige öffentliche Origin erhalten, ohne dass die Anwendung ein Pfadpräfix verstehen muss. Ein privates VPN oder ein Tunnel kann dieselbe klare Root-Grenze ohne öffentliche Freigabe bieten.
Wenn ein bestehender Fernzugriff nach Netzwerkänderungen ausfällt, prüfe DNS, öffentliche Adresse, NAT, Tunnel und Proxy-Routing unabhängig voneinander. Die Diagnose von ZimaSpace zu Fernzugriff nach einer Routeränderung bietet eine entsprechende Prüfung dieses angrenzenden Pfads.
Die Alternative ist erfolgreich, wenn ein sauberer Browser Assets laden, eine WebSocket-Verbindung herstellen, sich authentifizieren, verschachtelte Routen neu laden und Home Assistant nach einem Proxy-Neustart erreichen kann. Lass die alte Route nur so lange verfügbar, wie es für ein Rollback von DNS- oder Proxy-Änderungen nötig ist; betreibe nicht auf unbestimmte Zeit zwei mehrdeutige öffentliche URLs.
Beende den Test erst, wenn die vollständige Sitzung einen Neustart übersteht.
Starte den Proxy und Home Assistant jeweils einmal neu und wiederhole dann den vollständigen Test im LAN und über das vorgesehene externe Netzwerk. Prüfe den Zertifikatsnamen, die weitergeleitete Client-Adresse, die Grenze vertrauenswürdiger Proxys, die Anmeldung, den Live-Status, die Abmeldung und einen Integrations-Callback. Das ist der ursprüngliche Testumfang, keine reduzierte Prüfung einer statischen Seite.
Erkläre das Design mit Root-Hostname nur dann für erfolgreich, wenn es jeden Schritt besteht. Ein Unterpfad, der erst nach benutzerdefiniertem Umschreiben von Antworten funktioniert, bleibt eine nicht unterstützte technische Altlast, da ein Update das Verhalten von Assets oder Callbacks ändern kann. Dokumentiere den bewährten Hostnamen, die Upstream-Adresse und die Rollback-Konfiguration.
Wechsle zu einer anderen Lösung, wenn das Design mit Root-Hostname weiterhin scheitert, denn die verbleibende Ursache liegt wahrscheinlich bei Proxy-Vertrauen, WebSocket-Weiterleitung, DNS, Zertifikat oder Routing und nicht bei der Unterstützung von Basispfaden. Lege Home Assistant nicht direkt über einen ungeschützten Port offen, nur um die gewünschte URL-Struktur beizubehalten.
Support und Tipps
Mehr zum Lesen

So halten Sie Erwachsenenvideos auf Ihrem NAS vor Familienmitgliedern verborgen
Bewahre Videos für Erwachsene auf einem Familien-NAS privat auf. Prüfe Ordnerberechtigungen, den Bibliothekszugriff in Plex und Jellyfin, Vorschaubilder, den Wiedergabeverlauf, gemeinsam genutzte TV-Logins und...

Was vor dem Laden eines Community-Modells in Transformers zu beachten ist
Nutze das Transformers-Jinja-Sandbox-Update, um die Herkunft des Modells, Chat-Vorlagen, Remote-Code, serialisierte Gewichte und isolierte erste Ausführungen zu überprüfen.

Mirage lokal ausführen: OCR und Objekterkennung aus einem einzigen Bild
Testen Sie das kleine lokale Vision-Modell von Cactus Compute, überprüfen Sie die OCR- und Objektextraktion anhand realer Eingaben und verstehen Sie die Grenzen in...



