Jak przenieść dane Home Assistant bez utraty użytkowników, historii ani ustawień

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.

Przenoś dane Home Assistant, zachowując pełny stan aplikacji i nie modyfikując starej instancji, dopóki jej zamiennik nie przejdzie pełnej weryfikacji.

Użytkownicy i ustawienia to nie tylko widoczne pliki YAML, a historii nie da się odtworzyć przez skopiowanie panelu. Migracja musi zachować katalog konfiguracji Home Assistant lub obsługiwaną kopię zapasową, bazę danych Recorder, jeśli historia jest istotna, ukryte dane, sekrety, komponenty niestandardowe oraz powiązane z danym środowiskiem uruchomieniowym mapowania urządzeń i sieci. Najbezpieczniejsza kolejność to inwentaryzacja, spójne kopiowanie, odizolowane uruchomienie, weryfikacja, a następnie wycofanie źródła z eksploatacji.

Przed przeniesieniem zinwentaryzuj trwałe dane i zależności zewnętrzne

W przypadku instalacji kontenerowej traktuj cały podłączony katalog konfiguracji Home Assistant jako podstawową jednostkę odzyskiwania, zamiast wybierać kilka znanych plików. Ukryte dane w .storage, dane uwierzytelniające, rejestry integracji, panele, automatyzacje i domyślna baza danych Recorder mogą znajdować się w tym katalogu. Zewnętrzne bazy MariaDB, MQTT, bramki Zigbee, magazyny sekretów lub udziały NAS należy wymienić osobno.

Instrukcja migracji kontenera Home Assistant pokazuje, dlaczego przeniesienie całego katalogu konfiguracji jest bezpieczniejsze niż odtwarzanie stanu plik po pliku, i podkreśla, że przed skopiowaniem surowych danych systemu plików należy zatrzymać stary kontener.

Utwórz manifest zawierający ścieżkę źródłową i docelową, identyfikatory właściciela UID/GID, lokalizację bazy danych, urządzenia USB lub szeregowe, tryb sieci, opublikowane porty, usługi zewnętrzne i aktualną wersję Home Assistant. Jeśli jakakolwiek zależność nie jest udokumentowana, nie usuwaj starej instancji. Migracja nie jest gotowa, dopóki nowy host nie będzie w stanie odtworzyć tej zależności na podstawie pisemnych informacji.

Utwórz spójny punkt przywracania przed skopiowaniem danych

Korzystaj z wbudowanej kopii zapasowej lub innej metody uwzględniającej stan aplikacji, jeśli obsługuje ją Twoja instalacja. Jeśli kopiujesz surowe dane kontenera, zatrzymaj Home Assistant przed skopiowaniem aktywnej bazy konfiguracji i powiązanych plików. Zwykłe kopiowanie działającej instancji może przechwycić pliki aplikacji z różnych momentów, co jest przeciwieństwem kontrolowanej migracji.

Przebudowa systemu kopii zapasowych w Home Assistant rozszerzyła obsługę przywracania między różnymi metodami instalacji. Dzięki temu obsługiwana kopia zapasowa stanowi solidną granicę przenośności przy zmianie środowiska uruchomieniowego. Praktyczny wniosek z przywracania kopii zapasowej między instalacjami jest taki, że środowisko uruchomieniowe może się zmienić, a stan aplikacji pozostaje niezmiennym punktem ciągłości.

Zachowaj dwie kopie: nienaruszony punkt odzyskiwania sprzed przeniesienia oraz kopię roboczą używaną podczas migracji. Nie pozwól, by nowa instancja Home Assistant została uruchomiona na jedynej dobrej kopii źródłowej. Jeśli system docelowy przeprowadzi migrację lub zapisze nowy stan rejestru, nadal musisz mieć możliwość czystego powrotu do starej wersji i starego hosta.

Odtwórz osobno mapowania sprzętu i sieci specyficzne dla środowiska uruchomieniowego

Dane aplikacji nie odtwarzają automatycznie ścieżek urządzeń hosta. Koordynatory USB Zigbee lub Z-Wave mogą pojawić się pod inną nazwą urządzenia, dostęp przez Bluetooth może działać inaczej, sieć hosta może zmienić sposób wykrywania, a zewnętrzne bazy danych lub brokery MQTT mogą być dostępne pod innymi adresami. Odtwórz te interfejsy osobno, zanim uznasz niedostępną integrację za utratę danych.

Niezależny poradnik migracji z Container do HAOS pokazuje, że przywrócenie stanu Home Assistant Core nie odtwarza automatycznie usług towarzyszących, takich jak MQTT, Zigbee2MQTT czy Node-RED. Opisana w nim sekwencja migracji z ponownym mapowaniem usług towarzyszących weryfikuje również ciągłość historii Recorder, dostęp do koordynatora USB oraz możliwość powrotu do zatrzymanego, ale nienaruszonego starego stosu.

Uruchom system docelowy w kontrolowanej sieci LAN i unikaj jednoczesnego uruchamiania obu instancji z tymi samymi urządzeniami radiowymi, webhookami, kontami w chmurze lub automatyzacjami, chyba że zostały celowo od siebie odizolowane. Dwie aktywne instancje Home Assistant mogą wykonywać te same działania wielokrotnie lub rywalizować o ten sam koordynator, przez co prawidłowa migracja danych może sprawiać wrażenie nieudanej.

Przed przełączeniem zweryfikuj użytkowników, historię, ustawienia i sterowanie urządzeniami

Zaloguj się na istniejące konto bez uprawnień administratora, potwierdź działanie konta administratora, otwórz wykresy historyczne sprzed przeniesienia, sprawdź integracje, uruchom reprezentatywne automatyzacje i zweryfikuj jedno urządzenie z każdego ważnego protokołu. Następnie uruchom ponownie Home Assistant i zrestartuj host docelowy, aby potwierdzić, że odzyskany stan przetrwa typowe zdarzenia cyklu życia.

Powiązane wyjaśnienie ZimaSpace dotyczące ról danych trwałych w Home Assistant wyznacza użyteczną granicę odzyskiwania: trwałą tożsamość, konfigurację i historię należy traktować inaczej niż pamięć podręczną czy pliki tymczasowe podczas przenoszenia.

Przełącz DNS, proxy lub dostęp zdalny dopiero po pomyślnym przejściu testów lokalnych. Pozostaw stary host wyłączony, ale gotowy do odzyskania danych przez co najmniej jeden cykl normalnego użytkowania. Zrezygnuj z niego dopiero wtedy, gdy użytkownicy, historia, ustawienia, automatyzacje, urządzenia radiowe, usługi zewnętrzne, tworzenie kopii zapasowych i ponowne uruchomienie działają zgodnie z oczekiwaniami; pomyślne pierwsze wczytanie pulpitu nawigacyjnego nie wystarcza, by usunąć możliwość powrotu.

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.