コミュニティソリューション

ZimaOSでqBittorrentのダウンロード先の権限エラーを修正する

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.

qBittorrentがZimaOS内のフォルダーを認識できるのに、すべてのトレントが直ちに失敗する場合、qBittorrent内のダウンロードパスだけを変更しても不十分です。まずホストのフォルダーをDockerコンテナ内にマウントし、そのコンテナ内で実行されるqBittorrentのユーザーに、マウントされたホストディレクトリへの書き込み権限を付与する必要があります。

2026年1月のIceWhaleコミュニティスレッドで起きたのも、まさにこの問題でした。元の投稿者はメディアフォルダーを/Movies-TVに割り当てましたが、qBittorrentの実行ログにはPermission deniedと表示されました。専用サブフォルダーを作成し、ホスト側で書き込み権限を付与することで、元のケースは解決しました。コミュニティでは簡単な対処法としてchmod -R 777を使用しましたが、現在のLinuxServerのガイダンスでは、ディレクトリを全ユーザーに書き込み可能な状態にするのではなく、PUID/PGIDをホスト側の所有権に合わせる方法が推奨されています。

ホストパスとコンテナパス

ZimaOSのパスが自動的にqBittorrent内で表示されるわけではありません。一般的なマッピングは次のとおりです。

ホスト: /DATA/Downloads
コンテナ: /downloads

その後、qBittorrentでは/downloads/qbittorrentのようなコンテナパスに保存するよう設定します。

元のマッピング

ホスト: /media/Main Storage/Media/Movies
コンテナ: /Movies-TV
権限拒否によりダウンロードに失敗した際に使用されたZimaOSのqBittorrentボリュームマッピング
パスはコンテナ内で認識されていましたが、qBittorrentには書き込み権限がありませんでした。

専用のダウンロードフォルダーを作成する

コミュニティで問題を解決できた構成では、次のフォルダーを作成しました。

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

qBittorrent内では、次のパスを使用しました。

/Movies-TV/qbittorrent-downloads

権限を確認する

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

ディレクトリが存在するのにログにPermission deniedと表示される場合は、コンテナのユーザーに書き込み権限がありません。

コミュニティで確認された簡単な対処法

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

元の投稿者は、これで解決したと報告しています。ただし、777はすべてのユーザーに広範な読み取り・書き込み・実行権限を付与するため、理想的な恒久対策ではなく、診断または一時的な回避策として使用してください。

推奨される長期的な対策: PUIDとPGIDを合わせる

現在のLinuxServer qBittorrentイメージは、バインドマウントによる権限の競合を避けるためにPUIDとPGIDをサポートしています。ドキュメントでは、コンテナに指定するIDとホストディレクトリの所有権が一致するように設定することを推奨しています。

LinuxServer qBittorrentのドキュメント

PUID=1000
PGID=1000

これらの値はあくまで例です。id USERNAMEで対象ホストアカウントを確認し、実際のID、または互換性のある共有グループを使用してください。

再起動してテストする

  1. ボリュームマッピングを保存します。
  2. qBittorrentを再起動または再作成します。
  3. デフォルトの保存先を、マッピングしたコンテナパスに設定します。
  4. 小さなテストダウンロードを開始します。
  5. それでも失敗する場合は、「ツール」→「実行ログ」を確認します。

エラーの意味

  • Permission denied: パスは存在しますが、書き込みできません。
  • No such file or directory: コンテナパスが存在しないか、マッピングが正しくありません。

qBittorrentのダウンロードパスに関するFAQ

qBittorrentではZimaOSのホストパスを使用すべきですか？

いいえ。通常は、ボリュームマッピングで定義したコンテナ側のパスを使用します。

chmod 777で元のスレッドの問題は解決しましたか？

はい。投稿者は解決したと報告していますが、長期的には、より限定的なPUID/PGIDまたはグループ権限の方が安全です。

qBittorrentがフォルダーを認識できるのに、書き込めないのはなぜですか？

Dockerのマウントによる可視性と、ファイルシステムへの書き込み権限は別のものだからです。マッピングされたフォルダーをコンテナから読み取れても、コンテナのユーザーには書き込み権限がない場合があります。

Related Community

CommunitySep 11, 2026CasaOSまたはZimaOSにApache Guacamoleを安全にインストールするA 2023 CasaOS tutorial introduced Apache Guacamole through BigBearCasaOS as a browser gat...CommunitySep 08, 2026デフォルトのIceWhaleアプリストアとしてのBigBearCasaOS：「プリインストール」の意味とその保守担当者A March 2025 community announcement saying BigBearCasaOS would be available by default ac...CommunitySep 04, 2026CasaOSにLinuxServerのサードパーティアプリストアを追加する方法A 2023 video tutorial showing how to add WisdomSky's CasaOS LinuxServer catalog as a thir...CommunitySep 04, 2026コミュニティメンバーがCasaOSにAdGuard Homeを導入した方法Christopher shared a video tutorial introducing AdGuard Home on CasaOS as a way to block ...CommunitySep 04, 2026コミュニティ動画がBigBearCasaOSアプリストアを追加した経緯Christopher shared a video walkthrough for adding the community-maintained BigBearCasaOS ...