Rozwiązywanie problemów

Znajdź swój objaw, przeczytaj przyczynę, wykonaj rozwiązanie. W przykładach nazwa kontenera to holyarrs; jeśli twoja jest inna, użyj swojej.

Pierwsze 3 kontrole

1. Śledź log: docker logs -f holyarrs. Sekrety są zamaskowane. Naciśnij Ctrl+C, żeby przestać śledzić log; kontener działa dalej.
2. Uruchom doktora: docker exec holyarrs /holyarrs doctor. Każda linia mówi OK, WARN albo FAIL, a przy każdym WARN i FAIL jest napisane, jak to naprawić.
3. Nadal nie działa? Pobierz pakiet diagnostyczny i poproś o pomoc. Zobacz Uzyskaj wsparcie.

Nie mogę otworzyć strony webowej

Objaw: przeglądarka nie może połączyć się z http://your-server:6262.

Przyczyna: kontener jest zatrzymany, port nie jest zmapowany albo na drodze stoi proxy.

Rozwiązanie:

1. Wykonaj docker ps. Zobaczysz holyarrs z 0.0.0.0:6262->6262.
2. Jeśli kontener ciągle się restartuje, przeczytaj docker logs holyarrs, żeby poznać powód.
3. Jeśli używasz ścieżki, takiej jak /holyarrs, zobacz Reverse proxy i URL base.

Brak uprawnień

Objaw: doktor mówi, że folder nie jest zapisywalny, albo importy kończą się błędem uprawnień.

Przyczyna: właściciel folderu na hoście nie zgadza się z PUID i PGID.

Rozwiązanie: wykonaj polecenie chown, które proponuje doktor, albo ustaw PUID i PGID na właściciela folderu. Na NAS-ie nadaj temu użytkownikowi odczyt i zapis na ekranie uprawnień. Zobacz NAS, Synology i Unraid.

Nic się nie pobiera

Objaw: tytuły zostają jako brakujące i nic nie trafia do twojego downloadera.

Przyczyna: żadne źródło nie odpowiada, downloader nie jest podłączony albo żaden release nie przechodzi twoich reguł wyboru.

Rozwiązanie:

1. Otwórz Settings > Downloaders (Ustawienia > Downloadery) i kliknij Test (testuj) przy swoim downloaderze. Test powinien przejść.
2. Otwórz Settings > Sources (Ustawienia > Źródła) i kliknij Test przy każdym źródle.
3. Na stronie tytułu otwórz Choose a release (wybierz release), żeby zobaczyć wszystkie wyniki i powody, dla których żaden nie został wybrany.

Zobacz Downloadery i Źródła.

Pobrane, ale nie zaimportowane

Objaw: pobieranie skończyło się w twoim downloaderze, ale tytułu nie ma w twojej bibliotece.

Przyczyna: HolyArrs nie widzi pliku pod tą samą ścieżką, nie może zapisywać w folderze biblioteki albo import czeka na decyzję.

Rozwiązanie:

1. Daj aplikacji HolyArrs i downloaderowi ten sam folder pobierania pod tą samą ścieżką, na przykład /downloads, albo ustaw Downloader’s path (ścieżka downloadera) i HolyArrs’ path (ścieżka HolyArrs) w downloaderze.
2. Uruchom doktora i napraw każdy FAIL dotyczący folderów pobierania lub biblioteki.
3. Sprawdź na liście pobierań pozycje oznaczone Needs a decision (czeka na decyzję) i zatwierdź albo odrzuć plan.

Importy to kopie, nie hardlinki

Objaw: doktor mówi, że hardlinki nie działają, albo zajęte miejsce na dysku podwaja się po importach.

Przyczyna: foldery pobierań i biblioteki są na różnych dyskach lub punktach montowania.

Rozwiązanie: zamontuj w kontenerze jeden wspólny folder nadrzędny zamiast osobnych. Zobacz Foldery.

HolyArrs nie startuje

Objaw: kontener zatrzymuje się albo od razu się restartuje.

