Przejdź do treści

Rozwiązywanie problemów

Krótkie FAQ. Pełną tabelę rozwiązywania problemów po stronie hosta dla VM przez SSH (permission-denied, weryfikacja klucza hosta, brakujące zmienne szablonu i więcej) znajdziesz w przewodniku Kopia VM przez SSH na GitHub.

Coś nie jest poprawnie połączone

Otwórz /spike w interfejsie webowym. Kontrola integracji z hostem sonduje każdy montaż i każde CLI (gniazdo Docker, libvirt, restic, qemu-img, rclone) i zgłasza wszelkie brakujące elementy. Zacznij tutaj, zanim założysz, że to błąd: brakujący montaż lub nieosiągalny host pojawia się natychmiast.

Nie mogę dotrzeć do interfejsu webowego

BombVault serwuje HTTPS od razu po instalacji na porcie 3443 (certyfikat samopodpisany), więc otwórz https://<your-unraid-ip>:3443. Zaakceptuj ostrzeżenie o certyfikacie samopodpisanym lub umieść BombVault za odwrotnym proxy z własnym certyfikatem. Jeśli uruchamiasz z HTTP_ONLY=true, serwuje zamiast tego zwykły HTTP na porcie 3000 (przeznaczony do użytku za proxy terminującym TLS).

Straciłem swój APP_KEY

APP_KEY wyprowadza hasło repozytorium restic. Bez niego (i bez zestawu odzyskiwania klucza szyfrowania) zaszyfrowanych kopii nie da się odzyskać. Dlatego panel nęka Cię, abyś pobrał zestaw odzyskiwania. Zobacz Kopie poza siedzibą i odzyskiwanie. Wygeneruj klucz poleceniem openssl rand -hex 32 i przechowuj go poza serwerem, zanim zaczniesz polegać na jakiejkolwiek kopii.

Kopia VM nie łączy się

Kopia VM komunikuje się z libvirt przez SSH, nigdy przez montaż.

  • Potwierdź, że SSH jest włączone na hoście, a klucz publiczny BombVault jest autoryzowany w /root/.ssh/authorized_keys (Ustawienia, Integracje, SSH hosta pokazuje klucz oraz przycisk Test połączenia).
  • W niestandardowej sieci br0.x ustaw LIBVIRT_HOST na swoje IP Unraid w LAN (kontener nie może tam dotrzeć do hosta przez host.docker.internal). Włącz Settings, Docker, Host access to custom networks.
  • Jeśli zmieniłeś port SSH Unraid, ustaw LIBVIRT_SSH_PORT, aby pasował.
  • Pełna diagnoza krok po kroku (test osiągalności, routing VLAN, Permission denied (publickey), Host key verification failed) znajduje się w przewodniku Kopia VM przez SSH.

Migawka VM na żywo nie została uruchomiona

Migawki na żywo wymagają agenta gościa qemu zainstalowanego w VM oraz dysku na /mnt/cache (lub /mnt/diskX), nie /mnt/user. Na wyłączonej VM tryb na żywo automatycznie wraca do płynnego. Płynna kopia wyłącza VM, tworzy kopię dysków, a następnie ją restartuje, więc jest zawsze spójna.

Kopia zapasowa zawiodła z "repository is already locked"

To zwykle osierocona blokada restic pozostawiona, gdy kontener został zaktualizowany lub zrestartowany w trakcie operacji. BombVault wykrywa bezspornie osieroconą blokadę, wymuszenie ją usuwa i ponawia raz, automatycznie. Jeśli się utrzymuje, użyj Ustawienia, Integralność, Odblokuj dla dotkniętej domeny, aby ręcznie usunąć nieaktualną blokadę. Prawdziwy problem nadal wychodzi na jaw zamiast być ukrywany. Po restarcie BombVault czeka, aż taka blokada przez dziesięć minut nie zostanie odświeżona. Restic, który wciąż działa, na przykład w drugim BombVaulcie na tym samym repozytorium, odświeża swoją blokadę co pięć minut.

Moja kopia poza siedzibą nie zdarzyła się po kopii

