Kan Home Assistant fungera bakom en omvänd proxy på en underkatalog?

Eva Wong är teknisk skribent och händig hemmabyggare på ZimaSpace. Som tekniknörd sedan barnsben med ett brinnande intresse för hemlabb och programvara med öppen källkodspecialiserar hon sig på att göra komplexa tekniska koncept begripliga genom praktiska, praktiska guider. Eva tycker att självhosting ska vara roligt, inte avskräckande. Genom sina handledningar hjälper hon communityn att göra hårdvaruinstallationer mindre mystiska, från att bygga sin första NAS till att bemästra Docker-containrar.

Home Assistant kan köras bakom en omvänd proxy, men att på ett tillförlitligt sätt leverera tjänsten från en omskriven undersökväg är i allmänhet inte en stödd driftsättningslösning.

En sida på example.com/homeassistant kan returnera HTML, medan senare förfrågningar fortfarande riktas mot rotrelativa resurser, autentiseringsrutter, WebSockets eller återanrop från integrationer. Testa mer än den första skärmen: använd en ny webbläsarprofil, logga in, öppna en dashboard med liveuppdateringar, läs in en nästlad rutt på nytt och slutför ett återanrop. Om något lager tappar prefixet ska du flytta Home Assistant till ett eget värdnamn i stället för att lägga till fler omskrivningar.

Skilj mellan stöd för omvänd proxy och stöd för undersökväg

En omvänd proxy kan terminera TLS och vidarebefordra en förfrågan till Home Assistant från värdnamnets rot. En undersökväg innebär ett annat krav: varje genererad URL, resurs, API-anrop, WebSocket, omdirigering och återanrop måste konsekvent bevara ett prefix som programmet förstår. Att det fungerar på proxylagret innebär inte att programmets krav är uppfyllda.

Tester från Home Assistant-communityn ger ett tydligt besked: programmet stöder inte driftsättning under ett URL-prefix. Det fastslagna svaret på frågan om att lägga Home Assistant i en undersökväg är att använda en underdomän, oavsett val av proxy.

GODKÄNT för stöd av omvänd proxy betyder att Home Assistant fungerar i roten på ett dedikerat värdnamn med korrekt vidarebefordran. UNDERKÄNT för den föreslagna undersökvägen betyder att ett eller flera av programmets rutter tappar prefixet. Blanda inte ihop dessa bedömningar och dra slutsatsen att omvända proxyservrar i sig är inkompatibla.

Använd frontendresurser som första test med låg risk

Öppna den föreslagna undersökvägen i en privat webbläsarprofil och granska nätverksförfrågningarna innan du ändrar Home Assistant. Om grunddokumentet läses in men JavaScript, ikoner, manifest eller översättningar begärs från värdnamnets rotsökväg, har topologin redan fallerat i sitt första test som går att återställa.

Ett dokumenterat försök med sökvägsomskrivning returnerade huvudsidan medan frontendresurser begärde snedstrecksinledda URL:er utan Home Assistant-prefixet. Det här felet med rotrelativa resurser beror på att programmets sökväg inte stämmer, inte på att en fil saknas på proxyn.

GODKÄNT betyder att alla frontendresurser hämtas utan fel via den avsedda rutten. UNDERKÄNT betyder att 404-svar eller förfrågningar till rotsökvägen förekommer. Avbryt där och testa ett dedikerat värdnamn. Ersättning i svarsinnehåll är bräcklig, eftersom framtida frontendbyggen kan introducera nya sökvägar som omskrivningen inte täcker.

Testa WebSockets, autentisering och nästlade rutter

Ett statiskt dashboardskal är inte en fullständig session. Logga in från en ren profil, följ entitetsuppdateringar i flera minuter, uppdatera en nästlad dashboard-URL, logga ut och logga in igen. Kontrollera sedan om HTTP-uppgraderingar, token, omdirigeringar och omladdningar av rutter behåller samma publika ursprung och sökväg.

Home Assistant förlitar sig i hög grad på WebSockets för livekommunikation med gränssnittet, så en proxy måste bevara uppgraderingsvägen och rubrikerna. En användares berättelse om hantering av WebSocket via omvänd proxy visar varför det inte räcker att bara läsa in HTML för att testa kompatibiliteten.

GODKÄNT innebär att autentisering, liveuppdateringar, navigering och direkt omladdning fungerar utan fel vid sökvägsöversättning. Ett FEL som begränsas till sockets eller omdirigeringar innebär fortfarande att underkatalogslösningen underkänns. Att åtgärda ett enda proxydirektiv bevisar inte att återanrop och framtida rutter kommer att stödja prefix.

Välj ett eget värdnamn som en stabil gräns

Publicera Home Assistant vid roten av ett eget värdnamn, till exempel ha.example.com, och dirigera sedan det värdnamnet genom omvänd proxy till den interna tjänsten. Det ger ett enda offentligt ursprung utan att programmet behöver förstå ett sökvägsprefix. Ett privat VPN eller en tunnel kan ge samma tydliga rotgräns utan offentlig exponering.

När en befintlig fjärranslutning slutar fungera efter nätverksändringar ska du kontrollera DNS, den offentliga adressen, NAT, tunneln och proxyroutningen var för sig. ZimaSpaces diagnostik för fjärråtkomst efter en routerändring ger en kontroll av den närliggande anslutningsvägen.

Alternativet är godkänt när en ren webbläsare kan läsa in resurser, upprätta en WebSocket-anslutning, autentisera, uppdatera kapslade rutter och nå Home Assistant efter att proxyn startats om. Behåll den gamla rutten tillgänglig endast så länge det behövs för att återställa DNS- eller proxyändringar. Kör inte två tvetydiga offentliga URL:er på obestämd tid.

Stoppa när hela sessionen fungerar efter en omstart

Starta om proxyn och Home Assistant en gång och upprepa sedan hela testet från det lokala nätverket och det avsedda fjärrnätverket. Bekräfta certifikatnamnet, den vidarebefordrade klientadressen, gränsen för betrodda proxyservrar, inloggning, liveuppdateringar, utloggning och ett integrationsåteranrop. Det här är det ursprungliga arbetsflödet, inte ett förenklat test av en statisk sida.

Förklara lösningen som godkänd endast om root-värdnamnslösningen klarar varje steg. En underkatalog som fungerar först efter anpassad omskrivning av svar innebär fortfarande osupporterad teknisk skuld, eftersom en uppdatering kan ändra beteendet för resurser eller återanrop. Dokumentera det fungerande värdnamnet, uppströmsadressen och återställningskonfigurationen.

Byt till en root-värdnamnslösning om den fortfarande inte fungerar, eftersom den återstående orsaken sannolikt är proxytillit, WebSocket-vidarebefordran, DNS, certifikat eller routning snarare än stöd för baskataloger. Exponera inte Home Assistant direkt på en oskyddad port bara för att behålla den önskade URL-strukturen.

Support och tips

Mer att läsa

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.