Jak zapobiec utracie konfiguracji Home Assistant podczas aktualizacji

Eva Wong

IceWhale author

Eva Wong jest Technicznym pisarzem i stałym majsterkowiczem w ZimaSpace. Całe życie geek z pasją do homelabów i oprogramowania open-source, specjalizuje się w tłumaczeniu skomplikowanych koncepcji technicznych na przystępne, praktyczne przewodniki. Eva wierzy, że samodzielne hostowanie powinno być zabawą, a nie czymś onieśmielającym. Poprzez swoje samouczki umożliwia społeczności rozwiewanie tajemnic konfiguracji sprzętu, od budowy pierwszego NAS po opanowanie kontenerów Docker.

How to Prevent Home Assistant Configuration Loss During Upgrades - Zima Store Online

Zapobiegaj utracie konfiguracji Home Assistant, traktując wbudowany system kopii zapasowych jako główną ścieżkę odzyskiwania, a środowisko uruchomieniowe jako wymienne. Wersja Home Assistant, obraz kontenera lub host mogą się zmienić, ale kopia zapasowa, klucz szyfrowania, definicja środowiska uruchomieniowego i wszystkie zewnętrzne zależności muszą pozostać dostępne, gdy oryginalne urządzenie przestanie działać.

Nowoczesne kopie zapasowe Home Assistant działają we wszystkich typach instalacji, w tym w kontenerach. Osobna ręczna kopia drzewa konfiguracji może być przydatna, ale nie opieraj całego planu aktualizacji na ręcznym kopiowaniu plików przy jednoczesnym pomijaniu obsługiwanego procesu tworzenia kopii i przywracania.

Zacznij od wbudowanej kopii zapasowej, a nie ręcznie skopiowanego folderu YAML

Nie sprowadzaj „konfiguracji” do pliku configuration.yaml. Obsługiwany system kopii zapasowych Home Assistant przechwytuje stan aplikacji wymagany do odzyskiwania, w tym konfigurację i zawartość bazy danych, a nowsze procesy tworzenia kopii obsługują także automatyzację, przechowywanie oraz lokalizacje poza hostem.

Modernizacja systemu kopii zapasowych wprowadzona w 2025 roku dodała automatyczne szyfrowane kopie zapasowe, mechanizmy przechowywania oraz zewnętrzne lokalizacje kopii zapasowych. Dzięki temu wbudowana kopia zapasowa jest pierwszym zasobem odzyskiwania, który należy zweryfikować przed aktualizacją, zamiast polegać na niekompletnej kopii ręcznej.

Mimo to zapisz ścieżkę główną konfiguracji, wybraną bazę danych, odwołania do sekretów, niestandardowe komponenty, materiały SSL oraz wszystkie zewnętrzne pliki lub usługi wymagane przez integrację. Kopia zapasowa może przywrócić stan Home Assistant, ale nie udokumentuje automatycznie każdego urządzenia USB, zasobu sieciowego, hosta bazy danych ani parametru kontenera, które mu towarzyszą.

Jawnie określ trwałość kontenera i ustawienia środowiska uruchomieniowego

W przypadku Dockera sprawdź dowiązanie montowania lub wolumin, który przechowuje /config, i zachowaj definicję Compose lub polecenie uruchomieniowe odtwarzające tryb sieci, mapowania urządzeń, strefę czasową, uprawnienia oraz usługi zewnętrzne. Sam system plików kontenera powinien być traktowany jako tymczasowy.

Dyskusja na temat kopii zapasowych Home Assistant w Dockerze wyraźnie pokazuje ten scenariusz awarii: gdy użytkownicy mapują tylko plik zamiast całego katalogu konfiguracji, ważny stan może pozostać uwięziony wewnątrz kontenera i zniknąć po jego zastąpieniu.

Przed aktualizacją sprawdź montowanie na hoście i przechowuj definicję środowiska uruchomieniowego obok kopii zapasowej. Odzyskiwanie przebiega znacznie szybciej, gdy zarówno stan aplikacji, jak i instrukcje potrzebne do udostępnienia modułów radiowych, portów, sieci oraz pamięci masowej są już znane.

Przenieś co najmniej jedną szyfrowaną kopię poza hosta

Kopia zapasowa na tym samym dysku SSD chroni przed niektórymi błędami konfiguracji, ale nie przed utratą hosta, uszkodzeniem systemu plików, kradzieżą ani awarią urządzenia pamięci masowej. Przechowuj co najmniej jedną kopię odzyskiwania na serwerze NAS, innym komputerze lub w zdalnej lokalizacji kopii zapasowych, do której dostęp nie zależy od uszkodzonego hosta Home Assistant.