Replikacja poza siedzibą jest z założenia best-effort, więc potknięcie poza siedzibą nigdy nie powoduje niepowodzenia kopii lokalnej. Sprawdź harmonogram poza siedzibą dla tej domeny (Ustawienia, Harmonogramy): pusty harmonogram replikuje po każdej kopii lokalnej, podczas gdy kadencja wysyła rzadziej. Użyj Replikuj teraz na stronie Poza siedzibą do uruchomienia na żądanie i obserwuj wskaźnik replikacji na panelu.

Przywracanie przerwane, zanim się zaczęło

Zanim cokolwiek zostanie zatrzymane lub usunięte, przywracanie uruchamia kontrolę konfliktów przed startem: weryfikuje, czy statyczny IP kontenera oraz opublikowane porty hosta są wolne. Jeśli inny kontener już jeden z nich zajmuje, przerywa działanie z czytelnym, praktycznym komunikatem zamiast pozostawiać niedokończone przywracanie. Zwolnij konfliktujący port lub IP, a następnie ponów.

Jawny eksport zawiódł zamiast zapisać plik

Jeśli szyfrowanie age jest włączone (Ustawienia), ale nie ustawiono prawidłowego odbiorcy, eksport kończy się czytelnym błędem zamiast zapisać tekst jawny. Dodaj prawidłowego odbiorcę (klucz publiczny age lub klucz publiczny SSH) albo wyłącz szyfrowanie, jeśli chcesz, aby eksport był w postaci jawnej. Zobacz Funkcje.

Zrzut bazy danych się nie udał

Nieudany zrzut nigdy nie przewraca kopii, w której powstał; zapisuje się jako własny nieudany przebieg, a powód mówi, co naprawić.

  • Odmowa logowania. Zrzut loguje się zmiennymi hasła samego kontenera (POSTGRES_PASSWORD, MARIADB_ROOT_PASSWORD, MYSQL_ROOT_PASSWORD albo ich odpowiednikami _FILE). Sprawdź je na kontenerze bazy. Zmienna _FILE wskazująca sekret, którego użytkownik kontenera nie może odczytać, kończy się tak samo.
  • Brak uprawnień. Przy losowym haśle roota zrzut może zalogować się tylko jako użytkownik aplikacji, obejmuje więc tę jedną bazę, a MySQL 8.4 i nowsze mogą odmówić całkiem. Nadaj kontenerowi prawdziwe hasło roota albo wyłącz mu zrzut.
  • Tabele systemowe wymagają aktualizacji. MariaDB odmawia zrzutu, gdy jej tabele systemowe pochodzą ze starszej wersji (błąd 1558). Dodaj zmienną MARIADB_AUTO_UPGRADE=1 i zrestartuj kontener albo uruchom w nim raz mariadb-upgrade.
  • Brak narzędzia do zrzutu. Odchudzonego lub własnoręcznie zbudowanego obrazu bez pg_dump, mysqldump czy mariadb-dump nie da się zrzucić. Weź obraz oficjalny albo wyłącz zrzut.
  • Limit czasu. Zrzut dostaje DB_DUMP_MAX_HOURS (domyślnie 6), kopia wokół niego BACKUP_MAX_HOURS, a zrzut, który przestaje robić postępy, zostaje ucięty po BACKUP_STALL_HOURS. Za tym ostatnim stoi zwykle blokada trzymana przez aplikację. Podnieś limit, który zadziałał, albo zrzucaj, gdy aplikacja jest spokojna.
  • Kontener jest wstrzymany albo się restartuje. Zrzut rozmawia z działającym serwerem. Jeśli kontener restartuje się w kółko, jego własny dziennik mówi dlaczego.
  • Uszkodzonego zrzutu nie dało się usunąć. Zrzut, którego BombVault nie zdołał dokończyć, jest kasowany. Gdy to kasowanie się nie uda, zrzut zostaje na liście oznaczony jako uszkodzony i możesz go tam usunąć.

Import się nie udał

Import zatrzymuje kontener, odsuwa jego folder danych na bok i pozwala obrazowi utworzyć w tym miejscu pusty. Jeśli zawiedzie krok przed samym importem, stary folder wraca na miejsce samoczynnie. Jeśli zawiedzie import, kontener zostaje z nowym folderem, a stary leży obok jako <folder danych>.bombvault-before-import-<znacznik czasu>; komunikat błędu przebiegu podaje dokładną ścieżkę.

