Kopia zapasowa i przywracanie danych aplikacji Marinara

Zapisz kopię danych aplikacji Marinara Engine, aby móc je później przywrócić. Zrób to przed aktualizacją, zmianą urządzenia lub wyczyszczeniem danych.

Którą opcję wybrać

Plik .zip mieści wiele plików. Obie opcje są w sekcji Settings → Advanced → Backup & Export (ustawienia, zaawansowane, kopie zapasowe i eksport). Przywracanie danych jest w sekcji Settings → Imports → Profile & Marinara (ustawienia, import, profil i Marinara).

Zanim zaczniesz: na komputerze, na którym działa aplikacja Marinara Engine, te narzędzia działają od razu. Aby użyć ich z telefonu, tabletu lub innego urządzenia, ustaw sekret administratora na serwerze i wpisz tę samą wartość w Settings → Advanced → Admin Access (ustawienia, zaawansowane, dostęp administratora). Sekret administratora to hasło w pliku .env serwera, zapisane jako ADMIN_SECRET. Zobacz sekcję "Privileged APIs (ADMIN_SECRET)" w dokumencie Konfiguracja serwera oraz przewodnik Dostęp zdalny.

Download Backup

1. Otwórz Settings → Advanced (ustawienia, zaawansowane).
2. W sekcji Backup & Export kliknij Download Backup (pobranie kopii zapasowej). Przycisk wyświetli Creating backup… (tworzenie kopii zapasowej).
3. Zapisz plik, gdy przeglądarka o to poprosi, albo znajdź go w folderze pobranych plików.

Plik .zip zawiera:

• zapisane dane tekstowe (postacie, czaty, lorebooki, presety, połączenia i ustawienia);
• przesłane i wygenerowane pliki, w tym awatary, sprite'y, tła, obrazy z galerii, czcionki, własne emoji i naklejki oraz własny dźwięk powiadomień;
• plik .encryption-key, jeśli istnieje;
• plik RESTORE.txt z instrukcją ręcznego przywracania danych (zobacz Ręczne przywracanie).

Nazwy folderów znajdziesz w przewodniku Gdzie Marinara przechowuje dane.

Ostrzeżenie: Kopia zapasowa zawiera zapisane klucze API oraz plik .encryption-key, który je odblokowuje. Nigdy jej nie udostępniaj. Przechowuj ją w prywatnym miejscu.

W systemie Android nie masz dostępu do folderu danych aplikacji. Użyj Download Backup, aby skopiować dane poza urządzenie.

Jeśli operacja się nie powiedzie: po komunikacie "Backup preparation timed out after one hour." spróbuj ponownie. Jeśli nie da się pobrać kopii z innego urządzenia, sprawdź Admin Access (opis wyżej).

Automatyczne kopie zapasowe

Marinara może regularnie tworzyć pełną kopię zapasową na komputerze, na którym działa.

1. Otwórz Settings → Advanced → Backup & Export.
2. Włącz Automatic backups (automatyczne kopie zapasowe).
3. Wybierz Daily (codziennie), Weekly (co tydzień) lub Monthly (co miesiąc).
4. Ustaw Automatic backups kept (liczba zachowywanych kopii automatycznych) na wartość od 1 do 9999.

Marinara tworzy pierwszą kopię niedługo po włączeniu tej opcji. Po każdym wykonaniu zachowuje wskazaną liczbę najnowszych kopii i usuwa starsze kopie automatyczne. Nigdy nie usuwa kopii utworzonych przez Download Backup.

Automatyczne kopie leżą w folderze backups/ wewnątrz folderu danych. Najnowsza ma nazwę marinara-automatic-backup.zip. Starsze mają w nazwie datę i godzinę. Ich format jest taki sam jak format kopii z Download Backup.

Każde wykonanie wymaga wolnego miejsca na jeszcze jedno pełne archiwum, ponieważ poprzednia kopia pozostaje na dysku aż do zakończenia nowej. Jeśli miejsca nie wystarcza, Marinara pomija wykonanie i wyświetla przyczynę obok ustawienia. Ponawia próbę po zwolnieniu miejsca.

Wskazówka: Przechowuj drugą kopię poza folderem danych. Awaria dysku lub usunięcie danych aplikacji usuwa też automatyczne kopie zapasowe.

Eksport profilu

1. Otwórz Settings → Advanced → Backup & Export.
2. Kliknij Export Profile (eksport profilu). Otworzy się okno o tej samej nazwie.
3. Wybierz format.
4. Przeglądarka pobierze plik.

• Marinara Native (format natywny) zachowuje postacie, persony, czaty, lorebooki, presety, agentów, motywy, kod rozszerzeń Personal Extension i multimedia. Nie przywraca kluczy API, adresów webhooków ani niektórych ustawień czatu (zobacz Ponowne wpisanie kluczy). Da się go przywrócić w aplikacji Marinara Engine.
• Compatible JSON (zgodny format JSON) tworzy plik .zip ze zwykłymi plikami postaci, person i lorebooków dla innych narzędzi. Nie da się go przywrócić w aplikacji Marinara Engine.

