Depanare

Găsește-ți simptomul, citește cauza, urmează soluția. Exemplele folosesc numele de container holyarrs; folosește-l pe al tău dacă diferă.

Primele 3 verificări

1. Urmărește jurnalul (log): docker logs -f holyarrs. Secretele sunt ascunse. Apasă Ctrl+C ca să nu-l mai urmărești; containerul rămâne pornit.
2. Rulează doctorul: docker exec holyarrs /holyarrs doctor. Fiecare linie spune OK, WARN sau FAIL, iar fiecare WARN sau FAIL spune cum se repară.
3. Tot nu merge? Descarcă un pachet de suport și cere ajutor. Vezi Cere ajutor.

Nu pot ajunge la pagina web

Simptom: browserul nu se poate conecta la http://your-server:6262.

Cauză: containerul e oprit, portul nu e mapat sau în drum e un proxy.

Soluție:

1. Rulează docker ps. Ar trebui să vezi holyarrs cu 0.0.0.0:6262->6262.
2. Dacă tot repornește, citește docker logs holyarrs ca să afli motivul.
3. Dacă folosești o cale ca /holyarrs, vezi Proxy invers și URL base.

Permisiune refuzată

Simptom: doctorul spune că un dosar nu se poate scrie sau importurile pică cu o eroare de permisiune.

Cauză: proprietarul dosarului de pe gazdă nu se potrivește cu PUID și PGID.

Soluție: rulează comanda chown pe care o sugerează doctorul sau setează PUID și PGID la proprietarul dosarului. Pe un NAS, dă acelui utilizator citire și scriere în ecranul de permisiuni. Vezi NAS, Synology și Unraid.

Nu se descarcă nimic

Simptom: titlurile rămân printre cele care lipsesc și nimic nu ajunge la programul tău de descărcare.

Cauză: nicio sursă nu răspunde, programul de descărcare nu e conectat sau nicio variantă nu trece de regulile tale de alegere.

Soluție:

1. Deschide Settings > Downloaders (Setări > programe de descărcare) și apasă Test (testează) la programul tău de descărcare. Ar trebui să treacă.
2. Deschide Settings > Sources (Setări > surse) și apasă Test la fiecare sursă.
3. La titlu, deschide Choose a release (alege o variantă) ca să vezi toate rezultatele și motivele pentru care nu au fost alese.

Vezi Programe de descărcare și Surse.

Descărcat, dar neimportat

Simptom: descărcarea s-a terminat în programul de descărcare, dar titlul nu e în Bibliotecă.

Cauză: HolyArrs nu vede fișierul la aceeași cale, nu poate scrie în dosarul Bibliotecii sau importul cere o decizie.

Soluție:

1. Dă-i lui HolyArrs și programului de descărcare același dosar de descărcări, la aceeași cale, de exemplu /downloads, sau setează Downloader’s path (calea programului de descărcare) și HolyArrs’ path (calea lui HolyArrs) în programul de descărcare.
2. Rulează doctorul și repară orice FAIL la dosarele de descărcări sau ale Bibliotecii.
3. Uită-te în lista de descărcări după elemente marcate Needs a decision (cere o decizie) și aprobă sau renunță la plan.

Importurile sunt copii, nu hardlink-uri

Simptom: doctorul spune că hardlink-urile (legăturile fizice) nu merg sau folosirea discului se dublează după importuri.

Cauză: dosarele de descărcări și ale Bibliotecii sunt pe discuri sau montări diferite, sau discul nu poate face hardlink (DrivePool, multe NAS-uri și dosare partajate SMB, Docker Desktop pe Windows). Fiecare fișier tot se scrie o singură dată. Descărcările Usenet terminate se mută când stau pe același disc cu Biblioteca.

Soluție: montează în container un singur dosar părinte comun, în loc de dosare separate. Vezi Dosare.

HolyArrs nu pornește

Simptom: containerul se oprește sau repornește pe loc.

Cauză: o spune jurnalul. Cele mai frecvente: /config pe un dosar partajat în rețea sau o cale FUSE, ori o parte stricată.

Soluție:

1. Mută /config pe un disc local dacă așa spune jurnalul. HolyArrs nu își rulează baza de date pe un dosar partajat.
2. Altfel, pornește în mod sigur, repară din Settings (Setări) și repornește normal.

Lipsește o funcție

Simptom: o funcție despre care ai citit nu e în aplicație.

Cauză: poate fi reținută în această versiune.

Soluție: vezi Funcții reținute.

Paginile nu au nume sau poze

Simptom: titlurile apar fără postere sau detalii.

Cauză: serverul de metadate nu poate fi atins.

Soluție: verifică DNS-ul și firewall-ul. Secțiunea Network (rețea) din doctor arată dacă serverul răspunde.

Pentru experți

Verificările doctorului și opțiunile

Doctorul rulează în container, cu același utilizator cu care rulează HolyArrs, așa că dă peste aceleași probleme ca HolyArrs.

Secțiune	Arată
App (aplicația)	Versiunea, utilizatorul și grupul, umask, dacă rulează într-un container.
Config folder (dosarul de configurare)	Proprietarul, permisiunile, spațiul liber, dacă e pe un disc local.
Library and download folders (dosarele Bibliotecii și ale descărcărilor)	Există, proprietarul, se poate scrie, spațiul liber, hardlink-uri între dosarele de descărcări și ale Bibliotecii.
Network (rețea)	Dacă numele serverului de metadate se rezolvă și dacă acesta răspunde.
Clock (ceasul)	Ora, fusul orar (TZ), un avertisment când ceasul e clar greșit.

Opțiune	Ce face
-config <folder>	Verifică alt dosar de configurare HolyArrs decât /config.
-json	Afișează raportul ca JSON.

Codul de ieșire 0 înseamnă că nimic n-a picat; 1 înseamnă că o linie spune FAIL. Raportul nu arată niciodată chei, parole sau token-uri. Doar citește, în afară de un mic fișier de test pe care îl scrie și îl șterge. Dacă e pornit ca root, predă și dosarul de configurare lui PUID:PGID, ca la o pornire normală.

Dacă HolyArrs tot repornește, docker exec eșuează. Rulează doctorul într-un container nou, cu aceleași dosare:

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

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

Verificarea dosarelor la pornire

La pornire, HolyArrs își verifică dosarele și scrie în jurnal o linie de rezumat, de exemplu folders: 4 ok, 1 not writable, apoi câte o linie pentru fiecare dosar cu probleme, cu o soluție. Verificarea se oprește după 3 secunde, ca pornirea să nu rămână blocată. Un dosar prea lent la răspuns se socotește neverificat; de multe ori e un disc care se trezește din somn sau un dosar partajat lent în rețea. Doctorul îl verifică fără limită de timp. Vezi Jurnale.

Fără shell în imagine

Imaginea conține doar programul HolyArrs, ca să rămână mică și să-i lase mai puțin unui atacator. docker exec holyarrs sh eșuează intenționat. Ca să te uiți mai de aproape, pornește alături un ajutor temporar:

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

Vede procesul HolyArrs, folosește aceeași rețea și are aceleași dosare, la aceleași căi. Rulează ca root, așa că doar uită-te, nu schimba nimic: un fișier scris ca root poate să nu fie citibil pentru HolyArrs. Ca să testezi ca utilizatorul HolyArrs, adaugă --user <PUID>:<PGID>.

Află versiunea

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

Secțiunea App din doctor arată același lucru.

Vezi și

• Cere ajutor
• Jurnale
• Verificări de sănătate