O tópico original de julho de 2025 começou com uma falha na instalação do qBittorrent a partir da App Store e terminou com um contentor LinuxServer.io instalado manualmente. A versão resumida desta página anteriormente passava demasiado depressa de “a obtenção falhou” para “utilize o LinuxServer”. O tópico completo contém um desvio importante relacionado com a versão: a IceWhale pediu ao utilizador que testasse o ZimaOS 1.4.2 beta1 porque o comportamento de instalação de aplicações tinha sido melhorado nessa versão; a versão beta foi instalada, mas criou um novo problema relacionado com a GPU GTX 1070 do utilizador, que acabou por regressar à 1.4.1.
O contentor qBittorrent instalado manualmente funcionou suficientemente bem para o utilizador original, mas a solução alternativa histórica para a WebUI desativou a validação do cabeçalho Host e a proteção contra CSRF. Isto não deve ser adotado numa instalação atual como correção predefinida.
A falha original foi um problema ao obter a imagem
Um erro ao obter uma imagem é diferente de um contentor que inicia e depois falha. O objetivo da resolução de problemas é a referência da imagem, o acesso ao registo, a definição da App Store ou a camada de instalação de aplicações do ZimaOS.
A IceWhale sugeriu o ZimaOS 1.4.2 Beta1
A Zima-Giorgio pediu ao utilizador que experimentasse a então versão beta mais recente, a 1.4.2 beta1, porque essa versão melhorava a experiência de instalação de aplicações e poderia resolver o problema. Quando a atualização não apareceu automaticamente, a Giorgio forneceu o procedimento oficial de atualização offline para essa versão beta histórica.
Esses comandos pertencem a uma compilação de pré-lançamento de 2025 e não devem ser reutilizados num servidor atual. A sua importância é histórica: a IceWhale considerou que a falha ao obter a aplicação da App Store poderia estar relacionada com a versão do ZimaOS.
A versão beta criou um problema diferente para o utilizador
O utilizador instalou a versão beta, mas mais tarde voltou à 1.4.1 porque, nas suas palavras, a versão beta ignorava a GPU GTX 1070. Isto ilustra por que motivo uma atualização para uma versão beta apenas para corrigir uma aplicação deve incluir verificações de regressão para o restante servidor.
Um sistema atual deve utilizar a versão estável atual do ZimaOS, salvo se existir um motivo de suporte específico para testar uma versão de pré-lançamento.
O utilizador instalou então a imagem qBittorrent do LinuxServer.io
O qBittorrent atual do LinuxServer.io utiliza lscr.io/linuxserver/qbittorrent. As definições persistentes e de rede importantes incluem:
-
/configpara a configuração do qBittorrent; - uma pasta de transferências do anfitrião mapeada para o contentor;
- PUID e PGID para a propriedade dos ficheiros;
- uma porta WebUI;
- uma porta de escuta BitTorrent através de TCP e UDP.
Utilize as definições atuais do contentor qBittorrent do LinuxServer.io em vez de reconstruir mentalmente a configuração de 2025.
Mantenha WEBUI_PORT e o mapeamento de portas do Docker sincronizados
A imagem atual disponibiliza normalmente a WebUI na porta 8080. Se quiser utilizar outra porta no anfitrião, pode mapear essa porta do anfitrião para o serviço do contentor. Se a própria porta interna da WebUI for alterada, o LinuxServer.io exige que a WEBUI_PORT Faça corresponder o valor da variável de ambiente ao mapeamento de portas do Docker.
Uma porta WebUI incompatível pode causar falhas de ligação que parecem problemas de autenticação ou de cabeçalhos de segurança.
Utilize a palavra-passe temporária do registo de arranque
O utilizador que forneceu a fonte observou corretamente que a primeira palavra-passe pode ser encontrada nos registos. O comportamento atual do LinuxServer.io gera uma palavra-passe temporária para a admin conta no arranque.
Abra o registo do contentor do qBittorrent, utilize o valor temporário no primeiro início de sessão e defina imediatamente uma palavra-passe permanente na WebUI.
Não desative HostHeaderValidation e CSRFProtection por predefinição
O utilizador que forneceu a fonte histórica acrescentou:
WebUI\HostHeaderValidation=false
WebUI\CSRFProtection=falseao ficheiro de configuração do qBittorrent. Relataram que a aplicação pareceu funcionar depois disso, mas essas opções enfraquecem deliberadamente as verificações de segurança destinadas ao navegador.
Uma instalação atual deve começar por resolver a configuração correta da porta, do URL da WebUI, dos cabeçalhos do proxy inverso e da autenticação. Não transforme “desativar CSRF” na resposta padrão para um problema de acesso à WebUI.
Se estiver envolvido um proxy inverso, configure-o corretamente
Os erros relacionados com o cabeçalho Host surgem frequentemente quando uma aplicação é acedida através de um nome de anfitrião ou proxy que a WebUI não espera. Normalmente, a solução correta consiste em configurar de forma consistente o proxy e as definições da WebUI do qBittorrent, e não em desativar globalmente toda a validação.
O tráfego da WebUI e o tráfego entre pares do BitTorrent utilizam portas diferentes
A porta utilizada para administrar o qBittorrent num navegador não é a porta utilizada para ligações de entrada entre pares. Publique a porta de escuta de torrents escolhida através de TCP e UDP e faça corresponder-lhe a configuração da porta de escuta do próprio qBittorrent.
Se o servidor estiver atrás de NAT e for pretendida conectividade de entrada entre pares, o desenho do router ou da VPN é uma decisão separada do mapeamento de portas do Docker.
Mapeie as transferências para o armazenamento real do ZimaOS
Não deixe que torrents grandes se acumulem dentro da camada descartável do contentor ou num disco de sistema pequeno. Mapeie o diretório de transferências para o espaço de armazenamento pretendido do ZimaOS e confirme que o utilizador do contentor tem permissões de escrita nesse local antes de iniciar uma transferência grande.
Preserve /config antes de recriar o contentor
As preferências, categorias, caminhos e o estado da aplicação do qBittorrent encontram-se no diretório de configuração persistente. Faça uma cópia de segurança antes de alterar imagens ou substituir uma implementação da App Store por um contentor personalizado.
Perguntas frequentes sobre o qBittorrent no ZimaOS
O problema original era uma falha do qBittorrent?
Não. A instalação através da App Store falhou na fase de obtenção da imagem Docker.
Porque é que o utilizador voltou da versão beta para o ZimaOS 1.4.1?
Relataram que a versão beta não lidava com a GTX 1070 conforme esperado.
De onde vem a primeira palavra-passe do qBittorrent?
Atualmente, os contentores LinuxServer.io apresentam uma palavra-passe de administrador temporária no registo de arranque.
Deve a proteção contra CSRF ser desativada para fazer a WebUI funcionar?
Não como abordagem predefinida. Corrija primeiro a configuração atual da porta, do proxy, do nome do anfitrião e da autenticação.