Profil natywny pobiera się jako marinara-profile.json. Jeśli jest za duży, Marinara proponuje zamiast niego plik ZIP. Kliknij Export ZIP (eksport ZIP), aby pobrać marinara-profile.zip.

Profil natywny zachowuje kod Personal Extension, lecz nie zachowuje informacji o włączeniu ani zatwierdzeniu rozszerzenia. Każde przywrócone rozszerzenie jest wyłączone. Przejrzyj je ponownie w Settings → Addons (ustawienia, dodatki).

Przywracanie przez Import Profile

Import Profile (import profilu) wczytuje plik profilu lub plik .zip utworzony przez Download Backup.

1. Otwórz Settings → Imports (ustawienia, import).
2. W sekcji Profile & Marinara (profil i Marinara) kliknij Import Profile (JSON/ZIP) (import profilu JSON/ZIP).
3. Wybierz marinara-profile.json, marinara-profile.zip albo plik .zip z kopią zapasową. Przycisk wyświetli Scanning Profile... (sprawdzanie profilu).
4. Przeczytaj treść okna Import Profile. Pokazuje znalezione dane i ostrzega, że importu nie da się cofnąć.
5. Kliknij Import (import), aby kontynuować, albo Cancel (anulowanie), aby przerwać. Przycisk wyświetli Importing Profile... (importowanie profilu), a następnie pojawi się pasek postępu. Po zakończeniu zobaczysz potwierdzenie importu.

Jeśli operacja się nie powiedzie:

• Poza adresami localhost, 127.0.0.1 i [::1] import profilu wymaga HTTPS. Komunikat błędu brzmi "Profile import requires HTTPS outside local development." Otwórz aplikację Marinara Engine przez adres HTTPS.
• Jeśli w pliku .zip brakuje części multimediów, import i tak się kończy. Ostrzeżenie zawiera listę brakujących plików, a Marinara importuje pozostałe dane.

Jeśli zaimportujesz ten sam profil dwukrotnie, Marinara zaktualizuje istniejące elementy zamiast je powielać. Profile z dużo starszych wersji mogą jednak utworzyć duplikaty.

Ponowne wpisanie kluczy

Import Profile nigdy nie przywraca kluczy API ani adresów webhooków, nawet z pliku .zip utworzonego przez Download Backup. Klucz API to tajny kod otrzymany od usługi. Te wartości są wyczyszczone w pliku profilu oraz w profilu wewnątrz kopii zapasowej. Po imporcie na nowym komputerze wpisz je ponownie:

1. Otwórz Connections (połączenia) na górnym pasku.
2. Otwórz każde używane konto, wpisz klucz API i zapisz. Zobacz Łączenie z dostawcą AI.
3. Wpisz ponownie adres webhooka w każdym własnym narzędziu, które go używa.

Niektóre ustawienia czatu z adresami lub kluczami (Discord, DeepL, Intiface) też są puste po imporcie. Wpisz je ponownie w Chat Settings (ustawienia czatu) każdego czatu.

Import nigdy nie usuwa kluczy już zapisanych w tej samej instalacji.

Przeniesienie danych na nowy komputer

1. Zainstaluj aplikację Marinara Engine na nowym komputerze i uruchom ją. Zobacz Instalacja.
2. Otwórz Settings → Imports → Profile & Marinara i kliknij Import Profile (JSON/ZIP).
3. Wybierz plik .zip utworzony przez Download Backup albo plik profilu, a następnie kliknij Import.
4. Wpisz ponownie klucze API zgodnie z opisem wyżej.

Plik klucza z kopii zapasowej pomaga tylko wtedy, gdy ręcznie kopiujesz cały folder danych, jak opisano niżej.

Ręczne przywracanie

Użyj tej metody tylko wtedy, gdy nie da się użyć Import Profile. W pliku .zip znajduje się folder, na przykład marinara-backup-..., z instrukcją RESTORE.txt.

1. Zatrzymaj aplikację Marinara Engine.
2. Rozpakuj kopię zapasową.
3. Skopiuj foldery oraz plik .encryption-key z rozpakowanego folderu do folderu danych. Zobacz Gdzie Marinara przechowuje dane.
4. Uruchom aplikację Marinara Engine.

Trzymaj plik .encryption-key razem z folderem storage, inaczej nie da się odczytać zapisanych kluczy API.

Lista Existing backups (istniejące kopie zapasowe) w sekcji Backup & Export zwykle jest pusta. Nie musisz jej używać.

Powiązane przewodniki

• Gdzie Marinara przechowuje dane
• Czyszczenie i resetowanie danych
• Aktualizacja aplikacji Marinara Engine
• Łączenie z dostawcą AI
• Dostęp zdalny: logowanie i lista dozwolonych adresów IP