Resolució de problemes

Busca el teu símptoma, llegeix la causa i segueix la solució. Els exemples fan servir el nom de contenidor holyarrs; fes servir el teu si és diferent.

Les 3 primeres comprovacions

1. Mira el registre (log): docker logs -f holyarrs. Els secrets surten emmascarats. Prem Ctrl+C per deixar de seguir-lo; el contenidor continua funcionant.
2. Executa el doctor: docker exec holyarrs /holyarrs doctor. Cada línia diu OK, WARN o FAIL, i cada WARN o FAIL explica com arreglar-ho.
3. Continues encallat? Baixa un paquet de suport i demana ajuda. Mira Obtenir ajuda.

No puc arribar a la pàgina web

Símptoma: el navegador no pot connectar a http://your-server:6262.

Causa: el contenidor està aturat, el port no està mapat o hi ha un proxy pel mig.

Solució:

1. Executa docker ps. Hauries de veure holyarrs amb 0.0.0.0:6262->6262.
2. Si es reinicia sense parar, llegeix docker logs holyarrs per saber-ne el motiu.
3. Si fas servir una ruta com /holyarrs, mira Proxy invers i URL base.

Permís denegat

Símptoma: el doctor diu que no es pot escriure en una carpeta, o les importacions fallen amb un error de permís.

Causa: el propietari de la carpeta al host no coincideix amb PUID i PGID.

Solució: executa el chown que et suggereix el doctor, o posa a PUID i PGID els del propietari de la carpeta. En un NAS, dona a aquest usuari lectura i escriptura a la pantalla de permisos. Mira NAS, Synology i Unraid.

No es baixa res

Símptoma: els títols continuen marcats com a Falten i no arriba res al teu gestor de baixades.

Causa: cap font respon, el gestor de baixades no està connectat o cap llançament passa les teves Regles d’elecció.

Solució:

1. Obre Settings > Downloaders (Paràmetres > Gestors de baixades) i clica a Test (provar) al teu gestor de baixades. Hauria de passar.
2. Obre Settings > Sources (Paràmetres > Fonts) i clica a Test a cada font.
3. Al títol, obre Choose a release (triar un llançament) per veure tots els resultats i els motius pels quals no s’ha triat cap.

Mira Gestors de baixades i Fonts.

Baixat però no importat

Símptoma: la baixada ha acabat al gestor de baixades, però el títol no és a la teva Biblioteca.

Causa: HolyArrs no veu el fitxer a la mateixa ruta, no pot escriure a la carpeta de la Biblioteca o la importació necessita una decisió.

Solució:

1. Dona a HolyArrs i al gestor de baixades la mateixa carpeta de baixades a la mateixa ruta, com ara /downloads, o omple Downloader’s path (ruta del gestor de baixades) i HolyArrs’ path (ruta d’HolyArrs) al gestor de baixades.
2. Executa el doctor i arregla qualsevol FAIL de les carpetes de baixades o de la Biblioteca.
3. Mira a la llista de baixades si hi ha elements marcats com a Needs a decision (cal una decisió), i aprova o descarta el pla.

Les importacions són còpies, no hardlinks

Símptoma: el doctor diu que els hardlinks no funcionen, o l’ús del disc es dobla després de les importacions.

Causa: les carpetes de baixades i de la Biblioteca són en discs o muntatges diferents, o el disc no pot fer hardlinks (DrivePool, molts NAS i carpetes compartides SMB, Docker Desktop a Windows). Cada fitxer s’escriu igualment una sola vegada. Les baixades d’Usenet acabades es mouen quan comparteixen disc amb la Biblioteca.

Solució: munta una sola carpeta pare compartida al contenidor en lloc de carpetes separades. Mira Carpetes.

HolyArrs no s’inicia

Símptoma: el contenidor s’atura o es reinicia a l’instant.

Causa: el registre la diu. Les més habituals: /config en una carpeta compartida de xarxa o una ruta FUSE, o una part trencada.

Solució:

1. Mou /config a un disc local si el registre ho diu. HolyArrs no executarà la seva base de dades en una carpeta compartida.
2. Si no, inicia en mode segur, arregla-ho des de Settings (Paràmetres) i reinicia amb normalitat.

Falta una funció

Símptoma: una funció que has llegit no és a l’app.

Causa: pot ser que s’hagi retingut en aquesta versió.

Solució: mira Funcions retingudes.

Les pàgines no tenen noms ni imatges

Símptoma: els títols surten sense pòsters ni detalls.

Causa: no es pot arribar al servidor de metadades.

Solució: revisa el teu DNS i el tallafoc. La secció Network (xarxa) del doctor mostra si el servidor respon.

Per a experts

Comprovacions i opcions del doctor

El doctor s’executa dins del contenidor amb el mateix usuari amb què s’executa HolyArrs, així que topa amb el mateix que HolyArrs.

Secció	Mostra
App	Versió, usuari i grup, umask, si s’executa en un contenidor.
Config folder (carpeta de configuració)	Propietari, permisos, espai lliure, si és en un disc local.
Library and download folders (carpetes de la Biblioteca i de baixades)	Si existeix, propietari, si s’hi pot escriure, espai lliure, hardlinks entre les carpetes de baixades i de la Biblioteca.
Network (xarxa)	Si el nom del servidor de metadades es resol i si respon.
Clock (rellotge)	Hora, fus horari (TZ), un avís quan el rellotge està clarament malament.

Opció	Què fa
-config <folder>	Comprova una altra carpeta de configuració d’HolyArrs que no sigui /config.
-json	Imprimeix l’informe en JSON.

El codi de sortida 0 vol dir que res no ha fallat; 1 vol dir que una línia diu FAIL. L’informe mai mostra claus, contrasenyes ni tokens. Només llegeix, tret d’un petit fitxer de prova que escriu i elimina. Si s’inicia com a root, també passa la carpeta de configuració a PUID:PGID, com un inici normal.

Si HolyArrs es reinicia sense parar, docker exec falla. Executa el doctor en un contenidor nou amb les mateixes carpetes:

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

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

Comprovació de carpetes a l'inici

A l’inici, HolyArrs comprova les seves carpetes i registra una línia de resum, com ara folders: 4 ok, 1 not writable, i després una línia per cada carpeta amb problemes, amb la solució. La comprovació s’atura als 3 segons perquè l’inici no es quedi mai penjat. Una carpeta massa lenta per respondre compta com a no comprovada; sovint és un disc que es desperta del repòs o una carpeta compartida de xarxa lenta. El doctor la comprova sense límit de temps. Mira Registres.

Sense shell a la imatge

La imatge només porta el programa d’HolyArrs, així que es manté petita i deixa menys a un atacant. docker exec holyarrs sh falla expressament. Per mirar-ho de més a prop, inicia un ajudant d’un sol ús al costat:

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

Veu el procés d’HolyArrs, comparteix la seva xarxa i té les mateixes carpetes a les mateixes rutes. S’executa com a root, així que mira però no canviïs res: un fitxer escrit com a root pot quedar il·legible per a HolyArrs. Per provar com a usuari d’HolyArrs, afegeix --user <PUID>:<PGID>.

Trobar la versió

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

La secció App del doctor mostra el mateix.

Relacionat

• Obtenir ajuda
• Registres
• Comprovacions de salut