Gemenskapslösning

Åtgärda behörighetsfel för qBittorrents nedladdningssökväg i ZimaOS

A ZimaOS user changed the qBittorrent download path but every torrent failed. The thread confirmed that the Docker mapping was visible but the host folder was not writable by the qBittorrent container.

Om qBittorrent kan se en mapp i ZimaOS men varje torrent misslyckas direkt räcker det inte att bara ändra sökvägen för nedladdningar i qBittorrent. Värdmappen måste först monteras i Docker-containern, och användaren som kör qBittorrent i containern måste ha behörighet att skriva till den monterade värdkatalogen.

Det var det som hände i IceWhale Community-tråden från januari 2026. Ursprungspostaren mappade en mediemapp till /Movies-TV, men qBittorrents körningslogg visade Permission denied. En särskild undermapp tillsammans med skrivbara behörigheter på värden löste problemet i originalfallet. Communityn använde chmod -R 777 som en snabb lösning, men aktuell vägledning från LinuxServer rekommenderar att PUID/PGID matchar ägarskapet på värden i stället för att lämna katalogen skrivbar för alla.

Värdsökväg kontra containersökväg

En sökväg i ZimaOS blir inte automatiskt synlig i qBittorrent. En normal mappning är:

Värd: /DATA/Downloads
Container: /downloads

Därefter bör qBittorrent spara till en containersökväg som /downloads/qbittorrent.

Den ursprungliga mappningen

Värd: /media/Main Storage/Media/Movies
Container: /Movies-TV
Volymmappning för ZimaOS qBittorrent som användes när nedladdningar misslyckades med nekad behörighet
Sökvägen var synlig i containern, men qBittorrent hade inte skrivbehörighet.

Skapa en särskild nedladdningsmapp

Communityns fungerande struktur skapade:

/media/Main Storage/Media/Movies/qbittorrent-downloads

och använde följande sökväg i qBittorrent:

/Movies-TV/qbittorrent-downloads

Kontrollera behörigheter

ls -ld "/media/Main Storage/Media/Movies"
ls -ld "/media/Main Storage/Media/Movies/qbittorrent-downloads"

Om katalogen finns men loggen visar Permission denied saknar containerns identitet skrivbehörighet.

Communityns bekräftade snabblösning

chmod -R 777 "/media/Main Storage/Media/Movies/qbittorrent-downloads"

Ursprungspostaren bekräftade att detta fungerade. 777 ger dock alla omfattande läs-, skriv- och körbehörigheter, så använd det som diagnostik eller en tillfällig lösning i stället för som den idealiska permanenta behörighetsmodellen.

Rekommenderad långsiktig lösning: matcha PUID och PGID

Den aktuella LinuxServer-avbildningen för qBittorrent stöder PUID och PGID specifikt för att undvika behörighetskonflikter med bind-monteringar. Dokumentationen rekommenderar att ägarskapet för katalogen på värden är kompatibelt med de ID:n som anges för containern.

LinuxServers qBittorrent-dokumentation

PUID=1000
PGID=1000

Värdena är endast exempel. Kontrollera det avsedda värdkontot med id USERNAME och använd de faktiska ID:n eller en kompatibel delad grupp.

Starta om och testa

  1. Spara volymmappningen.
  2. Starta om eller återskapa qBittorrent.
  3. Ställ in standardsökvägen för sparande till den mappade containersökvägen.
  4. Starta en liten testnedladdning.
  5. Läs Verktyg → Körningslogg om det fortfarande misslyckas.

Vad felen betyder

  • Permission denied: sökvägen finns, men är inte skrivbar.
  • No such file or directory: containersökvägen saknas eller är felaktigt mappad.

Vanliga frågor om qBittorrents nedladdningssökväg

Ska qBittorrent använda värdsökvägen i ZimaOS?

Nej. Det bör normalt använda sökvägen på containersidan som definieras i volymmappningen.

Löste chmod 777 problemet i originaltråden?

Ja. Författaren bekräftade att det fungerade, men snävare PUID/PGID- eller gruppbehörigheter är säkrare på lång sikt.

Varför kan qBittorrent se en mapp men inte skriva till den?

Synlighet via en Docker-montering och skrivbehörighet i filsystemet är separata saker. En mappad mapp kan vara läsbar men inte skrivbar för användaren i containern.