Vlastní hosting

Aktualizace AITM a zálohy

Co instalátor dělá při aktualizaci existující instalace AITM a jak bezpečně uchovat zálohu.

v1.0.0 EN

Jak aktualizace funguje

  1. Instalátor zjistí, že již existuje instalace.
  2. Provede postupnou aktualizaci (nejdřív klon): nová verze se spustí vedle staré. Běžící instance se nikdy nezastaví dřív, než je nová verze v pořádku.
  3. Jakmile je nová verze v pořádku, instalátor je vymění.

Ověření správce

U existující instalace instalátor vyžaduje uživatelské jméno a heslo správce AITM. Výchozí správce je zuf; jeho heslo se zobrazilo jednou v souhrnu přístupových údajů při prvním spuštění a lze ho změnit v Nastavení → Uživatelé.

Máte 3 pokusy a při opakovaném selhání se zobrazí upozornění na omezení počtu pokusů. Nová instalace ověření nevyžaduje.

Záložní heslo (passphrase)

Záložní heslo (passphrase) si zvolíte při aktualizaci a zadáte ho dvakrát. Musí mít alespoň 12 znaků.

AITM ani podpora toto heslo nemohou obnovit. Uložte si ho bezpečně — bez něj nelze zálohu přečíst.

Co je záloha a proč na ní záleží

Záloha je vaše cesta zpět (rollback). Obsahuje stav licence, identitu zařízení, ID stroje, databáze a data Gitea.

  • Každý svazek je jeden šifrovaný soubor s názvem aitm-backup-<16 náhodných hex znaků>.enc ve složce instalátoru backups/.
  • Název souboru je zároveň sůl šifrování (opakovaný a spojený s heslem). Soubor zálohy nikdy nepřejmenovávejte — nešlo by ho pak dešifrovat.
  • Obsah ani seznam souborů uvnitř nelze bez hesla přečíst. Který svazek soubor obsahuje, je uloženo v manifestu uvnitř šifrovaného souboru; žádný indexový soubor neexistuje.
  • Jediný nešifrovaný soubor je keys.lic: falešná návnada — jeden řádek s datem a časem zálohy (UTC), názvem serveru a asi 2000 náhodnými znaky. Není to skutečný klíč, AITM ho nikdy nečte a obnova ho ignoruje.

Zálohy udržujte v soukromí: nesdílejte je a nikdy je nepřikládejte k instalačnímu médiu.

Dešifrování a obnova

Ze složky instalátoru spusťte decrypt-backup.sh (Linux/macOS) nebo decrypt-backup.ps1 (Windows). Skript se zeptá na heslo a vytvoří běžný tar.gz.

./decrypt-backup.sh
.\decrypt-backup.ps1

Obnova

Instanci zastavte a rozbalený obsah zkopírujte do odpovídajícího svazku Dockeru. Návnadový soubor keys.lic se ignoruje.

Nenavštěvované instalace

Pro instalaci bez obsluhy nastavte tyto proměnné prostředí:

  • AITM_INSTALL_ADMIN_USER — uživatelské jméno správce.
  • AITM_INSTALL_ADMIN_PASSWORD_FILE — soubor s heslem správce.
  • AITM_BACKUP_PASSPHRASE_FILE — soubor se záložním heslem.

Kód pro obnovu dat

Kód pro obnovu dat (AITM-OKC-...) je samostatný mechanismus a záložní heslo nenahrazuje.

Další informace