커뮤니티 솔루션

ZimaOS에서 올바른 qBittorrent 다운로드 폴더 설정

A ZimaOS user mapped qBittorrent downloads to a second drive but kept entering the ZimaOS host path inside qBittorrent. The confirmed fix was to use the Docker container path /downloads instead.

qBittorrent가 앱 설정에서 다른 HDD를 선택한 후에도 ZimaOS 시스템 드라이브에 계속 다운로드를 저장한다면, qBittorrent 자체에 어떤 경로를 입력했는지 확인하세요. 2025년 11월 IceWhale 커뮤니티 스레드에서는 보조 드라이브가 이미 qBittorrent 컨테이너에 마운트되어 있었지만, 사용자가 ZimaOS 호스트 경로를 Docker 컨테이너 경로 대신 입력했습니다.

확인된 해결 방법은 간단했습니다. 다음을 사용하는 것입니다. /downloads ZimaOS 호스트 경로인 다음 경로가 아니라 qBittorrent 내부에서 /media/GERAL/downloadsPUID/PGID를 다음으로 변경해도 0/0 소스 사례에서는 문제가 해결되지 않았습니다. 경로를 수정하자 해결되었고, 원 게시자가 이후 다운로드가 작동했다고 명시적으로 확인했습니다.

핵심 차이점: 호스트 경로와 컨테이너 경로

Docker 볼륨 매핑에는 두 부분이 있습니다.

HOST_PATH:CONTAINER_PATH

예:

/media/GERAL/downloads:/downloads

ZimaOS는 왼쪽 경로를 인식합니다. qBittorrent는 컨테이너 내부에서 실행되므로 일반적으로 오른쪽 경로를 사용해야 합니다.

qBittorrent 내부에서 올바른 경로: /downloads
qBittorrent 내부에서 잘못된 경로:   /media/GERAL/downloads

원래 사용자가 구성한 내용

보조 GERAL 드라이브의 다운로드 매핑을 보여 주는 ZimaOS qBittorrent 설정
원본 게시물에서는 보조 GERAL 드라이브에 저장하도록 qBittorrent를 구성한 것으로 나타납니다.
ZimaOS 호스트 경로를 Docker 경로 대신 사용하는 qBittorrent 다운로드 설정
qBittorrent 설정에서 마운트된 컨테이너 경로가 아닌 호스트 측 경로를 사용하고 있었습니다.
qBittorrent 컨테이너에 사용되는 GERAL 드라이브의 ZimaOS 저장소 경로
ZimaOS는 실제 호스트 경로를 표시하지만, qBittorrent가 내부적으로 동일한 경로 문자열을 사용할 필요는 없습니다.
ZimaOS 문제 해결 스레드의 qBittorrent 다운로드 폴더 필드
확인된 해결 방법은 마운트된 컨테이너 경로를 사용하는 것이었습니다. /downloads.

PUID와 PGID를 변경해도 이 사례가 해결되지 않은 이유

한 커뮤니티 답변에서는 먼저 다양한 방법을 테스트해 보라고 제안했습니다. PUID/PGID 값을 포함하며, 다음도 포함합니다. 0/0. 원 작성자가 이를 시도했지만 작동하지 않았다고 보고했습니다.

이는 이 사례를 권한 문제와 구분해 주므로 중요합니다. 루트 권한이 매핑되지 않은 호스트 경로를 올바른 컨테이너 경로로 바꾸어 주지는 않습니다.

현재 LinuxServer qBittorrent는 동일한 패턴을 사용합니다.

현재 LinuxServer qBittorrent Docker 문서에서는 다음을 사용합니다.

/path/to/downloads:/downloads

그리고 다음을 정의합니다. /downloads 컨테이너 내부의 다운로드 위치로 사용합니다. 이는 커뮤니티의 해결 방법과 정확히 일치합니다.

LinuxServer qBittorrent Docker 문서

다운로드 폴더 수정 방법

  1. ZimaOS에서 qBittorrent 앱 설정을 엽니다.
  2. 다운로드 볼륨 매핑을 찾습니다.
  3. 원하는 보조 드라이브 폴더가 ZimaOS 호스트 측에 있는지 확인하세요.
  4. 컨테이너 측 경로가 다음과 같은 안정적인 경로인지 확인하세요. /downloads.
  5. Docker 매핑을 변경했다면 앱을 저장하고 다시 시작하세요.
  6. qBittorrent WebUI를 엽니다.
  7. 도구 → 옵션 → 다운로드로 이동하세요.
  8. 기본 저장 경로를 다음으로 설정하세요. /downloads 또는 다음과 같은 하위 폴더 /downloads/complete.
  9. 작은 테스트 토렌트를 시작하고 어느 물리 드라이브에 데이터가 저장되는지 확인하세요.

PUID/PGID 권한이 실제로 중요한 경우

다음과 같은 경우 /downloads 은 올바르지만 qBittorrent 로그에는 다음이 기록됩니다. 권한이 거부됨을 확인한 다음 소유권과 권한을 점검하세요. LinuxServer의 이미지는 다음을 지원합니다. PUID 및 PGID 특히 호스트 바인드 마운트 권한에 해당합니다.

이는 원본 스레드와는 다른 오류입니다. 먼저 경로가 올바른지, 그다음 권한을 진단하세요.

ZimaOS qBittorrent 다운로드 폴더 FAQ

qBittorrent가 여전히 ZimaOS 시스템 드라이브를 사용하는 이유는 무엇인가요?

원본 사례에서는 qBittorrent가 마운트된 컨테이너 경로 대신 호스트 경로로 구성되어 있었습니다.

원래 스레드에서 어떤 경로로 문제가 해결되었나요?

/downloads. 작성자가 작동한다고 확인했습니다.

PUID와 PGID를 0으로 설정해야 하나요?

이 문제에는 해당하지 않습니다. 원 작성자가 성공하지 못한 채 시도해 보았습니다. 먼저 올바른 컨테이너 경로를 사용하세요.