Dlaczego Home Assistant traci dostęp do trwałych danych po ponownym utworzeniu stosu?

Eva Wong jest redaktorką techniczną i rezydentką majsterkowania w ZimaSpace. Jest geekiem od zawsze, z pasją do domowych laboratoriów i oprogramowania open source, a jej specjalnością jest przekładanie złożonych zagadnień technicznych na przystępne, praktyczne poradniki. Eva wierzy, że samodzielne hostowanie powinno sprawiać radość, a nie onieśmielać. Dzięki swoim samouczkom pomaga społeczności oswoić konfigurację sprzętu, od budowy pierwszego serwera NAS po opanowanie kontenerów Docker.

Ponowne utworzenie stosu Home Assistant w Dockerze lub Compose nie powinno usuwać konfiguracji, jeśli ponownie zamontowane są te same trwałe dane /config. Gdy po ponownym utworzeniu pojawia się konfiguracja początkowa lub brakuje integracji, w pierwszej kolejności załóż, że nowy kontener widzi inny magazyn danych, a nie że Home Assistant usunął dane dotyczące domu.

Przed przywróceniem starszej kopii zapasowej sprawdź efektywne montowanie, ścieżkę na hoście, wolumin nazwany, ukryte pliki i uprawnienia. Niewłaściwy pusty katalog może wyglądać dokładnie tak, jakby konfiguracja zniknęła, choć oryginalne dane nadal są nienaruszone gdzie indziej na hoście.

Sprawdź, co faktycznie jest zamontowane w /config

Sprawdź działający kontener i potwierdź źródło montowania przypisane do /config. Porównaj je ze starym plikiem Compose lub zapisem wdrożenia, zamiast polegać na znajomo brzmiącej nazwie katalogu.

Montowania wiązane Dockera zastępują widok katalogu docelowego w kontenerze, a aktualna dokumentacja montowań wiązanych wskazuje, że zamontowanie katalogu hosta w niepustej ścieżce kontenera zasłania znajdujące się tam wcześniej pliki. Dlatego pusta lub niewłaściwa ścieżka źródłowa sprawia, że Home Assistant widzi pusty katalog /config.

Nie uruchamiaj konfiguracji początkowej ani nie zaczynaj tworzyć nowych integracji, dopóki nie potwierdzisz montowania. Nowe zapisy do niewłaściwego katalogu jeszcze bardziej utrudnią późniejsze odzyskiwanie danych.

Odróżnij montowania wiązane od woluminów nazwanych

Stos Compose może używać jawnej ścieżki na hoście lub zarządzanego przez Dockera woluminu nazwanego. Ponowne utworzenie projektu pod inną nazwą, z inną nazwą woluminu lub ścieżką może utworzyć nowy, pusty trwały magazyn danych, podczas gdy stary wolumin nadal istnieje.

Aktualny poradnik dotyczący woluminów Dockera wyjaśnia, że woluminy nazwane przechowują dane niezależnie od poszczególnych kontenerów i można je ponownie dołączyć po zastąpieniu kontenera. Usunięcie kontenera to zatem co innego niż usunięcie lub zastąpienie jego trwałego magazynu danych.

Wyświetl stare i nowe woluminy, sprawdź ich punkty montowania przez Dockera oraz porównaj daty utworzenia i zawartość. Nie używaj poleceń prune, dopóki nie ustalisz, który wolumin zawiera właściwy stan Home Assistant.

Ukryte pliki mogą sprawić, że kopia wygląda na kompletną, choć taka nie jest

Home Assistant przechowuje ważne dane stanu zarządzane z poziomu interfejsu w ukrytych ścieżkach, takich jak .storage. Kopiowanie z użyciem powłoki i wzorca, takiego jak *, albo menedżera plików ukrywającego pliki ukryte może przenieść pliki YAML, pomijając po cichu kluczowe dane rejestru i integracji.

Przypadek migracji z Dockera na Compose z 2025 roku potwierdził dokładnie ten problem z granicą: operacja kopiowania pominęła ukryte dane Home Assistant lub nie obsłużyła ich prawidłowo, a migracja ustabilizowała się dopiero po poprawnym skopiowaniu całego drzewa konfiguracji i metadanych.

Porównaj listy katalogów uwzględniające ukryte pliki i sprawdź właściciela, znaczniki czasu oraz obecność oczekiwanych ukrytych katalogów, zanim uznasz, że same dane są uszkodzone.

Sprawdź uprawnienia przed ponownym skopiowaniem danych

Nawet prawidłowy katalog może wydawać się niedostępny, jeśli odtworzony kontener nie ma uprawnień do odczytu lub zapisu. Często dzieje się tak po przeniesieniu danych do nowego systemu plików, zmianie trybu Dockera, przywróceniu danych z innego hosta lub zmianie mapowań UID/GID.

Zweryfikowany w 2026 roku poradnik rozwiązywania problemów z Docker Engine wskazuje, że przyczyną takich awarii są rzeczywista ścieżka na hoście, UID/GID kontenera, dostęp do katalogu nadrzędnego, tryb montowania i ograniczenia bezpieczeństwa. Montowanie tylko do odczytu lub niezgodność właściciela mogą uniemożliwić Home Assistant aktualizowanie stanu, nawet jeśli pliki są widoczne.

Napraw problem z uprawnieniami właściciela lub punktem montowania, zamiast nadawać wszystkim użytkownikom uprawnienia do zapisu w całym drzewie konfiguracji.

Odtwórz stos dopiero po potwierdzeniu prawidłowej ścieżki trwałych danych

Użyj dokładnie tej sprawdzonej definicji Compose, tagu obrazu, trybu sieci, urządzeń i źródła /config. Uruchom Home Assistant i sprawdź, czy przywrócono oczekiwanych użytkowników, pulpity, integracje, automatyzacje i elementy pomocnicze, zanim zezwolisz na migracje lub wprowadzisz nowe zmiany w konfiguracji.

Procedura odzyskiwania pojedynczego kontenera w ZimaSpace opiera się na tej samej zasadzie: sprawdź efektywne punkty montowania i ponownie podłącz sprawne zależności, zanim odtworzysz lub wymienisz niepowiązane elementy stosu.

Jeśli rzeczywiście brakuje wiarygodnych danych, przejdź do odtwarzania z kopii zapasowej. Jeśli dane są dostępne, ale nowy kontener nie może ich odczytać ani modyfikować, problem dotyczy mapowania pamięci masowej lub uprawnień, a nie samej konfiguracji Home Assistant.

Wsparcie i porady

Więcej do przeczytania

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.