Μετάβαση στο περιεχόμενο

Αντίγραφα ασφαλείας

Για αρχάριους

Κράτα ένα αντίγραφο της ρύθμισής σου, για να τη βάλεις πίσω μετά από κακή ενημέρωση, χαλασμένο δίσκο ή μετακίνηση σε νέο υπολογιστή.

  • Το Settings > Backups (Ρυθμίσεις > Αντίγραφα ασφαλείας) θέλει το δικαίωμα Change settings (αλλαγή ρυθμίσεων). Μόνο ο ιδιοκτήτης κάνει επαναφορά.
  • Η λήψη, η διαγραφή και η επαναφορά θέλουν σύνδεση με κωδικό πρόσβασης μέσα στα τελευταία λίγα λεπτά.
  1. Άνοιξε το Settings > Backups.
  2. Πάτησε Back up now (αντίγραφο τώρα). Θα πρέπει να δεις το νέο αντίγραφο κάτω από το Saved backups (αποθηκευμένα αντίγραφα).
  3. Πάτησε Download (λήψη) δίπλα του για να κρατήσεις ένα αντίγραφο έξω από τον διακομιστή.

Τα αντίγραφα ασφαλείας δεν περιέχουν ποτέ το κύριο κλειδί, που ανοίγει τους κωδικούς πρόσβασης και τα κλειδιά API στις ρυθμίσεις σου. Χωρίς το σωστό κλειδί, ένα αντίγραφο που επαναφέρεις δεν μπορεί να τα διαβάσει.

  1. Κάτω από το Master key (κύριο κλειδί), ο ιδιοκτήτης πατάει Download key kit (λήψη πακέτου κλειδιού).
  2. Κράτα το αρχείο μακριά από τον διακομιστή και ξεχωριστά από τα αντίγραφά σου. Θα πρέπει να δεις την προειδοποίηση για το key kit να φεύγει από το Settings > Backups και από τους ελέγχους υγείας.

Για να το χρησιμοποιήσεις αργότερα, μετονόμασέ το σε holyarrs.key και βάλ’ το στον φάκελο ρυθμίσεων. Δεν είσαι ο ιδιοκτήτης; Ζήτα του να το κατεβάσει.

  1. Πάτησε Restore from a file (επαναφορά από αρχείο) και διάλεξε ένα zip αντιγράφου του HolyArrs.
  2. Επιβεβαίωσε.
  3. Το HolyArrs ελέγχει το αρχείο. Θα πρέπει να δεις Restore ready. It applies on the next start. (η επαναφορά είναι έτοιμη, εφαρμόζεται στην επόμενη εκκίνηση).
  4. Το HolyArrs κάνει επανεκκίνηση και βάζει το αντίγραφο στη θέση του. Με την προτεινόμενη πολιτική επανεκκίνησης του Docker αυτό γίνεται μόνο του.

Οι τρέχουσες βάσεις δεδομένων σου μετακινούνται στο /config/backups/before-restore-<time>, ώστε να μπορείς να αναιρέσεις μια επαναφορά.

Επιλογή Κάνει αντίγραφο Κρατάει
Balanced (ισορροπημένο, προεπιλογή) Κάθε μέρα Τις τελευταίες 7 μέρες και 4 εβδομαδιαία αντίγραφα
Light (ελαφρύ) Μία φορά την εβδομάδα 4 εβδομάδες. Λιγότερος χώρος
Careful (προσεκτικό) Κάθε μέρα Κάθε αντίγραφο για 30 μέρες

Το νεότερο προγραμματισμένο αντίγραφο μένει πάντα. Αυτοί οι κανόνες καθαρίζουν μόνο τα προγραμματισμένα αντίγραφα. Τα αντίγραφα που κάνεις εσύ μένουν μέχρι να τα διαγράψεις (κουμπί κάδου στη γραμμή· δεν αναιρείται). Το HolyArrs κάνει επίσης αντίγραφο πριν από μια ενημέρωση που αλλάζει αποθηκευμένα δεδομένα και κρατάει τα 3 νεότερα· δες Ενημερώσεις.

