Hibaelhárítás

Keresd meg a tünetet, olvasd el az okot, kövesd a megoldást. A példák a holyarrs containernevet használják; ha a tiéd más, azt írd be.

Az első 3 ellenőrzés

1. Nézd a logot: docker logs -f holyarrs. A titkok el vannak takarva. A követés leállításához nyomd meg a Ctrl+C-t; a container tovább fut.
2. Futtasd a doctort: docker exec holyarrs /holyarrs doctor. Minden sor végén OK, WARN vagy FAIL áll, és minden WARN vagy FAIL megmondja, hogyan javítható.
3. Még mindig elakadtál? Töltsd le a támogatási csomagot, és kérj segítséget. Lásd: Támogatás kérése.

Nem érem el a weboldalt

Tünet: a böngésző nem tud csatlakozni a http://your-server:6262 címre.

Ok: a container le van állítva, a port nincs leképezve, vagy egy proxy áll az útban.

Megoldás:

1. Futtasd a docker ps parancsot. A holyarrs containert kell látnod 0.0.0.0:6262->6262 porttal.
2. Ha folyton újraindul, az okot a docker logs holyarrs mutatja.
3. Ha olyan útvonalat használsz, mint a /holyarrs, lásd: Reverse proxy és URL base.

Permission denied

Tünet: a doctor szerint egy mappa nem írható, vagy az importok jogosultsági hibával elbuknak.

Ok: a mappa tulajdonosa a gépen nem egyezik a PUID és PGID értékével.

Megoldás: futtasd a doctor által javasolt chown parancsot, vagy állítsd a PUID és PGID értékét a mappa tulajdonosára. NAS-on adj ennek a felhasználónak olvasási és írási jogot a jogosultságok képernyőjén. Lásd: NAS, Synology és Unraid.

Semmi sem tölt le

Tünet: a címek hiányozva maradnak, és semmi sem jut el a letöltődhöz.

Ok: egyetlen forrás sem válaszol, a letöltő nincs csatlakoztatva, vagy egyetlen Release sem felel meg a választási szabályoknak.

Megoldás:

1. Nyisd meg a Settings > Downloaders (Beállítások > Letöltők) oldalt, és kattints a letöltődnél a Test (teszt) gombra. Sikeresnek kell lennie.
2. Nyisd meg a Settings > Sources (Beállítások > Források) oldalt, és kattints minden forrásnál a Test gombra.
3. A címnél nyisd meg a Choose a release (Release kiválasztása) nézetet: ott látod az összes találatot és azt, miért nem lett kiválasztva.

Lásd: Letöltők és Források.

Letöltött, de nem importálódott

Tünet: a letöltés befejeződött a letöltődben, de a cím nincs a Médiatárban.

Ok: a HolyArrs nem látja a fájlt ugyanazon az útvonalon, nem tud írni a Médiatár-mappába, vagy az importnak döntésre van szüksége.

Megoldás:

1. Add a HolyArrsnak és a letöltőnek ugyanazt a letöltési mappát ugyanazon az útvonalon, például /downloads, vagy állítsd be a Downloader’s path (a letöltő útvonala) és a HolyArrs’ path (a HolyArrs útvonala) mezőt a letöltőnél.
2. Futtasd a doctort, és javíts ki minden FAIL sort a letöltési vagy a Médiatár-mappáknál.
3. Nézd meg a letöltések listájában a Needs a decision (döntésre vár) jelölésű elemeket, és hagyd jóvá vagy vesd el a tervet.

Az importok másolatok, nem hardlinkek

Tünet: a doctor szerint a hardlinkek (kemény hivatkozások) nem működnek, vagy az importok után megduplázódik a lemezhasználat.

Ok: a letöltési és a Médiatár-mappák különböző lemezeken vagy csatolásokon vannak, vagy a lemez nem tud hardlinket készíteni (DrivePool, sok NAS és SMB-megosztás, Docker Desktop Windowson). Minden fájl ettől még csak egyszer íródik ki. A kész Usenet-letöltések átkerülnek, ha ugyanazon a lemezen vannak, mint a Médiatár.

