Przebuduj Home Assistant tylko wtedy, gdy bieżący trwały stan nie jest już wiarygodnym źródłem odzyskiwania, a sprawdzona kopia zapasowa nie pozwala przywrócić instalacji do działania. Większość awarii należy najpierw sklasyfikować jako problemy z działaniem, integracją, konfiguracją, bazą danych, pamięcią masową lub siecią i naprawić na możliwie najniższej warstwie.
Reinstalacja nie jest automatycznie przebudową. Zastąpienie obrazu kontenera może pozostawić /config bez zmian, podczas gdy prawdziwa przebudowa tworzy nowy stan aplikacji i wymaga przywrócenia lub ponownego utworzenia integracji, urządzeń, pulpitów, pomocników i automatyzacji. Podejmuj tę decyzję na podstawie stanu danych, a nie frustracji związanej z bieżącym objawem.
Stosuj trzy różne działania: naprawę, przywracanie i przebudowę
Naprawa zachowuje bieżącą konfigurację i usuwa usterkę konkretnego komponentu. Przywracanie zastępuje uszkodzony lub niezgodny stan sprawdzoną kopią zapasową. Przebudowa rozpoczyna się od czystej instalacji Home Assistant, a następnie importujesz lub odtwarzasz tylko te elementy stanu, którym świadomie ufasz.
To rozróżnienie zapobiega przekształceniu problemu z kontenerem lub pakietem w niepotrzebną utratę danych. Jeśli bieżący użytkownicy, obszary, urządzenia i automatyzacje są nadal dostępne, świeża instalacja może zniszczyć więcej sprawdzonych informacji, niż naprawić.
Zapisz, które z tych trzech działań wykonujesz, zanim zmienisz pliki. Ta prosta etykieta utrudnia przypadkowe przejście od naprawy do destrukcyjnego resetu.
Najpierw naprawiaj, gdy trwały stan jest nadal spójny
Naprawa jest właściwa, gdy Home Assistant otwiera oczekiwaną instancję, katalog konfiguracji jest wypełniony, a błąd można powiązać z konkretną integracją, zmianą YAML, niestandardowym komponentem, plikiem bazy danych, punktem montowania lub ustawieniem środowiska uruchomieniowego.
Tryb bezpieczny i tryb odzyskiwania istnieją właśnie dlatego, że wiele problemów z uruchamianiem można zawęzić bez porzucania konfiguracji. Aktualny poradnik odzyskiwania zaleca odczytanie dokładnego błędu uruchamiania, użycie trybu bezpiecznego do odizolowania niestandardowego kodu oraz trybu odzyskiwania jako minimalnej ścieżki naprawy przed przebudową.
Wyłącz lub zaktualizuj jedną niestandardową integrację, popraw jeden nieprawidłowy wpis konfiguracji, napraw ścieżkę pamięci masowej albo wycofaj wersję środowiska uruchomieniowego, a następnie ponownie przetestuj system. Nie resetuj całej instalacji, dopóki usterka pozostaje ograniczona do konkretnego obszaru.
Naprawiaj bazę danych tylko wtedy, gdy warto zachować historię
Uszkodzenie bazy danych Recorder może wyglądać poważnie, ponieważ dzienniki zapełniają się błędami bazy danych, ale baza Recorder nie jest tym samym co pełna konfiguracja Home Assistant. Jeśli bieżąca konfiguracja i integracje są nienaruszone, nowa baza historii może być czasem mniej ryzykowna niż pełna przebudowa aplikacji.
Gdy historia jest cenna, praktyczny poradnik odzyskiwania pokazuje, jak zatrzymać Home Assistant i użyć narzędzi odzyskiwania SQLite, aby odtworzyć uszkodzoną bazę danych Home Assistant w nowym pliku.
Pracuj wyłącznie na kopiach, zachowaj oryginalną uszkodzoną bazę danych i zaakceptuj możliwość częściowego odzyskania danych. Nieudana naprawa historii nie powinna stać się powodem do odrzucenia sprawnych automatyzacji i integracji.
Przywracaj, gdy sprawdzona kopia zapasowa jest bezpieczniejsza niż dalsza naprawa
Przywróć system, gdy awaria rozpoczęła się po możliwej do wskazania aktualizacji lub edycji i masz przetestowaną kopię zapasową sprzed tej zmiany. Często jest to szybsze i bezpieczniejsze niż ręczne cofanie dziesiątek zmigrowanych lub częściowo zmienionych plików.
Od dawna używany poradnik Home Assistant dotyczący przywracania zaleca najpierw usunąć przyczynę awarii, a następnie przywrócić kopię zapasową skopiowaną poza uszkodzony system. Przywracanie bez usunięcia wadliwego zasilacza, problemu z dyskiem, nieprawidłowego punktu montowania lub niezgodnego środowiska uruchomieniowego po prostu odtworzy tę samą awarię.
Zachowaj uszkodzony stan do czasu pomyślnego przejścia testów przez przywrócony system. Może on zawierać niedawno dodane automatyzacje, sekrety lub zmiany konfiguracji, które trzeba porównać albo selektywnie odzyskać.
Przebuduj system, gdy stan i dane potrzebne do odzyskania nie są już wiarygodne
Czysta przebudowa staje się uzasadniona, gdy brakuje katalogu konfiguracji lub jest on znacznie uszkodzony, wiele kopii zapasowych nie przechodzi testów przywracania, definicja środowiska uruchomieniowego jest nieznana albo powtarzające się naprawy pozostawiły instalację w nieudokumentowanym stanie, którego nie można odtworzyć.
Przebudowa może być również lepszym rozwiązaniem przy przechodzeniu od źle zaprojektowanego wdrożenia — na przykład gdy ważna konfiguracja jest uwięziona wewnątrz nietrwałego kontenera — pod warunkiem że wcześniej wyeksportujesz wszystkie możliwe do zaufania elementy stanu.
Lokalny poradnik automatyzacji ZimaSpace podkreśla możliwość odzyskiwania jako podstawowy wymóg platformy inteligentnego domu. Przebudowa jest udana tylko wtedy, gdy nowa instalacja jest łatwiejsza do tworzenia kopii zapasowych, przywracania i obsługi niż porzucony stan.
Przed usunięciem starego stanu skorzystaj z tabeli decyzyjnej
| Warunek | Zalecane działanie |
|---|---|
| Pojedynczy błąd integracji lub konfiguracji | Naprawa |
| Nieudana aktualizacja środowiska uruchomieniowego/obrazu, konfiguracja nienaruszona | Naprawa lub wycofanie wersji środowiska uruchomieniowego |
| Uszkodzona baza danych, konfiguracja sprawna | Naprawa lub wymiana bazy danych |
| Sprawdzona kopia zapasowa pochodzi sprzed rozległego uszkodzenia | Przywracanie |
| Konfiguracji i kopiom zapasowym nie można ufać ani ich odtworzyć | Przebudowa |
Nie usuwaj starej konfiguracji, bazy danych ani zestawu kopii zapasowych, dopóki wybrana ścieżka nie przetrwa ponownego uruchomienia i jednego normalnego cyklu korzystania z systemu w domu.
Najczęściej zadawane pytania
Czy ponowna instalacja kontenera Home Assistant oznacza przebudowę?
Nie. Jeśli zastępczy kontener ponownie podłączy ten sam trwały katalog /config, wymieniasz środowisko uruchomieniowe, zachowując ten sam stan instalacji. Przebudowa rozpoczyna się od nowego stanu lub świadomego porzucenia starego.
Czy powinienem przebudować Home Assistant, ponieważ baza danych Recorder jest uszkodzona?
Zwykle nie. Historię Recorder można naprawić, przywrócić lub zastąpić niezależnie od pozostałej części Home Assistant. Przebuduj całą instalację tylko wtedy, gdy konfiguracja i stan potrzebny do odzyskania — a nie sama historia — nie są już wiarygodne.
Wsparcie i wskazówki
Więcej do przeczytania

Czy podczas tworzenia kopii zapasowej Home Assistant Live należy zatrzymać usługę?
Wbudowane kopie zapasowe Home Assistant mogą działać na żywo; zwykłe kopie systemu plików powinny zatrzymać Home Assistant lub wstrzymać jego działanie, chyba że baza...

Dlaczego serwer Home Assistant nagrzewa się lub hałasuje w czasie bezczynności?
Zanim zmienisz ustawienia chłodzenia lub limity procesora, skoreluj skoki obciążenia wentylatora lub temperatury w Home Assistant z działaniem Rejestratora, kopiami zapasowymi, integracjami i współdzielonymi...

Ile wolnego miejsca na dane powinien zachować Home Assistant na potrzeby zadań w tle?
Rozmiar wolnego miejsca dla Home Assistant należy określać na podstawie bazy danych Rejestratora, przyrostu kopii zapasowych, szczytowego obciążenia podczas konserwacji i operacji odzyskiwania, a...