Przyczyna: wskazuje ją log. Najczęstsze: /config na udziale sieciowym lub ścieżce FUSE albo zepsuty moduł.

Rozwiązanie:

1. Jeśli tak mówi log, przenieś /config na dysk lokalny. HolyArrs nie uruchomi swojej bazy danych na udziale sieciowym.
2. W przeciwnym razie uruchom w trybie awaryjnym, napraw to w Settings (Ustawienia) i zrestartuj normalnie.

Brakuje funkcji

Objaw: funkcji, o której czytasz, nie ma w aplikacji.

Przyczyna: może być wstrzymana w tej wersji.

Rozwiązanie: zobacz Funkcje wstrzymane.

Strony bez nazw i obrazków

Objaw: tytuły pokazują się bez plakatów i szczegółów.

Przyczyna: serwer metadanych jest nieosiągalny.

Rozwiązanie: sprawdź DNS i zaporę sieciową. Sekcja Network (sieć) w doktorze pokazuje, czy serwer odpowiada.

Dla zaawansowanych

Kontrole doktora i opcje

Doktor działa w kontenerze jako ten sam użytkownik, z którym działa HolyArrs, więc trafia na to samo, na co trafia HolyArrs.

Sekcja	Pokazuje
App	Wersję, użytkownika i grupę, umask, czy działa w kontenerze.
Config folder	Właściciela, uprawnienia, wolne miejsce, czy jest na dysku lokalnym.
Library and download folders	Czy istnieje, właściciela, czy jest zapisywalny, wolne miejsce, hardlinki między folderami pobierań i biblioteki.
Network	Czy nazwa serwera metadanych się rozwiązuje i czy serwer odpowiada.
Clock	Czas, strefę czasową (TZ), ostrzeżenie, gdy zegar wyraźnie się myli.

Opcja	Co robi
-config <folder>	Sprawdza inny folder konfiguracji HolyArrs niż /config.
-json	Wypisuje raport jako JSON.

Kod wyjścia 0 oznacza, że nic nie zawiodło; 1 oznacza, że jakaś linia mówi FAIL. Raport nigdy nie pokazuje kluczy, haseł ani tokenów. Tylko czyta, poza małym plikiem testowym, który zapisuje i usuwa. Uruchomiony jako root, przekazuje też folder konfiguracji użytkownikowi PUID:PGID, tak jak zwykły start.

Jeśli HolyArrs ciągle się restartuje, docker exec nie zadziała. Uruchom doktora w nowym kontenerze z tymi samymi folderami:

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

Z Compose: docker compose run --rm holyarrs doctor.

Kontrola folderów przy starcie

Przy starcie HolyArrs sprawdza swoje foldery i zapisuje w logu jedną linię podsumowania, na przykład folders: 4 ok, 1 not writable, a potem po jednej linii na każdy problematyczny folder, razem z rozwiązaniem. Kontrola kończy się po 3 sekundach, żeby start się nigdy nie zawieszał. Folder, który odpowiada zbyt wolno, liczy się jako niesprawdzony; często to dysk budzący się z uśpienia albo wolny udział sieciowy. Doktor sprawdza go bez limitu czasu. Zobacz Logi.

Brak shella w image

Image zawiera tylko program HolyArrs, dzięki czemu jest mały i zostawia atakującemu mniej do wykorzystania. docker exec holyarrs sh celowo nie działa. Żeby przyjrzeć się z bliska, uruchom obok tymczasowy kontener pomocniczy:

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

Widzi on proces HolyArrs, dzieli jego sieć i ma te same foldery pod tymi samymi ścieżkami. Działa jako root, więc tylko patrz i nic nie zmieniaj: plik zapisany jako root może być nieczytelny dla HolyArrs. Żeby testować jako użytkownik HolyArrs, dodaj --user <PUID>:<PGID>.

Sprawdź wersję

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

To samo pokazuje sekcja App w doktorze.

Powiązane strony

• Uzyskaj wsparcie
• Logi
• Kontrole kondycji