Jeśli qBittorrent widzi folder w ZimaOS, ale każdy torrent natychmiast kończy się niepowodzeniem, sama zmiana ścieżki pobierania w qBittorrent nie wystarczy. Folder hosta należy najpierw zamontować w kontenerze Docker, a użytkownik uruchamiający qBittorrent w tym kontenerze musi mieć uprawnienia do zapisu w zamontowanym katalogu hosta.
Właśnie to wydarzyło się w wątku IceWhale Community ze stycznia 2026 roku. Autor wątku zmapował folder multimediów do /Movies-TV, ale dziennik wykonywania qBittorrent wyświetlał komunikat Permission denied. Utworzenie dedykowanego podfolderu i nadanie hostowi uprawnień do zapisu rozwiązało problem opisany w wątku. Społeczność zastosowała chmod -R 777 jako szybkie rozwiązanie, jednak aktualne zalecenia LinuxServer preferują dopasowanie PUID/PGID do właściciela plików na hoście zamiast pozostawiania katalogu z uprawnieniami do zapisu dla wszystkich.
Ścieżka hosta a ścieżka kontenera
Ścieżka w ZimaOS nie jest automatycznie widoczna w qBittorrent. Typowe mapowanie wygląda tak:
Host: /DATA/Downloads
Kontener: /downloadsNastępnie qBittorrent powinien zapisywać pliki do ścieżki w kontenerze, takiej jak /downloads/qbittorrent.
Pierwotne mapowanie
Host: /media/Main Storage/Media/Movies
Kontener: /Movies-TV
Utwórz dedykowany folder pobierania
W działającym układzie opisanym przez społeczność utworzono:
/media/Main Storage/Media/Movies/qbittorrent-downloadsi użyto tej ścieżki w qBittorrent:
/Movies-TV/qbittorrent-downloadsSprawdź uprawnienia
ls -ld "/media/Main Storage/Media/Movies"
ls -ld "/media/Main Storage/Media/Movies/qbittorrent-downloads"Jeśli katalog istnieje, ale dziennik wyświetla komunikat Permission denied, tożsamość kontenera nie ma dostępu do zapisu.
Szybkie rozwiązanie potwierdzone przez społeczność
chmod -R 777 "/media/Main Storage/Media/Movies/qbittorrent-downloads"Autor wątku potwierdził, że to zadziałało. Jednak 777 nadaje szerokie uprawnienia odczytu, zapisu i wykonywania, dlatego lepiej używać go jako rozwiązania diagnostycznego lub tymczasowego, a nie jako docelowego modelu uprawnień.
Preferowane rozwiązanie długoterminowe: dopasowanie PUID i PGID
Aktualny obraz qBittorrent firmy LinuxServer obsługuje zmienne PUID i PGID, aby zapobiegać konfliktom uprawnień przy montowaniu katalogów. Dokumentacja zaleca ustawienie właściciela katalogu na hoście w sposób zgodny z identyfikatorami przekazanymi do kontenera.
Dokumentacja qBittorrent firmy LinuxServer
PUID=1000
PGID=1000To tylko przykładowe wartości. Sprawdź konto hosta, którego chcesz użyć, poleceniem id USERNAME, i zastosuj rzeczywiste identyfikatory lub zgodną grupę współdzieloną.
Uruchom ponownie i przetestuj
- Zapisz mapowanie woluminu.
- Uruchom ponownie lub odtwórz qBittorrent.
- Ustaw domyślną ścieżkę zapisu na zmapowaną ścieżkę kontenera.
- Uruchom małe pobieranie testowe.
- Jeśli problem nadal występuje, otwórz Narzędzia → Dziennik wykonywania.
Co oznaczają błędy
- Permission denied: ścieżka istnieje, ale nie można w niej zapisywać.
- No such file or directory: ścieżka kontenera nie istnieje lub została nieprawidłowo zmapowana.
Najczęstsze pytania dotyczące ścieżki pobierania qBittorrent
Czy qBittorrent powinien używać ścieżki hosta w ZimaOS?
Nie. Zwykle powinien używać ścieżki po stronie kontenera zdefiniowanej w mapowaniu woluminu.
Czy chmod 777 rozwiązało problem opisany w pierwotnym wątku?
Tak. Autor potwierdził, że zadziałało, ale w dłuższej perspektywie bezpieczniejsze są węższe uprawnienia oparte na PUID/PGID lub grupie.
Dlaczego qBittorrent może widzieć folder, ale nie może w nim zapisywać?
Widoczność zamontowanego folderu w Dockerze i uprawnienia systemu plików do zapisu to dwie odrębne kwestie. Zmapowany folder może być dostępny do odczytu, ale niedostępny do zapisu dla użytkownika kontenera.
