Så förhindrar du att behörigheter förändras i Home Assistants datamappar

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.

Behörighetsförskjutning uppstår när Home Assistant-data fortfarande finns kvar, men processen som nu monterar den ser ett annat ägarskap, andra UID/GID-mappningar, åtkomstlägen eller säkerhetskontext än processen som skapade den. Felet uppstår ofta efter en värdmigrering, återställning, ändring av Docker-läge, NAS-kopiering eller manuell åtgärd med chown/chmod.

Förebygg detta genom att dokumentera den förväntade monteringen och ägarmodellen innan en ändring, bevara metadata vid kopiering och testa både läs- och skrivåtkomst efter återskapandet. Åtgärda inte varje fel med chmod -R 777; det döljer avvikelsen och försvagar återställningsmodellen.

Dokumentera lagringsgränsen innan du ändrar behörigheter

Börja med att ta reda på om /config är en Docker-hanterad volym, en Linux-bindmontering, en nätverksmontering eller en sökväg inuti en virtuell maskin. Rätt strategi för ägarskap beror på vilket lager som faktiskt äger filerna.

Home Assistants aktuella installationsanvisningar för Container konkretiserar detta lagringsavtal: den valda värdmappen monteras på /config med läs- och skrivåtkomst. Dokumentera den exakta källsökvägen, monteringsmålet och åtkomstläget i stället för att bara förlita dig på mappnamnet.

Dokumentera även om Home Assistant körs via vanlig Docker, rootless Docker, ett ommappat användarnamnområde eller en containerhanterare för NAS. De numeriska identiteterna som visas inuti och utanför containern behöver inte vara desamma.

UID- och GID-mappningen kan ändras utan att filerna flyttas

En mapp kan ligga kvar på samma värdsökväg samtidigt som den effektiva användarmappningen ändras bakom kulisserna. Detta är vanligt när man går från rootful till rootless Docker, aktiverar ommappning av användarnamnområden eller återställer data till en värd med andra lokala konton.

Dockers aktuella dokumentation om UID/GID-mappning visar att rotlösa lägen och användarnamnområden översätter containeridentiteter till andra värd-ID:n. En fil som verkar ha rätt ägare på en värd kan därför bli skrivskyddad efter att distributionsmodellen ändras.

Jämför numeriska ägare med ls -ln eller motsvarande verktyg i stället för att bara förlita dig på kontonamn, som kan motsvara andra nummer på den nya värden.

Bevara metadata när du kopierar Home Assistant-data

Ett migreringsverktyg eller en filkopiering via grafiskt gränssnitt kan bevara filinnehållet men inte ägarskap, rättighetsbitar, ACL:er, utökade attribut eller säkerhetsetiketter. Då kan YAML-filerna vara läsbara samtidigt som databaser, dold lagring, certifikat eller kataloger som behövs för skrivningar senare slutar fungera.

Använd en kopieringsmetod som bevarar den metadata som din plattform faktiskt använder. Jämför representativa filer och kataloger från källan och målet efter överföringen, innan du startar Home Assistant.

ZimaSpaces guide om att behandla konton och behörigheter som en återkommande hushållspolicy gäller även här: ägarskap bör vara en genomtänkt del av infrastrukturen, inte en rad engångsfixar.

Single board computer zimaboard2

Använd monteringen med läs- och skrivbehörighet endast där Home Assistant behöver skriva

Home Assistant måste kunna uppdatera sin beständiga konfiguration och databas. En montering som av misstag återskapats som skrivskyddad kan tillåta uppstart och läsning, men orsaka fel vid senare skrivningar, säkerhetskopior, databastransaktioner eller konfigurationsändringar.

Bindmonterade värdsökvägar kan exponeras med läs- och skrivbehörighet eller som skrivskyddade. Dockers guide för fildelning visar att det effektiva monteringsläget avgör om en container kan ändra värdkatalogen. Kontrollera den aktiva monteringen i stället för att anta att Compose-filen tillämpades som avsett.

Gör inte heller orelaterade värdkataloger skrivbara bara för att Home Assistant behöver åtkomst till en konfigurationssökväg. Håll behörighetsgränsen snäv.

Använd ett behörighetsgodkännandetest efter varje återställning eller återskapande

En lyckad uppstart visar bara att en del av filsystemskraven är uppfyllda. Home Assistant kan läsa befintliga filer men senare misslyckas när det behöver skriva till databasen, skapa en säkerhetskopia, uppdatera ett register eller spara en kontrollpanel.

  • Bekräfta att förväntad konfiguration och integrationer läses in.
  • Gör en harmlös ändring via användargränssnittet och kontrollera att den finns kvar efter omstart.
  • Bekräfta att Recorder registrerar en ny tillståndsändring.
  • Skapa en liten säkerhetskopia om installationstypen stöder det.
  • Granska loggarna efter nekad åtkomst, skrivskyddat filsystem eller databasfel vid skrivning.

Om testet misslyckas korrigerar du den specifika ägaren, gruppen, ACL:en, namnrymdsmappningen eller monteringsläget som gäller för sökvägen. Behörighetsavvikelser är åtgärdade när den dokumenterade driftsättningen kan återskapa korrekt åtkomst utan manuella nödkommandon.

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.