Home Assistant kan achter een reverseproxy draaien, maar het betrouwbaar aanbieden ervan vanuit een herschreven subpad valt over het algemeen buiten de ondersteunde implementatiemogelijkheden.
Een pagina op example.com/homeassistant kan HTML weergeven, terwijl latere verzoeken nog steeds verwijzen naar root-relatieve bronnen, verificatieroutes, WebSockets of integratiecallbacks. Test meer dan alleen het eerste scherm: gebruik een nieuwe browser, meld je aan, open een live dashboard, laad een geneste route opnieuw en voltooi een callback. Als een laag de prefix laat vallen, verplaats Home Assistant dan naar een eigen hostnaam in plaats van meer herschrijfregels toe te voegen.
Maak onderscheid tussen ondersteuning voor reverseproxy's en ondersteuning voor subpaden
Een reverseproxy kan TLS beรซindigen en een verzoek aan de root van een hostnaam doorsturen naar Home Assistant. Een subpad stelt een andere eis: elke gegenereerde URL, bron, API-aanroep, WebSocket, omleiding en callback moet consequent een prefix behouden die de toepassing begrijpt. Succes op de proxyniveau garandeert niet dat aan die toepassingsvoorwaarde wordt voldaan.
Tests door de Home Assistant-community leiden tot het directe oordeel dat de toepassing geen implementatie onder een URL-prefix ondersteunt. Het antwoord op de vraag of je Home Assistant in een subpad kunt plaatsen, beveelt een subdomein aan, ongeacht de keuze van de proxy.
PASS voor ondersteuning van reverseproxy's betekent dat Home Assistant aan de root van een eigen hostnaam werkt met de juiste doorgifte. FAIL voor het voorgestelde subpad betekent dat een of meer toepassingsroutes de prefix kwijtraken. Combineer die oordelen niet tot de bewering dat reverseproxy's zelf incompatibel zijn.
Gebruik frontendbronnen als eerste test met laag risico
Open het voorgestelde subpad in een privรฉbrowserprofiel en controleer de netwerkverzoeken voordat je Home Assistant wijzigt. Als het basisdocument wordt geladen, maar JavaScript, pictogrammen, manifesten of vertalingen paden opvragen vanaf de root van de hostnaam, is de topologie al gezakt voor de eerste omkeerbare onderscheidende test.
Bij een gedocumenteerde poging om paden te herschrijven, werd de hoofdpagina weergegeven, terwijl frontendbronnen URL's met een schuine streep aan het begin opvroegen zonder de Home Assistant-prefix. Die fout met root-relatieve bronnen is een mismatch in het toepassingspad, geen ontbrekend bestand op de proxy.
PASS betekent dat elke frontendbron onder de beoogde route succesvol wordt opgehaald. FAIL betekent dat er 404-reacties of verzoeken aan het rootpad verschijnen. Stop dan en test een eigen hostnaam; het vervangen van tekst in de reactie-inhoud is kwetsbaar, omdat toekomstige frontendbuilds nieuwe paden kunnen introduceren die niet door de herschrijfregel worden afgedekt.
WebSockets, verificatie en geneste routes testen
Een statische dashboardschil is geen volledige sessie. Meld je aan vanuit een schoon browserprofiel, bekijk enkele minuten lang hoe entiteiten worden bijgewerkt, vernieuw een geneste dashboard-URL, meld je af en meld je opnieuw aan. Controleer vervolgens of HTTP-upgrades, tokens, omleidingen en het opnieuw laden van routes dezelfde openbare oorsprong en hetzelfde pad behouden.
Home Assistant is sterk afhankelijk van WebSockets voor live communicatie met de frontend, dus een proxy moet de upgradeprocedure en headers behouden. Een verslag van een beheerder over WebSocket-afhandeling door reverse proxies laat zien waarom alleen HTML laden geen voldoende compatibiliteitstest is.
PASS betekent dat authenticatie, live updates, navigatie en rechtstreeks opnieuw laden allemaal werken zonder fouten bij padvertaling. FAIL die beperkt blijft tot sockets of omleidingen wijst er nog steeds op dat het subpadontwerp niet geschikt is. Eรฉn proxyrichtlijn aanpassen bewijst niet dat callbacks en toekomstige routes het voorvoegsel zullen ondersteunen.
Kies een speciale hostnaam als stabiele grens
Publiceer Home Assistant op de root van een speciale hostnaam, zoals ha.example.com, en routeer die hostnaam vervolgens via de reverse proxy naar de interne service. Zo behoud je รฉรฉn openbare origin zonder dat de toepassing een padvoorvoegsel hoeft te begrijpen. Een privรฉnetwerk-VPN of tunnel biedt dezelfde duidelijke rootgrens zonder openbare blootstelling.
Controleer bij een bestaande externe verbinding die na netwerkwijzigingen uitvalt afzonderlijk DNS, het openbare adres, NAT, de tunnel en de proxyroutering. De ZimaSpace-diagnose voor externe toegang na een routerwijziging biedt die aanvullende controle.
Het alternatief slaagt wanneer een schone browser assets kan laden, een WebSocket-verbinding tot stand kan brengen, kan authenticeren, geneste routes kan vernieuwen en Home Assistant kan bereiken na een herstart van de proxy. Houd de oude route alleen beschikbaar zolang als nodig is om DNS- of proxywijzigingen terug te draaien; gebruik niet voor onbepaalde tijd twee onduidelijke openbare URL's.
Stop wanneer de volledige sessie een herstart doorstaat
Herstart de proxy en Home Assistant รฉรฉn keer en herhaal daarna de volledige test vanaf het LAN en het beoogde externe netwerk. Controleer de certificaatnaam, het doorgestuurde clientadres, de grens van de vertrouwde proxy, het inloggen, de live status, het uitloggen en รฉรฉn integratiecallback. Dit is de oorspronkelijke werklast, geen beperkte test van alleen een statische pagina.
Verklaar het ontwerp met de root-hostnaam alleen geslaagd als het elke stap doorstaat. Een subpad dat alleen werkt na aangepaste herschrijving van reacties blijft niet-ondersteunde technische schuld, omdat een update het gedrag van assets of callbacks kan veranderen. Leg de bekende werkende hostnaam, het upstreamadres en de terugdraaiconfiguratie vast.
Schaal op wanneer het ontwerp met de root-hostnaam nog steeds niet werkt, want de resterende oorzaak is waarschijnlijk proxyvertrouwen, WebSocket-doorsturing, DNS, certificaten of routering, en niet ondersteuning voor basispaden. Stel Home Assistant niet rechtstreeks bloot via een onbeveiligde poort, alleen om de gewenste URL-structuur te behouden.
Ondersteuning en tips
Meer om te lezen

Zo houd je pornofilms op je NAS verborgen voor gezinsleden
Houd video's voor volwassenen privรฉ op een NAS voor het hele gezin. Controleer mapmachtigingen, toegang tot Plex- en Jellyfin-bibliotheken, miniaturen, kijkgeschiedenis, gedeelde tv-aanmeldingen en...

Wat je moet controleren voordat je een communitymodel in Transformers laadt
Gebruik de Transformers Jinja-sandboxupdate om de herkomst van modellen, chatsjablonen, externe code, geserialiseerde gewichten en geรฏsoleerde eerste uitvoeringen te controleren.

Voer Mirage lokaal uit: OCR en objectdetectie vanuit รฉรฉn afbeelding
Probeer het kleine lokale visiemodel van Cactus Compute, test OCR en objectextractie met echte invoer en krijg inzicht in de beperkingen op het gebied...



