Pag-troubleshoot

Hanapin ang sintomas mo, basahin ang dahilan, sundan ang solusyon. Ang pangalan ng container sa mga halimbawa ay holyarrs; gamitin ang sa iyo kung iba.

Unang 3 pagsusuri

1. Bantayan ang log: docker logs -f holyarrs. Nakatago ang mga sikreto. Pindutin ang Ctrl+C para huminto sa pagsubaybay; patuloy na tatakbo ang container.
2. Patakbuhin ang doctor: docker exec holyarrs /holyarrs doctor. Bawat linya ay may OK, WARN o FAIL, at sinasabi ng bawat WARN o FAIL kung paano ito aayusin.
3. Natigil pa rin? Mag-download ng support bundle at magtanong. Tingnan ang Humingi ng suporta.

Hindi maabot ang web page

Sintomas: hindi makakonekta ang browser sa http://your-server:6262.

Dahilan: nakahinto ang container, hindi naka-map ang port, o may proxy na humaharang.

Solusyon:

1. Patakbuhin ang docker ps. Dapat makita mo ang holyarrs na may 0.0.0.0:6262->6262.
2. Kung paulit-ulit itong nagre-restart, basahin ang docker logs holyarrs para sa dahilan.
3. Kung gumagamit ka ng path gaya ng /holyarrs, tingnan ang Reverse proxy at URL base.

Permission denied

Sintomas: sinasabi ng doctor na hindi masusulatan ang isang folder, o pumapalya ang mga import dahil sa error sa permiso.

Dahilan: hindi tugma ang owner ng folder sa host sa PUID at PGID.

Solusyon: patakbuhin ang chown na iminumungkahi ng doctor, o itakda ang PUID at PGID sa owner ng folder. Sa NAS, bigyan ang user na iyon ng read at write sa screen ng mga permiso. Tingnan ang NAS, Synology at Unraid.

Walang nagda-download

Sintomas: nananatiling kulang ang mga pamagat at walang umaabot sa downloader mo.

Dahilan: walang pinagkukunang sumasagot, hindi nakakonekta ang downloader, o walang release na pumasa sa mga patakaran mo sa pagpili.

Solusyon:

1. Buksan ang Settings > Downloaders at i-click ang Test (Subukan) sa downloader mo. Dapat pumasa ito.
2. Buksan ang Settings > Sources at i-click ang Test sa bawat pinagkukunan.
3. Sa pamagat, buksan ang Choose a release (Pumili ng release) para makita ang bawat resulta at ang mga dahilan kung bakit hindi ito napili.

Tingnan ang Downloaders at Mga Pinagkukunan.

Na-download pero hindi na-import

Sintomas: tapos na ang download sa downloader mo, pero wala pa ang pamagat sa Aklatan mo.

Dahilan: hindi makita ng HolyArrs ang file sa parehong path, hindi nito masulatan ang folder ng Aklatan, o kailangan ng desisyon ng import.

Solusyon:

1. Bigyan ang HolyArrs at ang downloader ng parehong download folder sa parehong path, gaya ng /downloads, o itakda ang Downloader’s path (path ng downloader) at HolyArrs’ path (path ng HolyArrs) sa downloader.
2. Patakbuhin ang doctor at ayusin ang anumang FAIL sa mga folder ng download o ng Aklatan.
3. Tingnan sa listahan ng mga download ang mga item na may markang Needs a decision (Kailangan ng desisyon), at aprubahan o itapon ang plano.

Mga kopya ang import, hindi hardlink

Sintomas: sinasabi ng doctor na hindi gumagana ang mga hardlink, o dumodoble ang gamit ng disk pagkatapos ng mga import.

Dahilan: nasa magkaibang disk o mount ang mga folder ng download at ng Aklatan, o hindi kayang mag-hardlink ng disk (DrivePool, maraming NAS at SMB share, Docker Desktop sa Windows). Isang beses pa rin isinusulat ang bawat file. Inililipat ang mga natapos na download sa Usenet kapag iisang disk sila ng Aklatan.

Solusyon: i-mount ang isang pinagsasaluhang parent folder sa container sa halip na magkakahiwalay. Tingnan ang Mga folder.

Hindi nagsisimula ang HolyArrs