Megoldás: külön csatolások helyett egyetlen közös szülőmappát csatolj be a containerbe. Lásd: Mappák.

A HolyArrs nem indul el

Tünet: a container leáll, vagy azonnal újraindul.

Ok: a log megnevezi. Gyakori okok: a /config hálózati megosztáson vagy FUSE-útvonalon van, vagy egy rész elromlott.

Megoldás:

1. Ha a log erre utal, tedd át a /config mappát helyi lemezre. A HolyArrs nem futtatja az adatbázisát hálózati megosztáson.
2. Egyébként indítsd biztonságos módban, javítsd ki a Settings (Beállítások) oldalon, és indítsd újra normál módon.

Hiányzik egy funkció

Tünet: egy funkció, amelyről olvastál, nincs az appban.

Ok: lehet, hogy ebben a verzióban későbbre halasztották.

Megoldás: lásd: Későbbre halasztott funkciók.

Az oldalakon nincsenek nevek vagy képek

Tünet: a címek poszterek és részletek nélkül jelennek meg.

Ok: a metaadat-szerver nem érhető el.

Megoldás: ellenőrizd a DNS-t és a tűzfalat. A doctor Network szakasza megmutatja, válaszol-e a szerver.

Haladóknak

Doctor-ellenőrzések és kapcsolók

A doctor a containeren belül, ugyanazzal a felhasználóval fut, mint a HolyArrs, így ugyanazokba ütközik, mint a HolyArrs.

Szakasz	Mit mutat
App	Verzió, felhasználó és csoport, umask, containerben fut-e.
Config folder	Tulajdonos, jogok, szabad hely, helyi lemezen van-e.
Library and download folders	Létezik-e, tulajdonos, írható-e, szabad hely, hardlinkek a letöltési és a Médiatár-mappák között.
Network	A metaadat-szerver neve feloldódik-e, és válaszol-e.
Clock	Idő, időzóna (TZ), figyelmeztetés, ha az óra egyértelműen téves.

Kapcsoló	Mit csinál
-config <folder>	A /config helyett másik HolyArrs konfigurációs mappát ellenőriz.
-json	A jelentést JSON-ként írja ki.

A 0-s kilépési kód azt jelenti, hogy semmi sem bukott el; az 1-es azt, hogy egy sor FAIL. A jelentés soha nem mutat kulcsokat, jelszavakat vagy tokeneket. Csak olvas, kivéve egy kis tesztfájlt, amelyet létrehoz, majd töröl. Rootként indítva a konfigurációs mappát is átadja a PUID:PGID felhasználónak, mint egy normál indítás.

Ha a HolyArrs folyton újraindul, a docker exec nem működik. Futtasd a doctort egy új containerben, ugyanazokkal a mappákkal:

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

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

Indításkori mappaellenőrzés

Indításkor a HolyArrs ellenőrzi a mappáit, és egy összegző sort ír a logba, például folders: 4 ok, 1 not writable, majd egy sort minden problémás mappáról, javítási javaslattal. Az ellenőrzés 3 másodperc után leáll, így az indítás soha nem akad meg. Az a mappa, amely túl lassan válaszol, nem ellenőrzöttnek számít; ez gyakran alvásból ébredő lemez vagy lassú hálózati megosztás. A doctor időkorlát nélkül ellenőrzi. Lásd: Logok.

Nincs shell az imageben

Az image csak a HolyArrs programot tartalmazza, így kicsi marad, és kevesebbet kínál egy támadónak. A docker exec holyarrs sh szándékosan nem működik. Alaposabb vizsgálathoz indíts mellé egy eldobható segédet:

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

Látja a HolyArrs folyamatot, osztozik a hálózatán, és ugyanazok a mappák vannak ugyanazokon az útvonalakon. Rootként fut, ezért csak nézelődj, ne módosíts: a rootként írt fájlt a HolyArrs esetleg nem tudja olvasni. A HolyArrs felhasználójaként való teszteléshez add hozzá a --user <PUID>:<PGID> kapcsolót.

A verzió megkeresése

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

A doctor App szakasza ugyanezt mutatja.

Kapcsolódó oldalak

• Támogatás kérése
• Logok
• Állapotellenőrzések