Ενότητες και ασφαλής λειτουργία

Απενεργοποίησε τις ενότητες που δεν χρησιμοποιείς, ξεκίνα σε ασφαλή λειτουργία όταν κάτι χαλάσει και κάνε επανεκκίνηση του HolyArrs από το πρόγραμμα περιήγησης.

Ενεργοποίησε ή απενεργοποίησε μια ενότητα

Το HolyArrs έχει 5 ενότητες: Movies (ταινίες), TV shows (σειρές), Music (μουσική), Subtitles (υπότιτλοι) και Requests (αιτήματα). Τις διαλέγεις για πρώτη φορά στον οδηγό της πρώτης εκκίνησης.

1. Άνοιξε το Settings > Parts (Ρυθμίσεις > Ενότητες).
2. Πάτησε Turn on (ενεργοποίηση) ή Turn off (απενεργοποίηση) δίπλα σε μια ενότητα. Θα πρέπει να δεις τα στοιχεία του μενού της να εμφανίζονται ή να φεύγουν.

Τίποτα δεν διαγράφεται. Ενεργοποίησε ξανά την ενότητα και συνεχίζει από εκεί που έμεινε.

Ξεκίνα σε ασφαλή λειτουργία

Η ασφαλής λειτουργία ξεκινά μόνο τα βασικά, για όταν κάτι εμποδίζει το HolyArrs να ξεκινήσει ή να δουλέψει. Μπορείς να συνδεθείς, να δεις τη Βιβλιοθήκη σου, να αλλάξεις ρυθμίσεις και να κάνεις ή να επαναφέρεις αντίγραφο ασφαλείας. Η αναζήτηση, η προσθήκη, η ανανέωση, οι λήψεις και οι εισαγωγές περιμένουν μέχρι την επόμενη κανονική εκκίνηση.

1. Άνοιξε το Settings > Danger zone (Ρυθμίσεις > Επικίνδυνη ζώνη).
2. Πάτησε Restart in safe mode (επανεκκίνηση σε ασφαλή λειτουργία). Θα πρέπει να δεις ένα banner σε κάθε σελίδα.
3. Διόρθωσε το πρόβλημα και μετά πάτησε Restart HolyArrs (επανεκκίνηση του HolyArrs). Η επόμενη εκκίνηση είναι κανονική.

Αν δεν μπορείς να φτάσεις στη σελίδα, όρισε HOLYARRS_SAFE_MODE=1 στο Compose ή ξεκίνα με -safe-mode. Αφαίρεσέ το μετά τη διόρθωση: και τα δύο κρατούν κάθε εκκίνηση σε ασφαλή λειτουργία.

Επιλογές

Τι σταματά όταν μια ενότητα είναι απενεργοποιημένη

Ενότητα	Σταματά	Συνεχίζει
Ταινίες	Οι σελίδες και τα στοιχεία μενού των ταινιών, η προσθήκη, η αναζήτηση, η ανανέωση	Οι λήψεις που είναι ήδη στο πρόγραμμα λήψεων συνεχίζουν να παρακολουθούνται. Τα αρχεία μένουν.
Σειρές	Οι σελίδες σειρών, η προσθήκη, η αναζήτηση, οι αναζητήσεις σεζόν, οι ανανεώσεις	Όπως στις Ταινίες.
Μουσική	Οι σελίδες καλλιτεχνών και άλμπουμ, οι ρυθμίσεις μουσικής, οι ανανεώσεις καλλιτεχνών, οι αναζητήσεις άλμπουμ	Όπως στις Ταινίες.
Υπότιτλοι	Οι ρυθμίσεις υποτίτλων, η σελίδα με τους υπότιτλους που λείπουν, οι αναζητήσεις και οι έλεγχοι	Τα αρχεία υποτίτλων δίπλα στα βίντεό σου μένουν.
Αιτήματα	Οι σελίδες αιτημάτων και η αίτηση τίτλων	Τα υπάρχοντα αιτήματα μένουν και επιστρέφουν όταν η ενότητα ενεργοποιηθεί ξανά.

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

• Οι υπότιτλοι χρειάζονται Ταινίες ή Σειρές. Τα αιτήματα χρειάζονται Ταινίες, Σειρές ή Μουσική. Το HolyArrs απορρίπτει μια αλλαγή που το χαλάει αυτό και λέει τι να αλλάξεις πρώτα.
• Μια εργασία σε ουρά για ενότητα που είναι απενεργοποιημένη περιμένει και τρέχει μόλις ενεργοποιηθεί η ενότητα.
• Η απενεργοποίηση μιας ενότητας δεν εξοικονομεί μνήμη. Όλα τρέχουν σε ένα πρόγραμμα.

Επανεκκίνηση, παύση και τερματισμός

Το Settings > Danger zone (ιδιοκτήτης και διαχειριστές) έχει Restart HolyArrs, Restart in safe mode και Shut down (τερματισμός), και επίσης Pause (παύση), Resume (συνέχιση) και Restart για κάθε εργασία παρασκηνίου, όπως τα αντίγραφα ασφαλείας ή ο συγχρονισμός λήψεων.

