Resolução de problemas

Encontra o teu sintoma, lê a causa, segue a solução. Os exemplos usam o nome de contentor holyarrs; usa o teu se for diferente.

3 primeiras verificações

1. Vê o registo (log): docker logs -f holyarrs. Os segredos aparecem mascarados. Prime Ctrl+C para deixar de acompanhar; o contentor continua a funcionar.
2. Executa o doctor: docker exec holyarrs /holyarrs doctor. Cada linha diz OK, WARN ou FAIL, e cada WARN ou FAIL diz como resolver.
3. Continuas encalhado? Transfere um pacote de suporte e pede ajuda. Vê Obter suporte.

Não consigo chegar à página web

Sintoma: o navegador não consegue ligar-se a http://your-server:6262.

Causa: o contentor está parado, a porta não está mapeada ou há um proxy pelo meio.

Solução:

1. Executa docker ps. Deves ver holyarrs com 0.0.0.0:6262->6262.
2. Se ficar sempre a reiniciar, lê docker logs holyarrs para saber o motivo.
3. Se usas um caminho como /holyarrs, vê Proxy inverso e URL base.

Permissão negada

Sintoma: o doctor diz que uma pasta não tem permissão de escrita, ou as importações falham com um erro de permissão.

Causa: o dono da pasta no host não corresponde a PUID e PGID.

Solução: executa o chown que o doctor sugere, ou define PUID e PGID como o dono da pasta. Num NAS, dá a esse utilizador leitura e escrita no ecrã de permissões. Vê NAS, Synology e Unraid.

Nada é transferido

Sintoma: os títulos continuam em falta e nada chega ao teu gestor de transferências.

Causa: nenhuma fonte responde, o gestor de transferências não está ligado, ou nenhum lançamento passa as tuas regras de escolha.

Solução:

1. Abre Settings > Downloaders (Definições > Gestores de transferências) e clica em Test (Testar) no teu gestor de transferências. Deve passar.
2. Abre Settings > Sources (Definições > Fontes) e clica em Test em cada fonte.
3. No título, abre Choose a release (Escolher um lançamento) para ver todos os resultados e os motivos por que não foram escolhidos.

Vê Gestores de transferências e Fontes.

Transferido mas não importado

Sintoma: a transferência terminou no teu gestor de transferências, mas o título não está na tua Biblioteca.

Causa: o HolyArrs não vê o ficheiro no mesmo caminho, não consegue escrever na pasta da Biblioteca, ou a importação precisa de uma decisão.

Solução:

1. Dá ao HolyArrs e ao gestor de transferências a mesma pasta de transferências no mesmo caminho, como /downloads, ou define Downloader’s path (Caminho do gestor de transferências) e HolyArrs’ path (Caminho do HolyArrs) no gestor de transferências.
2. Executa o doctor e resolve qualquer FAIL nas pastas de transferências ou da Biblioteca.
3. Verifica na lista de transferências se há itens marcados como Needs a decision (Precisa de uma decisão), e aprova ou descarta o plano.

As importações são cópias, não hardlinks

Sintoma: o doctor diz que os hardlinks não funcionam, ou o uso de disco duplica depois das importações.

Causa: as pastas de transferências e da Biblioteca estão em discos ou montagens diferentes, ou o disco não consegue fazer hardlinks (DrivePool, muitos NAS e partilhas SMB, Docker Desktop no Windows). Cada ficheiro continua a ser escrito uma só vez. As transferências de Usenet terminadas são movidas quando partilham um disco com a Biblioteca.

Solução: monta uma pasta-mãe partilhada no contentor, em vez de várias separadas. Vê Pastas.

O HolyArrs não arranca

Sintoma: o contentor pára ou reinicia logo.

Causa: o registo diz qual é. As mais comuns: /config numa partilha de rede ou num caminho FUSE, ou uma parte avariada.

Solução:

1. Passa /config para um disco local se o registo o indicar. O HolyArrs não corre a sua base de dados numa partilha.
2. Caso contrário, arranca em modo de segurança, resolve a partir das Settings (Definições) e reinicia normalmente.

Falta uma funcionalidade

Sintoma: uma funcionalidade sobre a qual leste não está na app.

Causa: pode estar retida nesta versão.

Solução: vê Funcionalidades retidas.

As páginas não têm nomes nem imagens

Sintoma: os títulos aparecem sem cartazes nem detalhes.

Causa: não é possível chegar ao servidor de metadados.

Solução: verifica o teu DNS e a firewall. A secção Network do doctor mostra se o servidor responde.

Para especialistas

Verificações e opções do doctor

O doctor corre dentro do contentor, com o mesmo utilizador com que o HolyArrs corre, por isso encontra o que o HolyArrs encontra.

Secção	Mostra
App	Versão, utilizador e grupo, umask, se corre num contentor.
Config folder	Dono, permissões, espaço livre, se está num disco local.
Library and download folders	Se existe, dono, se tem permissão de escrita, espaço livre, hardlinks entre as pastas de transferências e da Biblioteca.
Network	Se o nome do servidor de metadados resolve e se ele responde.
Clock	Hora, fuso horário (TZ), um aviso quando o relógio está claramente errado.

Opção	O que faz
-config <folder>	Verifica outra pasta de configuração do HolyArrs que não /config.
-json	Imprime o relatório em JSON.

O código de saída 0 significa que nada falhou; 1 significa que uma linha diz FAIL. O relatório nunca mostra chaves, palavras-passe nem tokens. Só lê, exceto um pequeno ficheiro de teste que escreve e apaga. Se for iniciado como root, também entrega a pasta de configuração a PUID:PGID, como num arranque normal.

Se o HolyArrs não pára de reiniciar, o docker exec falha. Executa o doctor num contentor novo com as mesmas pastas:

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

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

Verificação das pastas no arranque

No arranque, o HolyArrs verifica as suas pastas e regista uma linha de resumo, como folders: 4 ok, 1 not writable, e depois uma linha por pasta com problema, com a solução. A verificação pára ao fim de 3 segundos, para o arranque nunca ficar preso. Uma pasta demasiado lenta a responder conta como não verificada; muitas vezes é um disco a acordar do repouso ou uma partilha de rede lenta. O doctor verifica-a sem limite de tempo. Vê Registos.

Sem shell na imagem

A imagem tem apenas o programa HolyArrs, por isso fica pequena e deixa menos a um atacante. docker exec holyarrs sh falha por desenho. Para ver mais de perto, inicia um auxiliar descartável ao lado:

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

Vê o processo do HolyArrs, partilha a sua rede e tem as mesmas pastas nos mesmos caminhos. Corre como root, por isso só olha, não alteres: um ficheiro escrito como root pode ficar ilegível para o HolyArrs. Para testar como o utilizador do HolyArrs, acrescenta --user <PUID>:<PGID>.

Descobrir a versão

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

A secção App do doctor mostra o mesmo.

Relacionado

• Obter suporte
• Registos
• Verificações de saúde