Ręczne przywrócenie: zatrzymaj kontener, zmień nazwę bieżącego folderu danych, żeby zszedł z drogi, przywróć zachowanemu folderowi pierwotną nazwę i uruchom kontener. Na Unraidzie robi to menedżer plików w zakładce Shares.

Kopia zbioru danych ZFS się nie udała albo pominęła zbiór

Każdy problem ma kod przyczyny w nawiasach kwadratowych, a strona Zbiory danych ZFS wymienia wszystkie wraz z rozwiązaniem. Trzy najczęstsze:

  • snapshot-loop: migawka nie dotarła do BombVault, bo Host Data nie przekazuje nowych montowań. Edytuj kontener, ustaw Access Mode dla Host Data na Read/Write - Slave i uruchom ponownie BombVault.
  • key-not-loaded: zaszyfrowany zbiór, którego klucz nie jest załadowany, jest pomijany. Załaduj klucz poleceniem zfs load-key i zamontuj zbiór; następna kopia go obejmie.
  • ssh-auth: serwer odrzucił klucz BombVault. Karta połączenia na stronie ZFS pokazuje polecenie, które go autoryzuje; uruchom je raz na serwerze.

Element zatrzymuje się na "Uczy się N/10"

Większość kontroli anomalii zaczyna się po 10 udanych kopiach elementu, a licznik zaczyna od nowa po Oznacz jako oczekiwane i po zmianie wyboru elementu. Element bez harmonogramu się nie uczy, a kontener bez appdata nie ma się na czym uczyć, co mówi też jego znaczek.

Retencja przestała usuwać stare kopie jednego elementu

Wstrzymuje je otwarta krytyczna anomalia: źródło elementu jest prawie puste, mocno się skurczyło albo kopia zapisała ponownie większość danych. Otwórz anomalię ze znaczka przy elemencie. Jeśli brakuje danych albo zostały zaszyfrowane, najpierw przywróć je z podlinkowanej ostatniej dobrej kopii. Potem potwierdź anomalię albo oznacz ją jako oczekiwaną, jeśli zmiana była twoja, a następny przebieg posprząta jak zwykle. Podgląd retencji oznacza taki element jako zachowany. W elemencie ZFS stare kopie zachowuje tylko zbiór danych wskazany w anomalii; pozostałe zbiory drzewa są czyszczone jak zwykle.

Ręczne czyszczenie mówi, że niektóre elementy zostały zachowane

Ta sama przyczyna: czyszczenie nie rusza starych kopii elementu z taką anomalią i wymienia go w swoim komunikacie. Wszystko inne jest czyszczone jak zwykle.

Import historii mówi, że nie udało się odczytać repozytorium

Po aktualizacji BombVault raz odczytuje rozmiary wcześniejszych kopii z każdego repozytorium. Repozytorium, które było wtedy nieosiągalne, na przykład niedziałający cel zewnętrzny albo niezamontowany udział, pojawia się na karcie Anomalie w Ustawienia, Integralność i jest ponawiane raz dziennie. W tym czasie jego elementy uczą się na nowych kopiach.

Ostrzeżenie o miejscu na dysku nie zgadza się z pulpitem Unraid

Na udziale użytkownika Unraid (/mnt/user) wolne miejsce to wolne miejsce całej macierzy, a nie jednego dysku. Repozytoria zdalne są mierzone tylko przez zdalne zasoby rclone, które podają swoje wolne miejsce; repozytoria S3, B2, REST i SFTP nie mają wartości i figurują na karcie Anomalie jako niezmierzone.

Asystent AI nie może się połączyć

Strona Serwer MCP wyjaśnia, co oznacza każdy kod stanu i każda odmowa punktu końcowego MCP oraz co z tym zrobić.

Kontener wciąż się restartuje lub wygląda na niesprawny

BombVault zgłasza stan healthy/unhealthy z własnego /api/health. Narzędzie do auto-naprawy (takie jak Autoheal) może go automatycznie zrestartować, jeśli silnik kiedykolwiek się zaklinuje. Sprawdź log kontenera oraz raport /spike w poszukiwaniu przyczyny źródłowej.

Nadal utknąłeś?