Επίλυση προβλημάτων

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

Οι πρώτοι 3 έλεγχοι

1. Δες το αρχείο καταγραφής (log): docker logs -f holyarrs. Τα μυστικά κρύβονται. Πάτησε Ctrl+C για να σταματήσεις την παρακολούθηση. Το container συνεχίζει να τρέχει.
2. Τρέξε το doctor: docker exec holyarrs /holyarrs doctor. Κάθε γραμμή γράφει OK, WARN ή FAIL, και κάθε WARN ή FAIL λέει πώς να το διορθώσεις.
3. Κόλλησες ακόμα; Κατέβασε ένα πακέτο υποστήριξης και ρώτα. Δες το Ζήτα υποστήριξη.

Δεν ανοίγει η ιστοσελίδα

Σύμπτωμα: το πρόγραμμα περιήγησης δεν συνδέεται στο http://your-server:6262.

Αιτία: το container είναι σταματημένο, η θύρα δεν είναι αντιστοιχισμένη ή μπροστά υπάρχει ένα proxy.

Λύση:

1. Τρέξε docker ps. Θα πρέπει να δεις το holyarrs με 0.0.0.0:6262->6262.
2. Αν ξαναξεκινά συνέχεια, διάβασε το docker logs holyarrs για να δεις γιατί.
3. Αν χρησιμοποιείς διαδρομή όπως το /holyarrs, δες το Reverse proxy και URL base.

Permission denied

Σύμπτωμα: το doctor λέει ότι δεν μπορεί να γραφτεί ένας φάκελος ή οι εισαγωγές αποτυγχάνουν με σφάλμα δικαιωμάτων.

Αιτία: ο ιδιοκτήτης του φακέλου στον host δεν ταιριάζει με τα PUID και PGID.

Λύση: τρέξε το chown που προτείνει το doctor ή βάλε στα PUID και PGID τον ιδιοκτήτη του φακέλου. Σε ένα NAS, δώσε σε αυτόν τον χρήστη δικαίωμα ανάγνωσης και εγγραφής στην οθόνη δικαιωμάτων. Δες το NAS, Synology και Unraid.

Τίποτα δεν κατεβαίνει

Σύμπτωμα: οι τίτλοι μένουν σε κατάσταση «λείπουν» και τίποτα δεν φτάνει στο πρόγραμμα λήψεων.

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

Λύση:

1. Άνοιξε Settings > Downloaders (Ρυθμίσεις > Προγράμματα λήψεων) και πάτησε Test (Δοκιμή) στο πρόγραμμα λήψεων σου. Θα πρέπει να περάσει.
2. Άνοιξε Settings > Sources (Ρυθμίσεις > Πηγές) και πάτησε Test σε κάθε πηγή.
3. Στον τίτλο, άνοιξε Choose a release (Επιλογή κυκλοφορίας) για να δεις όλα τα αποτελέσματα και τους λόγους που δεν επιλέχθηκαν.

Δες τα Προγράμματα λήψεων και τις Πηγές.

Κατέβηκε αλλά δεν εισήχθη

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

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

Λύση:

1. Δώσε στο HolyArrs και στο πρόγραμμα λήψεων τον ίδιο φάκελο λήψεων στην ίδια διαδρομή, για παράδειγμα /downloads, ή όρισε τα Downloader’s path (διαδρομή του προγράμματος λήψεων) και HolyArrs’ path (διαδρομή του HolyArrs) στο πρόγραμμα λήψεων.
2. Τρέξε το doctor και διόρθωσε κάθε FAIL στους φακέλους λήψεων ή Βιβλιοθήκης.
3. Έλεγξε στη λίστα λήψεων για στοιχεία με σήμανση Needs a decision (Περιμένει απόφαση) και έγκρινε ή απόρριψε το σχέδιο.

Οι εισαγωγές είναι αντίγραφα, όχι hardlinks

Σύμπτωμα: το doctor λέει ότι τα hardlinks (σκληροί σύνδεσμοι) δεν δουλεύουν ή ο χώρος στον δίσκο διπλασιάζεται μετά τις εισαγωγές.

Αιτία: οι φάκελοι λήψεων και Βιβλιοθήκης είναι σε διαφορετικούς δίσκους ή συνδέσεις φακέλων, ή ο δίσκος δεν μπορεί να κάνει hardlink (DrivePool, πολλά NAS και κοινόχρηστοι φάκελοι SMB, Docker Desktop στα Windows). Κάθε αρχείο γράφεται πάντα μία φορά. Οι ολοκληρωμένες λήψεις Usenet μετακινούνται όταν μοιράζονται δίσκο με τη Βιβλιοθήκη.

Λύση: σύνδεσε στο container έναν κοινό γονικό φάκελο, αντί για ξεχωριστούς. Δες τους Φακέλους.

Το HolyArrs δεν ξεκινά

Σύμπτωμα: το container σταματά ή ξαναξεκινά αμέσως.

Αιτία: το αρχείο καταγραφής την ονομάζει. Συνηθισμένες αιτίες: το /config σε κοινόχρηστο φάκελο δικτύου ή σε διαδρομή FUSE, ή μια ενότητα που χάλασε.

Λύση:

1. Μετακίνησε το /config σε τοπικό δίσκο αν το λέει το αρχείο καταγραφής. Το HolyArrs δεν τρέχει τη βάση δεδομένων του σε κοινόχρηστο φάκελο.
2. Αλλιώς ξεκίνα σε ασφαλή λειτουργία, διόρθωσέ το από τις Settings (Ρυθμίσεις) και ξαναξεκίνα κανονικά.

Λείπει μια λειτουργία

Σύμπτωμα: μια λειτουργία που διάβασες δεν υπάρχει στην εφαρμογή.

Αιτία: μπορεί να είναι κρατημένη σε αυτή την έκδοση.

Λύση: δες τις Κρατημένες λειτουργίες.

Οι σελίδες δεν έχουν ονόματα ή εικόνες

Σύμπτωμα: οι τίτλοι εμφανίζονται χωρίς αφίσες ή λεπτομέρειες.

Αιτία: δεν μπορεί να βρεθεί ο διακομιστής μεταδεδομένων.

Λύση: έλεγξε το DNS και το firewall σου. Η ενότητα Network του doctor δείχνει αν ο διακομιστής απαντά.

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

Έλεγχοι και επιλογές του doctor

Το doctor τρέχει μέσα στο container με τον ίδιο χρήστη που τρέχει το HolyArrs, οπότε πέφτει πάνω σε ό,τι πέφτει και το HolyArrs.

Ενότητα	Τι δείχνει
App	Έκδοση, χρήστη και ομάδα, umask, αν τρέχει μέσα σε container.
Config folder	Ιδιοκτήτη, δικαιώματα, ελεύθερο χώρο, αν είναι σε τοπικό δίσκο.
Library and download folders	Αν υπάρχουν, ιδιοκτήτη, αν γράφονται, ελεύθερο χώρο, hardlinks ανάμεσα στους φακέλους λήψεων και Βιβλιοθήκης.
Network	Αν το όνομα του διακομιστή μεταδεδομένων επιλύεται και αν απαντά.
Clock	Ώρα, ζώνη ώρας (TZ), προειδοποίηση όταν το ρολόι είναι φανερά λάθος.

Επιλογή	Τι κάνει
-config <folder>	Ελέγχει άλλον φάκελο ρυθμίσεων του HolyArrs αντί για το /config.
-json	Τυπώνει την αναφορά ως JSON.

Κωδικός εξόδου 0 σημαίνει ότι τίποτα δεν απέτυχε. Ο 1 σημαίνει ότι μια γραμμή γράφει FAIL. Η αναφορά δεν δείχνει ποτέ κλειδιά, κωδικούς ή tokens. Μόνο διαβάζει, εκτός από ένα μικρό αρχείο δοκιμής που γράφει και σβήνει. Αν ξεκινήσει ως root, δίνει επίσης τον φάκελο ρυθμίσεων στο PUID:PGID, όπως μια κανονική εκκίνηση.

Αν το HolyArrs ξαναξεκινά συνέχεια, το docker exec αποτυγχάνει. Τρέξε το doctor σε ένα νέο container με τους ίδιους φακέλους:

docker run --rm --volumes-from holyarrs -e PUID=<puid> -e PGID=<pgid> -e TZ=<tz> holyarrs/holyarrs:<tag> doctor

Με Compose: docker compose run --rm holyarrs doctor.

Έλεγχος φακέλων στην εκκίνηση

Στην εκκίνηση, το HolyArrs ελέγχει τους φακέλους του και γράφει μία γραμμή σύνοψης στο αρχείο καταγραφής, όπως folders: 4 ok, 1 not writable, και μετά μία γραμμή για κάθε φάκελο με πρόβλημα, με τη λύση. Ο έλεγχος σταματά μετά από 3 δευτερόλεπτα, ώστε η εκκίνηση να μην κολλά ποτέ. Ένας φάκελος που απαντά πολύ αργά μετράει ως μη ελεγμένος. Συχνά φταίει ένας δίσκος που ξυπνά από ύπνο ή ένας αργός κοινόχρηστος φάκελος δικτύου. Το doctor τον ελέγχει χωρίς χρονικό όριο. Δες τα Αρχεία καταγραφής.

Δεν υπάρχει shell στην image

Η image έχει μόνο το πρόγραμμα του HolyArrs, ώστε να μένει μικρή και να αφήνει λιγότερα σε έναν επιτιθέμενο. Το docker exec holyarrs sh αποτυγχάνει επίτηδες. Για πιο προσεκτική ματιά, ξεκίνα ένα προσωρινό βοηθητικό container δίπλα του:

docker run --rm -it --pid container:holyarrs --network container:holyarrs --volumes-from holyarrs busybox sh

Βλέπει τη διεργασία του HolyArrs, μοιράζεται το δίκτυό της και έχει τους ίδιους φακέλους στις ίδιες διαδρομές. Τρέχει ως root, οπότε κοίτα αλλά μην αλλάζεις τίποτα: ένα αρχείο που γράφτηκε ως root μπορεί να μην διαβάζεται από το HolyArrs. Για να δοκιμάσεις ως χρήστης του HolyArrs, πρόσθεσε --user <PUID>:<PGID>.

Βρες την έκδοση

docker inspect --format '{{ index .Config.Labels "org.opencontainers.image.version" }}' holyarrs

Το ίδιο δείχνει η ενότητα App του doctor.

Σχετικά

• Ζήτα υποστήριξη
• Αρχεία καταγραφής
• Έλεγχοι υγείας