커뮤니티 솔루션

ZimaOS에서 qBittorrent 권한 거부: chmod 777 없이 다운로드 경로 수정

A January 2026 thread where qBittorrent could see a mapped media folder but every download failed with Permission Denied. The community created a dedicated download subfolder and applied broad write permissions; the original poster confirmed it worked. The permanent lesson is path mapping plus correct ownership/permissions, not chmod 777 itself.

The source qBittorrent problem had two layers. First, qBittorrent must save to a path that exists inside the container. Second, the qBittorrent process must have write permission to the host folder behind that container path. The user had already solved the mapping layer—the folder was visible—but the execution log still showed Permission Denied.

원본의 qBittorrent 문제에는 두 가지 계층이 있었습니다. 첫째, qBittorrent는 컨테이너 내부에 실제로 존재하는 경로에 저장해야 합니다. 둘째, qBittorrent 프로세스는 해당 컨테이너 경로 뒤에 있는 호스트 폴더에 대한 쓰기 권한이 있어야 합니다. 사용자는 이미 매핑 계층을 해결한 상태였습니다. 폴더는 표시되었지만 실행 로그에는 여전히 Permission Denied가 표시되었습니다. 커뮤니티의 해결 방법은 전용 다운로드 폴더를 만들고 매우 광범위한 chmod -R 777 777 빠른 권한 테스트로 사용했습니다. 원글 작성자는 그 후 다운로드가 정상적으로 작동했다고 확인했습니다. 이 결과는 문제가 쓰기 권한 때문이었다는 것을 입증하지만,

현재 시스템에서 영구적인 권장 설정으로 사용해서는 안 됩니다.

호스트 경로와 qBittorrent 경로는 동일한 스토리지를 가리키는 서로 다른 이름입니다
ZimaOS qBittorrent 저장소 설정에서 호스트 Movies 폴더를 컨테이너 경로 /Movies-TV에 매핑 컨테이너:.

원본 매핑은 호스트의 Movies 폴더를 qBittorrent 내부에 다음 경로로 노출했습니다.

  • 원본에서는 다음을 사용했습니다. 호스트:
  • /media/Main Storage/Media/Movies 컨테이너:

/Movies-TV qBittorrent 내부에서 저장 경로는 다음을 사용해야 합니다./Movies-TV/...

매핑이 작동한다는 사실은 확인되었지만, Permission Denied는 쓰기가 되지 않는다는 것을 입증했습니다

사용자의 qBittorrent 실행 로그에는 다음이 표시되었습니다. Permission Denied이는 다음과 다릅니다. No such file or directory:

  • No such file/directory: 매핑 또는 경로가 잘못되었을 가능성이 큽니다.
  • Permission denied: 컨테이너가 해당 경로에 접근할 수는 있지만 쓸 수 없습니다.

전용 다운로드 폴더가 권한을 올바르게 설정하기 더 쉽습니다

커뮤니티에서는 다음과 같은 하위 폴더를 만들었습니다.

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

그리고 qBittorrent의 컨테이너 내부 대상 경로를 다음과 같이 설정합니다.

/Movies-TV/qbittorrent-downloads

다운로더에 미디어 트리 전체에 대한 쓰기 권한을 부여하는 것보다, 하나의 스테이징 디렉터리만 필요하다면 이 방식이 더 낫습니다.

chmod 777을 진단을 위한 임시 조치로 사용했을 뿐, 최종 권한 모델로 권장한 것은 아닙니다

커뮤니티 답변에서는 재귀적으로 chmod 777 그리고 원글 작성자가 문제가 해결되었다고 확인했습니다. 이는 인과관계를 입증하지만, 누구나 쓰기 가능한 권한을 설정하면 모든 로컬 프로세스가 해당 디렉터리에 쓸 수 있습니다.

더 안전한 영구 해결 방법은 qBittorrent 컨테이너의 런타임 UID/GID를 확인하고 해당 사용자/그룹에 필요한 쓰기 권한만 부여하는 것입니다.

소유권을 변경하기 전에 확인하세요

유용한 읽기 전용 확인 방법으로는 변경 전에 폴더 소유자/그룹과 모드를 확인하는 것이 있습니다. qBittorrent가 구성 가능한 PUID/PGID로 실행된다면 해당 값을 다운로드 디렉터리에 대한 쓰기 권한이 있는 호스트 그룹에 맞추세요.

한 폴더에만 쓰기 권한이 필요할 때 전체 공유 미디어 라이브러리의 소유권을 재귀적으로 변경하지 마세요.

최신 ZimaOS에서는 앱 볼륨 경로가 명확하게 표시됩니다

최신 IceWhale 문서에서는 App Store 애플리케이션이 컨테이너 내부에서 실행되며, 중요한 폴더가 실제 호스트 저장소에 매핑된다고 설명합니다. 이러한 매핑은 앱 설정에서 확인하고 수정할 수 있습니다.

권한을 수정하기 전에 현재 ZimaOS Docker 경로 모델을 사용하세요.

다운로드 임시 폴더를 최종 미디어 라이브러리와 분리하세요

일반적인 구성은 다음과 같습니다.

  • qBittorrent는 전용 다운로드 폴더에 파일을 씁니다.
  • Sonarr/Radarr 또는 다른 정리 도구는 완료된 파일을 가져옵니다.
  • Jellyfin/Plex는 최종 미디어 라이브러리를 읽으며, 대개 읽기 전용입니다.

이렇게 하면 각 애플리케이션에 필요한 액세스 권한만 부여할 수 있습니다.

먼저 다운로드 하나만 테스트하세요

매핑 또는 권한을 변경한 후:

  1. qBittorrent를 다시 시작합니다.
  2. 저장 경로가 컨테이너 내부에서 확인되는지 확인합니다.
  3. 작고 합법적인 테스트 파일을 다운로드합니다.
  4. 실행 로그를 확인합니다.
  5. 파일이 지정된 호스트 저장소에 표시되는지 확인합니다.

qBittorrent 다운로드 경로 FAQ

소스 볼륨 매핑 자체가 잘못되었나요?

커뮤니티에서는 해당 경로가 표시되고 올바르다고 결론 내렸으며, 남은 오류는 쓰기 권한 문제였습니다.

chmod 777로 소스 사례가 작동했나요?

예, 원 게시자가 성공을 확인했습니다. 이는 선호되는 영구 권한 설정이라기보다 광범위한 진단용 우회 방법으로 취급해야 합니다.

qBittorrent가 내부적으로 사용해야 하는 경로는 무엇인가요?

ZimaOS 볼륨 매핑에 정의된 컨테이너 측 경로(예: /Movies-TV/qbittorrent-downloads.