Przechowuj również klucz szyfrowania kopii zapasowych lub pakiet awaryjny poza Home Assistant. Wersja Home Assistant 2026.4 przeniosła nowe szyfrowane kopie zapasowe do audytowanego formatu SecureTar v3 z silniejszym nowoczesnym szyfrowaniem, co zwiększa bezpieczeństwo kopii, ale sprawia, że przechowywanie klucza staje się wyraźną częścią możliwości odzyskania danych.

Twórz kolejne wersje kopii zamiast nadpisywać ten sam plik. Aktualizacja może ujawnić problem dopiero po kilku dniach, a najnowszy punkt odzyskiwania może już zawierać zmigrowany lub uszkodzony stan, od którego próbujesz uciec.

Featured

ZimaCube 2 Osobisty domowy NAS w chmurze

ZimaCube2

Kopia zapasowa nadal nie zastępuje definicji środowiska uruchomieniowego

Sama konfiguracja może nie przywrócić modułów radiowych USB, sieci hosta, strefy czasowej, przekazywania urządzeń, usług baz danych, MQTT ani zależności z odwrotnym serwerem proxy. Zachowaj plik Compose, zasady wersjonowania obrazów, zmienne środowiskowe, ścieżki hosta, mapowania urządzeń i zależności usług wymagane do odtworzenia środowiska uruchomieniowego.

Nie umieszczaj jawnych sekretów w publicznym repozytorium tylko po to, aby wersjonować plik Compose. Przechowuj wartości sekretów w chronionej lokalizacji i dokumentuj wyłącznie miejsce, z którego proces odzyskiwania je pobiera.

Instrukcja wdrażania Home Assistant na ZimaBoard w ZimaSpace stanowi przydatny kontekst do oddzielenia platformy serwera domowego od stanu aplikacji, który musi przetrwać przyszłe zmiany sposobu wdrażania.

Przeprowadź test przywracania, zanim aktualizacja stanie się sytuacją awaryjną

Kopia zapasowa nie jest sprawdzona tylko dlatego, że archiwum istnieje. Przywróć ją na odizolowanym urządzeniu lub w tymczasowym kontenerze, w miarę możliwości podłącz reprezentatywne urządzenia i ścieżki oraz potwierdź, że system uruchamia się z użytkownikami, panelami, integracjami, automatyzacjami, pomocnikami i oczekiwanym stanem.

Wykorzystaj test do wykrycia brakujących haseł, nieaktualnych ścieżek hosta, nieudokumentowanych mapowań urządzeń i zbyt dużych baz danych, dopóki system produkcyjny nadal działa. Po pomyślnym teście zapisz procedurę przywracania — pamięć nie jest planem odzyskiwania.

Bezpośrednio przed aktualizacją utwórz świeży punkt odzyskiwania, zapisz bieżącą wersję Home Assistant i obrazu kontenera oraz sprawdź zmiany w wydaniu wpływające na używane integracje. Zachowaj poprzednie środowisko uruchomieniowe, dopóki zaktualizowana instancja nie przejdzie zarówno zwykłego okresu użytkowania, jak i ponownego uruchomienia.

Skorzystaj z czteroczęściowej kontroli bezpieczeństwa aktualizacji

Zasób odzyskiwania	Co chroni	Skutek braku
Wbudowana kopia zapasowa	Konfigurację Home Assistant i możliwy do odzyskania stan aplikacji	Brak obsługiwanego punktu przywracania
Klucz szyfrowania / pakiet awaryjny	Dostęp do chronionych kopii zapasowych	Kopia istnieje, ale nie można jej otworzyć
Definicja środowiska uruchomieniowego	Montowania, urządzenia, sieć i środowisko	Prawidłowy stan, ale niedziałający dostęp do usług
Kopia poza hostem + test przywracania	Awarię hosta i poprawność procedury	Odzyskiwanie znika wraz z systemem produkcyjnym lub kończy się niepowodzeniem, gdy jest potrzebne

Aktualizuj system dopiero wtedy, gdy wszystkie cztery elementy są zabezpieczone. Ręczna kopia drzewa konfiguracji może pozostać dodatkową warstwą, ale główny plan odzyskiwania powinien opierać się na obsługiwanej kopii zapasowej, którą można odszyfrować i przywrócić razem z udokumentowanym środowiskiem uruchomieniowym.