Solução da comunidade

Permissão negada no qBittorrent num SSD Btrfs externo: mapeie o caminho, verifique o UID/GID e evite o root

An October 2025 thread where qBittorrent mapped /media/SSD-1TBStorage/Downloads to /downloads but could not create /downloads/incomplete. The user tried UID/GID 1000, chown 1000:1000, and chmod 775. The only reply claimed the ZimaOS admin UID was different and suggested root as a test, but the original poster never confirmed a final fix.

A fonte prova claramente uma coisa: o qBittorrent conseguia aceder à pasta Btrfs externa mapeada, mas o processo não conseguia criar o subdiretório incomplete. O erro foi Permissão negada, não “caminho não encontrado”. Por isso, a identidade e as permissões do sistema de ficheiros são a camada de diagnóstico mais importante.

O tópico não prova qual foi a solução permanente. A única resposta dizia que o UID 1000 não existia naquele sistema ZimaOS e sugeria testar o contentor como root. O autor original nunca voltou para confirmar um resultado bem-sucedido. Por isso, executar o qBittorrent como root deve ser considerado apenas um diagnóstico limitado — não uma configuração final recomendada.

O Mapeamento do Volume Era Explícito

A fonte mapeava:

/media/SSD-1TBStorage/Downloads  →  /downloads

Dentro do qBittorrent, a aplicação tentou criar:

/downloads/incomplete/...

Como o erro foi “permissão negada”, é provável que o mapeamento existisse e que o contentor conseguisse aceder ao sistema de ficheiros do anfitrião.

A Pasta do Anfitrião Tinha Permissão de Escrita para o Grupo

O utilizador mostrou:

drwxrwxr-x 1 1000 samba /media/SSD-1TBStorage/Downloads

e afirmou que o contentor era executado com UID/GID 1000. Também tentou chown -R 1000:1000 e chmod -R 775.

O facto de o erro ter ocorrido significa que uma dessas suposições — identidade real em execução, acesso aos diretórios-pai, comportamento da montagem ou permissões efetivas — estava incompleta.

Não Fixe um UID do ZimaOS com Base numa Resposta de Fórum

O membro da comunidade afirmou que o primeiro utilizador do ZimaOS usava o UID 999 em vez de 1000. Mesmo que isso estivesse correto numa determinada compilação, os IDs de utilizador podem variar consoante a plataforma e a versão, e o contentor do qBittorrent pode usar uma identidade PUID/PGID separada.

Inspecione a configuração atual e real do contentor e a identidade do processo, em vez de adivinhar.

Executar como Root Pode Confirmar uma Camada de Permissões, mas Não Deve Ser Permanente

Se um contentor só funcionar quando é executado com UID 0, isso sugere fortemente que o caminho mapeado nega o acesso à identidade normal da aplicação. Isso não significa que o qBittorrent deva continuar permanentemente como root.

Um cliente de transferências exposto a dados recebidos através da Web ou da rede deve ter apenas os privilégios de sistema de ficheiros de que necessita.

Verifique Todos os Diretórios-Pai no Caminho do Anfitrião

Ter acesso de escrita ao diretório Downloads final não é suficiente se a identidade do contentor não conseguir atravessar um dos diretórios-pai. Inspecione o caminho completo e quaisquer ACL, não apenas os bits de modo do último diretório.

O Btrfs Estava Presente, mas a Fonte Não Provou que o Btrfs Causou a Falha

O SSD usava Btrfs, mas as permissões e a propriedade Unix normais continuam a aplicar-se. Nada no tópico prova a existência de um erro específico do Btrfs, de uma política de subvolume ou de uma montagem só de leitura que tenha causado o erro.

Verifique o estado do sistema de ficheiros montado antes de atribuir a culpa ao tipo de sistema de ficheiros.

O ZimaOS Atual Expõe Explicitamente os Mapeamentos de Volumes das Aplicações

A documentação atual da IceWhale explica os caminhos no anfitrião e no contentor e permite aos utilizadores editar os mapeamentos de armazenamento das aplicações nas definições da aplicação.

Consulte o modelo atual de caminhos Docker do ZimaOS antes de alterar a propriedade.

Utilize uma Pasta de Transferências Dedicada para o qBittorrent

Dê ao qBittorrent acesso de escrita a uma pasta de transferências/estágio criada especificamente para esse fim, em vez de a um volume inteiro de multimédia ou de cópias de segurança. O Sonarr/Radarr poderá então importar/mover os ficheiros concluídos com as suas próprias permissões controladas.

Um Fluxo de Trabalho Mais Seguro para Corrigir Permanentemente as Permissões

  1. Confirme o mapeamento exato entre o anfitrião e o contentor.
  2. Inspecione o UID/GID/PUID/PGID real do contentor do qBittorrent.
  3. Inspecione as permissões da pasta do anfitrião e dos diretórios-pai.
  4. Crie um pequeno diretório de teste dedicado.
  5. Conceda apenas o acesso de escrita necessário ao utilizador ou grupo.
  6. Reinicie a aplicação e teste uma transferência legal pequena.

Perguntas Frequentes sobre Permissões do qBittorrent no Btrfs

A solução final indicada pela fonte foi confirmada?

Não. O tópico termina após uma única resposta da comunidade.

“Permissão negada” prova que o mapeamento do volume Docker está ausente?

Não. Normalmente significa que o caminho está acessível, mas que o processo não consegue executar a operação de escrita solicitada.

O qBittorrent deve ser executado permanentemente como root?

Não. O root pode ser usado como teste de diagnóstico, mas a solução permanente deve utilizar o menor privilégio de sistema de ficheiros necessário.