• Τα χειριστήρια που σταματούν κάτι ζητούν επιβεβαίωση μέσα σε 60 s.
• Κάθε χειριστήριο που χρησιμοποιείται γράφεται στο Ιστορικό με το όνομά σου.
• Χρειάζεσαι σύνδεση με κωδικό πρόσβασης. Μια σύνδεση χωρίς κωδικό στο τοπικό σου δίκτυο απορρίπτεται.

Η επανεκκίνηση σταματά το HolyArrs καθαρά και αφήνει το Docker να το ξεκινήσει ξανά, οπότε όρισε restart: unless-stopped.

Πολιτική επανεκκίνησης	Επανεκκίνηση	Τερματισμός
unless-stopped ή always	Επιστρέφει	Επιστρέφει κι αυτό
on-failure	Επιστρέφει	Μένει κλειστό
no	Μένει κλειστό	Μένει κλειστό

Αν δεν δουλεύει

Σύμπτωμα	Αιτία	Λύση
Το HolyArrs δεν μπορεί να απενεργοποιήσει μια ενότητα	Την χρειάζεται άλλη ενότητα	Απενεργοποίησε πρώτα εκείνη την ενότητα, όπως λέει το μήνυμα.
Η επανεκκίνηση έκλεισε το HolyArrs για πάντα	Η πολιτική επανεκκίνησης είναι no	Ξεκίνα το container και όρισε restart: unless-stopped.
Τα χειριστήρια απορρίπτονται	Σύνδεση τοπικά χωρίς κωδικό, ή το κλειδί δεν έχει control	Συνδέσου με τον κωδικό πρόσβασής σου.
Μια εργασία μένει σε αποτυχία	Σε χρειάζεται	Διάβασε τον λόγο της στο /health, διόρθωσέ το, πάτησε Restart για εκείνη την εργασία.

Περισσότερες λύσεις: Επίλυση προβλημάτων.

Για έμπειρους

Καταστάσεις υγείας

Το /health, το Settings > Parts και το GET /api/v1/health/states δείχνουν κάθε εργασία παρασκηνίου, ενότητα και συνδεδεμένη εφαρμογή με μια κατάσταση και έναν λόγο.

Κατάσταση	Τι σημαίνει
off	Απενεργοποιημένο, σε παύση, ή δεν ξεκίνησε σε ασφαλή λειτουργία.
starting	Ξεκινά, ή δεν έχει ελεγχθεί ακόμα.
running	Δουλεύει.
retrying	Απέτυχε· το HolyArrs ξαναδοκιμάζει, περιμένοντας περισσότερο κάθε φορά.
failed	Κράσαρε, κόλλησε ή σε χρειάζεται. Ο λόγος λέει τι να κάνεις.

Μια εργασία που κράσαρε δείχνει failed, μετά retrying, και μετά ξεκινά ξανά. Η σύνδεση, η Βιβλιοθήκη και τα αντίγραφα ασφαλείας συνεχίζουν να δουλεύουν στο μεταξύ. Μια εργασία που κόλλησε καθαρίζει με πλήρη επανεκκίνηση.

Μνήμη και λειτουργία χαμηλής μνήμης

Το HolyArrs στοχεύει να μένει κάτω από 384 MiB, που χωράει σε όριο container 500 MB. Για να ορίσεις δικό σου στόχο, όρισε το GOMEMLIMIT στο 80 τοις εκατό περίπου της μνήμης του container.

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

Ρύθμιση	Αποτέλεσμα
(προεπιλογή, Linux)	Ενεργοποιείται μόνη της στα 2.5 GiB μνήμης ή λιγότερο περίπου.
HOLYARRS_LOW_MEMORY=1	Πάντα ενεργή.
HOLYARRS_LOW_MEMORY=0	Πάντα απενεργοποιημένη.

Η πρώτη γραμμή του log λέει αν είναι ενεργή και γιατί.

Scopes των κλειδιών API

Φτιάξε ένα κλειδί στο Settings > API > API keys και στείλε το στην κεφαλίδα X-Api-Key.

Scope	Φτάνει σε
read	Βιβλιοθήκη, εργασίες, λήψεις, ιστορικό, υγεία, ρυθμίσεις. Τα μυστικά κρύβονται.
health_read	Μόνο τις καταστάσεις υγείας. Για εργαλεία παρακολούθησης.
write	Κάθε αλλαγή εκτός από τα admin routes και τα χειριστήρια.
admin	Άτομα, προσκλήσεις, όρια αιτημάτων, κλειδιά API, κωδικό πρόσβασης και έλεγχο δύο παραγόντων, ρυθμίσεις σύνδεσης, αντίγραφα ασφαλείας.
control	Τα χειριστήρια αυτής της σελίδας. Μόνο ο ιδιοκτήτης και οι διαχειριστές μπορούν να το δώσουν.
all	read, write και admin. Όχι control.

Ένα κλειδί δεν κάνει ποτέ περισσότερα από το άτομο που το έφτιαξε. Τα scopes δεν αλλάζουν αργότερα· φτιάξε νέο κλειδί. Κάθε route και το scope του: /api/v1/openapi.json.

Σχετικά

• Έλεγχοι υγείας
• Αντίγραφα ασφαλείας
• Διαδρομές API