Μια νέα εγκατάσταση φτιάχνει δικό της κύριο κλειδί στην πρώτη εκκίνηση. Αυτό το κλειδί δεν ανοίγει τα παλιά σου αντίγραφα, οπότε η επαναφορά απορρίπτεται. Βάλε πρώτα το παλιό κλειδί στη θέση του. Τα παραδείγματα λένε το container holyarrs· χρησιμοποίησε το δικό σου όνομα.

  1. Πριν από την πρώτη εκκίνηση, φτιάξε το container χωρίς να το ξεκινήσεις: docker compose create, ή τη γραμμή σου docker run με docker create στη θέση του docker run -d.
  2. Αντίγραψε μέσα το παλιό σου κλειδί: docker cp holyarrs.key holyarrs:/config/. Δουλεύει και ένα key kit που μετονόμασες σε holyarrs.key. Αυτό ισχύει για volume με όνομα ή φάκελο του host· το HolyArrs δίνει τα αρχεία στο /config στα PUID και PGID σου όταν ξεκινά. Αν χρησιμοποιείς το HOLYARRS_MASTER_KEY_FILE, βάλε το κλειδί σε εκείνη τη διαδρομή στον host, ώστε να το διαβάζουν τα PUID και PGID σου.
  3. Επανάφερε το αντίγραφο. Διάλεξε έναν τρόπο:
    • Ξεκίνα το HolyArrs, ολοκλήρωσε την πρώτη εκκίνηση και μετά χρησιμοποίησε το Restore from a file στο Settings > Backups.

    • Ή επανάφερε πριν από την πρώτη εκκίνηση. Βάλε το zip, με το όνομα όπως είναι, σε φάκελο με όνομα backups και αντίγραψέ τον μέσα με docker cp backups holyarrs:/config/. Μετά τρέξε την επαναφορά μία φορά με την ίδια image:

      • Compose: docker compose run --rm holyarrs restore <zip name>
      • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>

      Αν έχεις διαδρομή αρχείου κλειδιού, πρόσθεσε -e HOLYARRS_MASTER_KEY_FILE=<its path> ώστε η επαναφορά να ελέγξει με το δικό σου κλειδί. Το restore --list δείχνει τα ονόματα των αντιγράφων που βλέπει.

  4. Ξεκίνα το HolyArrs. Θα πρέπει να δεις τη Βιβλιοθήκη και τις ρυθμίσεις σου πίσω.

Ξεκίνησες τη νέα εγκατάσταση πριν αντιγράψεις το κλειδί; Αν δεν υπάρχει τίποτα σε αυτήν που αξίζει να κρατήσεις, σταμάτα το HolyArrs, αντίγραψε το παλιό σου κλειδί πάνω από το νέο με το ίδιο docker cp, κάνε επαναφορά και μετά ξεκίνα.

Σύμπτωμα: “Backups are off in this build” (τα αντίγραφα ασφαλείας είναι απενεργοποιημένα σε αυτή την έκδοση). Αιτία: αυτό το αντίγραφο του προγράμματος τρέχει χωρίς διαχειριστή αντιγράφων. Λύση: δεν υπάρχει λύση μέσα στην εφαρμογή· δεν υπάρχουν χειριστήρια αντιγράφων.

Σύμπτωμα: η λήψη, η διαγραφή ή η επαναφορά ζητάει τον κωδικό πρόσβασής σου. Αιτία: αυτά θέλουν πρόσφατη σύνδεση με κωδικό πρόσβασης. Λύση: συνδέσου ξανά με τον κωδικό σου και ξαναδοκίμασε.

Σύμπτωμα: η επαναφορά απορρίπτεται λόγω του κύριου κλειδιού. Αιτία: το κλειδί στον φάκελο ρυθμίσεων δεν ταιριάζει με το αντίγραφο. Λύση: βάλε πίσω το σωστό holyarrs.key και ξαναδοκίμασε.

Η επαναφορά απορρίπτει επίσης ένα zip που είναι πολύ μεγάλο ή χαλασμένο, έχει απροσδόκητα αρχεία, προέρχεται από νεότερη έκδοση βάσης δεδομένων ή έχει δεδομένα που το κλειδί σου δεν μπορεί να διαβάσει.

Τι έχει ένα αντίγραφο

Κάθε αντίγραφο είναι ένα zip με την κύρια βάση δεδομένων, τη βάση Events αν υπάρχει, και το backup.json (έκδοση HolyArrs, εκδόσεις βάσεων, είδος αντιγράφου, ώρα δημιουργίας). Τα πολυμέσα, οι λήψεις, τα εξώφυλλα, τα logs και το κύριο κλειδί δεν περιλαμβάνονται.

Επαναφορά πριν από την πρώτη εκκίνηση

Το docker cp δουλεύει για volume με όνομα ή φάκελο του host· το HolyArrs δίνει τα αρχεία στο /config στα PUID και PGID σου όταν ξεκινά. Με το HOLYARRS_MASTER_KEY_FILE, βάλε το κλειδί σε εκείνη τη διαδρομή στον host, ώστε να το διαβάζουν τα PUID και PGID.

  1. Βάλε το zip, με το όνομα όπως είναι, σε φάκελο με όνομα backups και αντίγραψέ τον μέσα: docker cp backups holyarrs:/config/.
  2. Τρέξε την επαναφορά μία φορά με την ίδια image:
    • Compose: docker compose run --rm holyarrs restore <zip name>
    • Docker CLI: docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> holyarrs/holyarrs:<tag> restore <zip name>
  3. Αν έχεις διαδρομή αρχείου κλειδιού, πρόσθεσε -e HOLYARRS_MASTER_KEY_FILE=<its path> ώστε η επαναφορά να ελέγξει με το δικό σου κλειδί.
  4. Ξεκίνα το HolyArrs.

Το restore --list δείχνει τα ονόματα των αντιγράφων που βλέπει.

Το HolyArrs είναι δωρεάν. Αν σου γλίτωσε χρόνο, βάλε του αστέρι στο GitHub, γίνε χορηγός ή κέρασέ με έναν καφέ.