소스는 한 가지를 분명히 보여 줍니다. qBittorrent가 매핑된 외부 Btrfs 폴더에는 접근할 수 있었지만, 프로세스가 incomplete 하위 디렉터리를 생성할 수는 없었습니다. 오류는 “경로를 찾을 수 없음”이 아니라 권한 거부였습니다. 따라서 파일 시스템의 사용자·그룹 식별과 권한을 먼저 확인하는 것이 가장 타당한 문제 해결 단계입니다.
이 스레드만으로는 영구적인 해결 방법이 입증되지 않았습니다. 유일한 답변에서는 해당 ZimaOS 시스템에 UID 1000이 존재하지 않는다고 했으며, 컨테이너를 root로 실행해 보라고 제안했습니다. 원글 작성자는 성공 여부를 알리는 후속 답변을 남기지 않았습니다. 따라서 qBittorrent를 root로 실행하는 것은 제한적인 진단 방법으로만 취급해야 하며, 권장되는 최종 구성으로 보아서는 안 됩니다.
볼륨 매핑은 명시되어 있었습니다
소스에서는 다음과 같이 매핑했습니다.
/media/SSD-1TBStorage/Downloads → /downloadsqBittorrent 내부에서 애플리케이션은 다음 경로를 생성하려고 했습니다.
/downloads/incomplete/...오류가 권한 거부였으므로, 매핑은 정상적으로 존재했고 컨테이너가 호스트 파일 시스템에 접근했을 가능성이 높습니다.
호스트 폴더에는 그룹 쓰기 권한이 있었습니다
사용자는 다음을 보여 주었습니다.
drwxrwxr-x 1 1000 samba /media/SSD-1TBStorage/Downloads또한 컨테이너가 UID/GID 1000으로 실행된다고 설명했습니다. 사용자는 chown -R 1000:1000과 chmod -R 775도 시도했습니다.
오류가 계속 반환되었다는 것은 실제 실행 사용자, 상위 디렉터리 접근 권한, 마운트 동작 또는 유효 권한 중 하나 이상의 가정이 불완전했다는 뜻입니다.
포럼 답변의 ZimaOS UID를 그대로 지정하지 마세요
커뮤니티 답변자는 첫 번째 ZimaOS 사용자의 UID가 1000이 아니라 999라고 주장했습니다. 특정 빌드에서는 맞을 수 있지만, 사용자 ID는 플랫폼과 버전에 따라 달라질 수 있으며 qBittorrent 컨테이너가 별도의 PUID/PGID 계정을 사용할 수도 있습니다.
추측하지 말고 현재 컨테이너 설정과 실제 프로세스의 사용자·그룹 식별 정보를 확인하세요.
root로 실행하면 권한 문제를 확인할 수 있지만 영구 설정으로 사용해서는 안 됩니다
컨테이너가 UID 0으로 실행할 때만 정상 작동한다면, 매핑된 경로가 일반 애플리케이션 계정의 접근을 거부한다는 강력한 증거가 됩니다. 그렇다고 qBittorrent를 계속 root로 실행해야 한다는 뜻은 아닙니다.
웹 및 네트워크 입력에 노출되는 다운로드 프로그램에는 필요한 파일 시스템 권한만 부여해야 합니다.
호스트 경로의 모든 상위 디렉터리를 확인하세요
최종 Downloads 디렉터리에 쓰기 권한이 있어도 컨테이너 계정이 상위 디렉터리 중 하나를 통과할 수 없다면 충분하지 않습니다. 마지막 디렉터리의 권한 비트만 확인하지 말고 전체 경로와 ACL을 점검하세요.
Btrfs는 사용되었지만, 소스만으로 Btrfs가 실패 원인이라고 입증되지는 않았습니다
SSD는 Btrfs를 사용했지만 일반적인 Unix 소유권과 권한도 여전히 적용됩니다. 스레드의 내용만으로는 Btrfs 관련 버그, 서브볼륨 정책 또는 읽기 전용 마운트가 오류를 일으켰다고 입증할 수 없습니다.
파일 시스템 유형을 원인으로 지목하기 전에 마운트된 파일 시스템의 상태를 확인하세요.
현재 ZimaOS는 앱 볼륨 매핑을 명시적으로 제공합니다
현재 IceWhale 문서에서는 호스트 측 경로와 컨테이너 측 경로를 설명하며, 앱 설정에서 앱 저장소 매핑을 수정할 수 있도록 안내합니다.
소유권을 변경하기 전에 현재 ZimaOS Docker 경로 모델을 사용하세요.
qBittorrent 전용 다운로드 폴더를 사용하세요
전체 미디어 또는 백업 볼륨 대신, qBittorrent에 다운로드 및 준비 작업 전용 폴더에 대한 쓰기 권한만 부여하세요. 그러면 Sonarr/Radarr가 자체적으로 관리되는 권한 아래에서 완료된 파일을 가져오거나 이동할 수 있습니다.
더 안전한 영구 권한 설정 절차
- 정확한 호스트-컨테이너 매핑을 확인합니다.
- qBittorrent 컨테이너의 실제 UID/GID/PUID/PGID를 확인합니다.
- 호스트 폴더와 상위 디렉터리의 권한을 점검합니다.
- 작은 전용 테스트 디렉터리를 생성합니다.
- 필요한 사용자 또는 그룹에만 쓰기 권한을 부여합니다.
- 앱을 다시 시작한 후 합법적인 소형 다운로드 하나로 테스트합니다.
qBittorrent Btrfs 권한 FAQ
소스의 최종 해결 방법은 확인되었나요?
아니요. 스레드는 커뮤니티 답변 하나 이후에 끝납니다.
권한 거부는 Docker 볼륨 매핑이 없다는 뜻인가요?
아니요. 일반적으로 경로에는 접근할 수 있지만 프로세스가 요청된 쓰기 작업을 수행할 수 없다는 뜻입니다.
qBittorrent를 계속 root로 실행해야 하나요?
아니요. root 실행은 진단용 테스트가 될 수 있지만, 영구적인 해결 방법은 필요한 최소한의 파일 시스템 권한만 사용해야 합니다.