Sintomas: humihinto o nagre-restart agad ang container.

Dahilan: nakasulat sa log. Karaniwan: /config sa network share o FUSE path, o sirang bahagi.

Solusyon:

1. Ilipat ang /config sa lokal na disk kung iyon ang sinasabi ng log. Hindi pinapatakbo ng HolyArrs ang database nito sa isang share.
2. Kung hindi, magsimula sa safe mode, ayusin ito mula sa Settings, at mag-restart nang normal.

May kulang na tampok

Sintomas: wala sa app ang isang tampok na nabasa mo.

Dahilan: posibleng hindi pa ito bukas sa bersyong ito.

Solusyon: tingnan ang Mga tampok na hindi pa bukas.

Walang pangalan o larawan ang mga page

Sintomas: lumalabas ang mga pamagat nang walang poster o detalye.

Dahilan: hindi maabot ang metadata server.

Solusyon: suriin ang DNS at firewall mo. Ipinapakita ng seksyong Network ng doctor kung sumasagot ang server.

Para sa mga eksperto

Mga pagsusuri at opsyon ng doctor

Tumatakbo ang doctor sa loob ng container bilang parehong user ng HolyArrs, kaya nakikita nito ang nakikita ng HolyArrs.

Seksyon	Ipinapakita
App	Bersyon, user at group, umask, kung tumatakbo ba ito sa container.
Config folder	Owner, permiso, libreng espasyo, kung nasa lokal na disk ba ito.
Mga folder ng Aklatan at download	Umiiral ba, owner, masusulatan ba, libreng espasyo, mga hardlink sa pagitan ng mga folder ng download at ng Aklatan.
Network	Kung nare-resolve ang pangalan ng metadata server at sumasagot ba ito.
Clock	Oras, time zone (TZ), babala kapag malinaw na mali ang clock.

Opsyon	Ano ang ginagawa
-config <folder>	Sinusuri ang ibang config folder ng HolyArrs bukod sa /config.
-json	Inilalabas ang ulat bilang JSON.

Ang exit code 0 ay nangangahulugang walang pumalya; ang 1 ay nangangahulugang may linyang may FAIL. Hindi kailanman ipinapakita ng ulat ang mga key, password o token. Nagbabasa lang ito, maliban sa isang maliit na test file na isinusulat at binubura nito. Kapag sinimulan bilang root, ibinibigay din nito ang config folder kay PUID:PGID, gaya ng normal na simula.

Kung paulit-ulit na nagre-restart ang HolyArrs, pumapalya ang docker exec. Patakbuhin ang doctor sa bagong container na may parehong mga folder:

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

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

Pagsusuri ng mga folder sa simula

Sa simula, sinusuri ng HolyArrs ang mga folder nito at nagla-log ng isang linya ng buod, gaya ng folders: 4 ok, 1 not writable, tapos isang linya bawat folder na may problema kasama ang solusyon. Humihinto ang pagsusuri pagkatapos ng 3 segundo para hindi kailanman ma-hang ang pagsisimula. Ang folder na masyadong mabagal sumagot ay ituturing na hindi nasuri; madalas itong disk na gumigising mula sa sleep o mabagal na network share. Sinusuri ito ng doctor nang walang limitasyon sa oras. Tingnan ang Mga log.

Walang shell sa image

Ang laman lang ng image ay ang programa ng HolyArrs, kaya maliit ito at mas kaunti ang mapapakinabangan ng umaatake. Sadyang pumapalya ang docker exec holyarrs sh. Para tumingin nang mas malapitan, magsimula ng pansamantalang helper sa tabi nito:

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

Nakikita nito ang proseso ng HolyArrs, ginagamit ang network nito at may parehong mga folder sa parehong path. Tumatakbo ito bilang root, kaya tumingin lang at huwag magbago: ang file na isinulat bilang root ay maaaring hindi mabasa ng HolyArrs. Para sumubok bilang user ng HolyArrs, idagdag ang --user <PUID>:<PGID>.

Alamin ang bersyon

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

Ipinapakita rin ito ng seksyong App ng doctor.

Kaugnay

• Humingi ng suporta
• Mga log
• Mga pagsusuri ng kalusugan