Jak bezpiecznie wycofać aktualizację Home Assistant po wydaniu niezgodnej wersji

Przywróć starszą wersję Home Assistant z użyciem punktu odzyskiwania sprzed aktualizacji, zgodnego ze starszą wersją Core; nie zakładaj, że uruchomienie starszego środowiska wykonawczego cofnie nowsze migracje trwałego stanu.

Najbezpieczniejsze przywracanie zaczyna się jeszcze przed pierwszą próbą naprawy: zachowaj nieudaną konfigurację po aktualizacji, ustal ostatnią poprawnie działającą wersję i kopię zapasową oraz zdecyduj, czy problem dotyczy Core, niestandardowej integracji, dodatku czy zewnętrznej bazy danych. Przywracanie jest udane tylko wtedy, gdy poprzednie środowisko wykonawcze potrafi odczytać przywrócony stan, a podstawowe funkcje domu znów działają. Zmiana wersji i wycofanie danych to jedna operacja odzyskiwania, a nie dwa niezależne przyciski.

Zachowaj nieudaną konfigurację przed próbą obniżenia wersji

Nie nadpisuj jedynej kopii konfiguracji po aktualizacji podczas eksperymentów. Zapisz bieżącą konfigurację, logi, numery wersji, lokalizację bazy danych oraz dokładną funkcję, która przestała działać. Ta kopia może zawierać nowe zmiany wprowadzone po ostatniej poprawnej kopii zapasowej oraz dowody potrzebne później do zrozumienia niezgodności.

Regresja przywracania z 2026 roku pokazała, że nawet pozornie pomyślne przywrócenie kopii zapasowej może pozostawić środowisko wykonawcze w niewłaściwej wersji, gdy działanie otaczającego go Supervisor jest wadliwe. Opis dotyczący przywracania kopii zapasowej i wycofywania wersji Core jest dobrym powodem, aby po przywróceniu sprawdzić rzeczywistą wersję zamiast ufać komunikatowi o zakończeniu operacji.

Wstrzymaj wprowadzanie zmian w konfiguracji, dopóki ścieżka odzyskiwania nie będzie znana. Jeśli aktualizacja uszkodziła jeden opcjonalny niestandardowy komponent, a reszta Home Assistant działa stabilnie, wyłączenie tego komponentu może być bezpieczniejsze niż pełne przywracanie. Jeśli Core nie może się uruchomić, baza danych nie ładuje się lub kluczowe automatyzacje są bezużyteczne, przejdź do połączonej procedury odzyskiwania środowiska wykonawczego i stanu.

Wybierz punkt odzyskiwania sprzed niezgodnej wersji

Ustal ostatnią kopię zapasową wykonaną wtedy, gdy starsza wersja Home Assistant działała prawidłowo. Sprawdź jej znacznik czasu w odniesieniu do ważnych zmian w automatyzacjach, użytkownikach, pulpitach lub historii, które możesz utracić. Punkt odzyskiwania jest kompromisem: przywraca zgodność, cofając trwały stan w czasie.

Wskazówka ZimaSpace dotycząca tworzenia migawek danych aplikacji przed aktualizacją jest zapobiegawczą wersją tej samej zasady: wycofanie środowiska wykonawczego przebiega najczyściej, gdy znana poprawna kopia stanu istnieje sprzed chwili, w której nowe oprogramowanie po raz pierwszy zapisze dane produkcyjne.

Jeśli nie ma wiarygodnej kopii zapasowej sprzed aktualizacji, nie twórz jej pozornie, kopiując już zmigrowaną bazę danych i łącząc ją ze starszym obrazem Core. Zachowaj bieżący stan i zbadaj możliwość naprawy przez aktualizację albo kontrolowanej przebudowy. Wycofanie bez zgodnej kopii stanu może przekształcić problem z jedną niezgodną funkcją w awarie rejestratora, historii lub rejestru.

Przywróć środowisko wykonawcze i trwały stan jako zgodną parę

W przypadku Home Assistant OS lub instalacji zarządzanej użyj obsługiwanej ścieżki przywracania, która odtwarza wybrany punkt odzyskiwania, a następnie sprawdź, czy rzeczywiście uruchamia się zamierzona wersja Core. W instalacjach kontenerowych cofnięcie obrazu jest tylko połową operacji, jeśli nowsza wersja zmieniła dane trwałe; przywróć również odpowiadającą jej kopię konfiguracji sprzed aktualizacji.

Problem Home Assistant Core dotyczący obniżenia wersji z 2025.4 do 2025.3 udokumentował awarie Rejestratora, historii i powiązanych integracji, gdy starsze środowisko wykonawcze zetknęło się z nowszą strukturą bazy danych. Odpowiedź opiekuna projektu wyraźnie stwierdza, że wycofanie wymaga przywrócenia kopii zapasowej, a nie wykonywanej w miejscu procedury obniżania wersji bazy danych.

Przywracaj zewnętrzne bazy danych i usługi zależne do zgodnych punktów tylko wtedy, gdy kopia Home Assistant ich nie obejmuje. Nie cofaj bezrefleksyjnie wszystkich kontenerów. MQTT, serwery proxy i moduły radiowe mogą działać prawidłowo i pozostać bez zmian; skoncentruj wycofanie na komponentach, których wersja lub kontrakt stanu rzeczywiście się zmieniły.

Featured

ZimaCube 2 Osobisty domowy NAS w chmurze

ZimaCube2

$799.00 - $2,499.00

Buy Now

Zweryfikuj pierwotną awarię przed ponownym włączeniem automatycznych aktualizacji

Po przywróceniu potwierdź działającą wersję Core, logowanie, Rejestrator i historię, kluczowe integracje, automatyzacje, pulpity oraz jedno urządzenie z każdego krytycznego protokołu. Powtórz działanie, które zawiodło w niezgodnej wersji, i sprawdź, czy teraz działa bez nowych błędów. Następnie uruchom ponownie Home Assistant i raz zrestartuj hosta.

Zachowaj kopię stanu po awarii i notatki dotyczące aktualizacji do czasu przetestowania następnej wersji lub poprawki. Jeśli niezgodność spowodowała niestandardowa integracja, przed kolejną aktualizacją Core sprawdź obsługiwane przez nią wersje. Jeśli samo przywracanie się nie powiedzie, nie przełączaj wielokrotnie wersji przy użyciu tej samej zmiennej bazy danych; wróć do czystego punktu odzyskiwania albo przejdź do przebudowy z wybiórczym przywróceniem danych.

Uznaj operację za udaną, gdy starsza wersja i przywrócony stan pozostają stabilne podczas normalnego użytkowania i po ponownym uruchomieniu, a pierwotna awaria zniknęła. Eskaluj problem, gdy kopii zapasowej nie można przywrócić, starsze środowisko wykonawcze nadal nie może odczytać swojego stanu lub krytyczne dane nie mają zgodnego punktu odzyskiwania. W takiej sytuacji kontrolowana naprawa przez aktualizację albo przebudowa jest bezpieczniejsza niż wielokrotne próby obniżania wersji.