Solução da comunidade

Defina a pasta de transferência correta do qBittorrent no ZimaOS

A ZimaOS user mapped qBittorrent downloads to a second drive but kept entering the ZimaOS host path inside qBittorrent. The confirmed fix was to use the Docker container path /downloads instead.

Se o qBittorrent continuar a guardar as transferências na unidade do sistema do ZimaOS mesmo depois de selecionar outro HDD nas definições da aplicação, verifique que caminho introduziu no próprio qBittorrent. No tópico da comunidade IceWhale de novembro de 2025, a unidade secundária já estava montada no contentor do qBittorrent, mas o utilizador introduziu o caminho do anfitrião do ZimaOS em vez do caminho do contentor Docker.

A solução confirmada foi simples: utilizar /downloads dentro do qBittorrent, não o caminho do anfitrião do ZimaOS, como /media/GERAL/downloads. Alterar o PUID/PGID para 0/0 não resolveu o caso original; corrigir o caminho resolveu-o, e o autor original confirmou explicitamente que as transferências funcionaram depois disso.

A diferença fundamental: caminho do anfitrião vs. caminho do contentor

Um mapeamento de volume do Docker tem dois lados:

CAMINHO_DO_ANFITRIÃO:CAMINHO_DO_CONTENTOR

Por exemplo:

/media/GERAL/downloads:/downloads

O ZimaOS vê o lado esquerdo. O qBittorrent é executado dentro do contentor e deve normalmente utilizar o lado direito.

Correto dentro do qBittorrent: /downloads
Incorreto dentro do qBittorrent:   /media/GERAL/downloads

O que o utilizador original tinha configurado

Definições do qBittorrent no ZimaOS a mostrar o mapeamento das transferências para a unidade secundária GERAL
A publicação original mostra o qBittorrent configurado com armazenamento na unidade secundária GERAL.
Definições de transferência do qBittorrent que utilizam um caminho do anfitrião do ZimaOS em vez do caminho do Docker
A definição do qBittorrent estava a utilizar um caminho do lado do anfitrião em vez do caminho do contentor montado.
Caminho de armazenamento do ZimaOS para a unidade GERAL utilizada pelo contentor do qBittorrent
O ZimaOS expõe o caminho físico do anfitrião, mas o qBittorrent não precisa de utilizar internamente essa mesma cadeia de caminho.
campo da pasta de transferências do qBittorrent, a partir do tópico de resolução de problemas do ZimaOS
A solução confirmada foi utilizar o caminho montado do contentor /downloads.

Porque alterar o PUID e o PGID não resolveu este caso

Uma resposta da comunidade sugeriu primeiro testar diferentes PUID/PGID valores, incluindo 0/0. O autor original tentou isso e relatou que não funcionou.

Isto é importante porque distingue este caso de um problema de permissões. Os privilégios de root não fazem com que um caminho do anfitrião não mapeado se torne o caminho correto do contentor.

O qBittorrent atual da LinuxServer utiliza o mesmo padrão

A documentação atual do Docker do qBittorrent da LinuxServer utiliza:

/path/to/downloads:/downloads

e define /downloads como localização de transferências dentro do contentor. Isso corresponde exatamente à correção da comunidade.

Documentação do Docker do qBittorrent da LinuxServer

Como corrigir a pasta de transferências

  1. Abra as definições da aplicação qBittorrent no ZimaOS.
  2. Encontre o mapeamento do volume de transferências.
  3. Confirme que a pasta pretendida na unidade secundária está no lado do anfitrião ZimaOS.
  4. Confirme que o lado do contentor é um caminho estável, como /downloads.
  5. Guarde e reinicie a aplicação se o mapeamento do Docker tiver sido alterado.
  6. Abra a WebUI do qBittorrent.
  7. Aceda a Ferramentas → Opções → Transferências.
  8. Defina o caminho predefinido para guardar como /downloads ou uma subpasta como /downloads/complete.
  9. Inicie um torrent de teste pequeno e verifique em que unidade física os dados são guardados.

Quando as permissões de PUID/PGID são importantes

Se /downloads está correto, mas os registos do qBittorrent indicam Permissão negadae, em seguida, verifique o proprietário e as permissões. A imagem da LinuxServer suporta PUID e PGID especificamente para as permissões de bind mounts do anfitrião.

Essa é uma falha diferente da do tópico original. Diagnostique primeiro a correção do caminho e só depois as permissões.

Perguntas frequentes sobre a pasta de transferências do qBittorrent no ZimaOS

Porque é que o qBittorrent continua a utilizar a unidade do sistema ZimaOS?

No caso da fonte, o qBittorrent foi configurado com o caminho do anfitrião em vez do caminho montado do contentor.

Que caminho resolveu o tópico original?

/downloads. O autor confirmou que funcionou.

Devo definir PUID e PGID como 0?

Não para este problema. O autor original tentou isso sem sucesso. Use primeiro o caminho correto do contentor.