Solução da comunidade

Transferir torrents do qBittorrent diretamente para uma unidade USB externa no ZimaOS: corrigir o volume e o caminho de gravação

A March 2026 thread where qBittorrent on a 128 GB ZimaOS mini PC errored when the user tried to save torrents to a 14 TB external USB drive. A community reply correctly focused on adding the external folder as a Docker volume. The user posted volume and qBittorrent settings, but the thread ends before a confirmed final fix.

O qBittorrent não pode escrever numa unidade externa do ZimaOS apenas porque a unidade aparece em Ficheiros. O contentor do qBittorrent tem primeiro de receber essa pasta do anfitrião como um volume Docker, e o qBittorrent tem depois de utilizar o caminho do lado do contentor — e não o caminho físico do anfitrião ZimaOS — como localização de gravação.

O tópico de origem aponta na direção certa, mas não apresenta uma correção final confirmada pelo utilizador. As capturas de ecrã são úteis porque revelam a arquitetura pretendida: pastas externas do anfitrião mapeadas para caminhos simples, como /Torrents e /Active Torrents.

Definições de volumes Docker do ZimaOS a mostrar a pasta Downloads de uma unidade externa mapeada para um contentor de transferência
O padrão essencial é: caminho do anfitrião à esquerda e caminho simples do contentor à direita.

Um mapeamento de volumes Docker tem dois lados

Por exemplo:

/media/Expansion/Torrents  →  /Torrents

O ZimaOS utiliza o caminho do lado esquerdo. O qBittorrent utiliza o caminho do lado direito. Por isso, dentro do qBittorrent, o caminho de gravação predefinido deve ser /Torrents, e não /media/Expansion/Torrents.

O utilizador de origem mapeou pastas de torrents para o qBittorrent

Definições de transferências do qBittorrent que mostram o caminho de gravação predefinido /Torrents e o caminho para torrents incompletos /Active Torrents
As definições do qBittorrent utilizam caminhos do contentor, que têm de corresponder exatamente aos caminhos criados pelos mapeamentos de volumes do ZimaOS.
Definições de transferência do qBittorrent com caminhos do contentor para torrents concluídos e incompletos
Os caminhos para torrents concluídos e incompletos podem ser separados, mas ambos precisam de armazenamento mapeado com permissão de escrita.

O mapeamento de volumes do ZimaOS tem de corresponder a esses caminhos do contentor

Definições do caminho de transferência do qBittorrent que requerem mapeamentos de volumes Docker correspondentes no ZimaOS
Se o volume estiver em falta ou estiver mapeado para um caminho de contentor diferente, o qBittorrent pode apresentar o torrent como Com erro.

A documentação atual do ZimaOS utiliza o mesmo modelo anfitrião versus contentor

A documentação atual da IceWhale sobre caminhos Docker explica explicitamente que uma aplicação deve utilizar o caminho montado dentro do respetivo contentor, enquanto o lado do ZimaOS aponta para a pasta de armazenamento real.

Utilize o modelo atual de volumes Docker do ZimaOS.

Se o caminho existir, mas os torrents continuarem a dar erro, verifique a permissão de escrita

No contentor/terminal do qBittorrent, verifique se o diretório mapeado existe e se é possível criar um ficheiro temporário. Um caminho válido sem permissão de escrita produz um erro diferente do de um volume em falta.

Evite resolver todos os problemas de permissões com permissões permanentes 0777 ou root. Sempre que possível, faça corresponder a identidade/grupo do contentor à pasta de destino.

Verifique o sistema de ficheiros do disco externo

O ZimaOS atual suporta sistemas de ficheiros USB comuns, incluindo NTFS, exFAT, ext4 e Btrfs. As características do sistema de ficheiros podem afetar a propriedade e as permissões, especialmente no NTFS/exFAT.

As torrents incompletas e concluídas podem utilizar o mesmo disco externo

Se ativar “Manter torrents incompletas em”, mapeie também esse caminho. Caso contrário, o qBittorrent pode tentar escrever dados incompletos num caminho interno não mapeado, mesmo que o caminho das transferências concluídas esteja correto.

Mantenha os dados grandes das torrents fora do disco do sistema de 128 GB

O caso de utilização da fonte é precisamente aquele em que o armazenamento externo faz sentido. Mantenha a configuração/AppData do qBittorrent pequena e persistente, colocando os dados de vários terabytes no dispositivo de armazenamento externo.

Teste o caminho a partir do interior do contentor do qBittorrent

Uma forma rápida de distinguir problemas de caminho de problemas de permissões é abrir o terminal da aplicação e inspecionar a pasta dentro do contentor. Se /Torrents não existir, o mapeamento do volume Docker está incorreto. Se existir, mas não for possível criar um pequeno ficheiro de teste, o mapeamento funciona e a camada seguinte a verificar são as permissões e o comportamento do sistema de ficheiros.

Certifique-se de que o disco externo está montado antes de o qBittorrent começar a escrever

Se um disco USB externo for desligado ou não for montado, um caminho antigo do anfitrião pode fazer com que uma aplicação escreva, em vez disso, num diretório local não pretendido. Depois de reiniciar ou voltar a ligar o disco, verifique se este está presente em Armazenamento/Ficheiros do ZimaOS antes de iniciar transferências grandes.

Os caminhos das categorias também têm de permanecer dentro do armazenamento mapeado do contentor

As categorias do qBittorrent podem substituir o caminho de gravação predefinido. Por isso, uma torrent pode apresentar um erro mesmo quando /Torrents está correto se a categoria apontar para outro caminho não mapeado. Reveja as localizações de gravação específicas das categorias quando apenas algumas torrents falharem.

As torrents existentes podem manter o caminho de gravação antigo

Alterar o caminho de gravação predefinido global nem sempre atualiza a localização de todas as torrents existentes. Para torrents já adicionadas, verifique o caminho de gravação atual da torrent e utilize o comportamento de “definir localização”/realocação gerido pelo qBittorrent, em vez de mover ficheiros parciais sem o seu conhecimento.

Perguntas frequentes sobre unidades externas do qBittorrent

O qBittorrent deve utilizar o caminho completo do anfitrião ZimaOS como caminho de gravação?

Normalmente, não. Deve utilizar o caminho dentro do contentor criado pelo mapeamento do volume Docker.

A fonte contém uma solução final confirmada?

Não. O tópico termina depois de o utilizador publicar as suas definições.

O que deve ser verificado depois do caminho do volume?

Verifique se o diretório mapeado existe dentro do contentor e se a identidade de execução do qBittorrent tem permissão para escrever nele.