Přeskočit obsah

Řešení problémů

Krátké FAQ. Kompletní tabulku řešení problémů na straně hostitele pro VM přes SSH (permission-denied, ověření hostitelského klíče, chybějící proměnné šablony a další) najdete v průvodci Záloha VM přes SSH na GitHubu.

Něco není správně zapojeno

Otevřete /spike ve webovém rozhraní. Kontrola integrace hostitele prozkoumá každé připojení a CLI (Docker socket, libvirt, restic, qemu-img, rclone) a nahlásí případné chybějící části. Začněte zde, než budete předpokládat chybu: chybějící připojení nebo nedosažitelný hostitel se objeví okamžitě.

Nemohu se dostat k webovému rozhraní

BombVault obsluhuje HTTPS rovnou z krabice na portu 3443 (samopodepsaný certifikát), takže otevřete https://<your-unraid-ip>:3443. Přijměte varování o samopodepsaném certifikátu, nebo umístěte BombVault za reverzní proxy s vlastním certifikátem. Pokud běžíte s HTTP_ONLY=true, obsluhuje místo toho prosté HTTP na portu 3000 (určeno pro použití za proxy terminující TLS).

Ztratil jsem svůj APP_KEY

APP_KEY odvozuje heslo k restic repozitáři. Bez něj (a bez sady pro obnovu šifrovacího klíče) nelze šifrované zálohy obnovit. Proto vás Přehled popohání ke stažení sady pro obnovu. Viz Mimo lokalitu a obnova. Vygenerujte klíč pomocí openssl rand -hex 32 a uložte jej mimo server, dříve než se budete spoléhat na jakoukoli zálohu.

Záloha VM se nepřipojí

Záloha VM komunikuje s libvirt přes SSH, nikdy přes připojení.

  • Potvrďte, že SSH je povoleno na hostiteli a veřejný klíč BombVaultu je autorizovaný v /root/.ssh/authorized_keys (Nastavení, Systém, Záloha VM přes SSH zobrazuje klíč a tlačítko Otestovat připojení).
  • Na vlastní síti br0.x nastavte LIBVIRT_HOST na svou LAN IP Unraidu (kontejner tam nemůže dosáhnout na hostitele přes host.docker.internal). Povolte Nastavení, Docker, Host access to custom networks.
  • Pokud jste změnili SSH port Unraidu, nastavte LIBVIRT_SSH_PORT, aby odpovídal.
  • Kompletní krok za krokem diagnóza (test dosažitelnosti, směrování VLAN, Permission denied (publickey), Host key verification failed) je v průvodci Záloha VM přes SSH.

Živý snímek VM neproběhl

Živé snímky potřebují qemu guest agent nainstalovaný ve VM a disk na /mnt/cache (nebo /mnt/diskX), nikoli /mnt/user. Na vypnuté VM se živý automaticky vrátí k šetrnému. Šetrná záloha VM vypne, zálohuje disky, poté ji znovu spustí, takže je vždy konzistentní.

Záloha selhala s "repository is already locked"

Toto je obvykle osiřelý restic zámek zanechaný, když byl kontejner aktualizován nebo restartován uprostřed operace. BombVault detekuje prokazatelně osiřelý zámek, násilně jej vyčistí a jednou zopakuje, automaticky. Pokud přetrvává, použijte Nastavení, Integrita a údržba, Odemknout pro postiženou doménu k ručnímu vyčištění zaseklého zámku. Skutečný problém se stále objeví, místo aby byl skryt.

Moje kopie mimo lokalitu neproběhla po záloze

Replikace mimo lokalitu je na základě nejlepší snahy záměrně, takže zádrhel mimo lokalitu nikdy nezhatí místní zálohu. Zkontrolujte plán mimo lokalitu pro danou doménu (Nastavení, Plány): prázdný plán replikuje po každé místní záloze, zatímco kadence odesílá méně často. Použijte Replikovat nyní v záložce Mimo lokalitu pro běh na vyžádání a sledujte indikátor replikace na Přehledu.

Obnova se přerušila dříve, než začala

Než se cokoli zastaví nebo odebere, obnova spustí předletovou kontrolu konfliktů: ověří, že statická IP kontejneru a publikované hostitelské porty jsou volné. Pokud je jeden z nich již držen jiným kontejnerem, přeruší se s jasnou, akceschopnou zprávou místo toho, aby zanechala napůl dokončenou obnovu. Uvolněte konfliktní port nebo IP, poté opakujte.

Prostý export selhal místo zapsání souboru

Pokud je šifrování age zapnuto (Nastavení), ale není nastaven platný příjemce, export selže s jasnou chybou místo zapsání prostého textu. Přidejte platného příjemce (veřejný klíč age nebo veřejný klíč SSH), nebo vypněte šifrování, pokud zamýšlíte, aby export byl prostý text. Viz Funkce.

Kontejner se stále restartuje nebo vypadá unhealthy

BombVault hlásí healthy/unhealthy ze svého vlastního /api/health. Nástroj pro automatické hojení (například Autoheal) jej může restartovat automaticky, pokud se engine kdy zasekne. Zkontrolujte log kontejneru a report /spike pro základní příčinu.

Stále zaseknutí?