qBittorrent는 Files에 외장 ZimaOS 드라이브가 표시된다는 이유만으로 해당 드라이브에 쓸 수 없습니다. 먼저 qBittorrent 컨테이너에 해당 호스트 폴더를 Docker 볼륨으로 전달해야 하며, 그다음 qBittorrent에서는 물리적인 ZimaOS 호스트 경로가 아니라 컨테이너 측 경로를 저장 위치로 사용해야 합니다.
원본 스레드는 올바른 방향을 제시하지만 최종적으로 사용자가 해결되었다고 확인한 방법은 보여 주지 않습니다. 스크린샷은 외부 호스트 폴더가 다음과 같이 간단한 경로에 매핑되는 의도된 아키텍처를 보여 준다는 점에서 유용합니다. /Torrents 및 /Active Torrents.
Docker 볼륨 매핑에는 두 면이 있습니다
예를 들어:
/media/Expansion/Torrents → /TorrentsZimaOS에서는 왼쪽 경로를 사용하고 qBittorrent에서는 오른쪽 경로를 사용합니다. 따라서 qBittorrent 내부의 기본 저장 경로는 다음과 같아야 합니다. /Torrents이 아니라 /media/Expansion/Torrents.
사용자가 qBittorrent에 토렌트 폴더를 매핑했습니다
ZimaOS 볼륨 매핑은 해당 컨테이너 경로와 일치해야 합니다
현재 ZimaOS 문서에서도 동일한 호스트-컨테이너 모델을 사용합니다
IceWhale의 현재 Docker 경로 문서에서는 애플리케이션이 컨테이너 내부에 마운트된 경로를 사용해야 하며, ZimaOS 측에서는 실제 스토리지 폴더를 가리킨다고 명확히 설명합니다.
현재 ZimaOS Docker 볼륨 모델을 사용하세요.
경로가 존재하지만 토렌트에서 계속 오류가 발생하면 쓰기 권한을 확인하세요
qBittorrent 컨테이너/터미널에서 매핑된 디렉터리가 존재하고 임시 파일을 생성할 수 있는지 확인하세요. 쓰기 권한이 없는 유효한 경로는 볼륨이 없는 경우와 다른 오류를 발생시킵니다.
모든 권한 문제를 영구적인 방식으로 해결하려 하지 마세요 0777 또는 root입니다. 가능하면 컨테이너의 사용자/그룹을 대상 폴더에 맞추세요.
외부 드라이브의 파일 시스템 확인
현재 ZimaOS는 NTFS, exFAT, ext4, Btrfs를 비롯한 일반적인 USB 파일 시스템을 지원합니다. 특히 NTFS/exFAT에서는 파일 시스템의 동작 방식이 소유권과 권한에 영향을 줄 수 있습니다.
미완료 토렌트와 완료된 토렌트는 같은 외부 드라이브를 사용할 수 있음
“미완료 토렌트 보관 위치”를 활성화한 경우 해당 경로도 매핑하세요. 그렇지 않으면 완료된 다운로드 경로가 올바르더라도 qBittorrent가 매핑되지 않은 내부 경로에 미완료 데이터를 쓰려고 할 수 있습니다.
대용량 토렌트 데이터를 128GB 시스템 드라이브에 저장하지 마세요.
이 사용 사례는 외부 저장소가 정확히 필요한 경우입니다. qBittorrent 구성/AppData는 작고 영구적으로 유지하고, 수 테라바이트 규모의 데이터는 외부 저장 장치에 저장하세요.
qBittorrent 컨테이너 내부에서 경로 테스트하기
경로 문제와 권한 문제를 빠르게 구분하려면 앱 터미널을 열고 컨테이너 측 폴더를 확인하세요. 만약 /Torrents 존재하지 않는다면 Docker 볼륨 매핑이 잘못된 것입니다. 존재하지만 작은 테스트 파일을 만들 수 없다면 매핑은 작동하며, 다음으로 권한 및 파일 시스템 동작을 확인해야 합니다.
qBittorrent가 쓰기를 시작하기 전에 외부 드라이브가 마운트되어 있는지 확인하세요.
외부 USB 디스크의 연결이 끊기거나 마운트에 실패하면 오래된 호스트 경로로 인해 앱이 의도치 않은 로컬 디렉터리에 대신 쓸 수 있습니다. 재부팅하거나 다시 연결한 후 대용량 다운로드를 시작하기 전에 ZimaOS의 저장소/파일에서 드라이브가 표시되는지 확인하세요.
카테고리 경로도 매핑된 컨테이너 저장소 내부에 있어야 함
qBittorrent 카테고리는 기본 저장 경로를 재정의할 수 있습니다. 따라서 카테고리별 경로가 잘못되면 완료된 다운로드 경로가 올바른 경우에도 토렌트에서 오류가 발생할 수 있습니다. /Torrents 카테고리가 매핑되지 않은 다른 경로를 가리키는 경우에는 올바른 설정입니다. 일부 토렌트만 실패할 때는 카테고리별 저장 위치를 검토하세요.
기존 토렌트는 이전 저장 경로를 계속 사용할 수 있음
전역 기본 저장 경로를 변경해도 기존 토렌트의 위치가 항상 모두 다시 설정되지는 않습니다. 이미 추가된 토렌트는 현재 저장 경로를 확인하고, 부분 파일을 qBittorrent 모르게 옮기지 말고 qBittorrent에서 관리하는 “위치 설정”/재배치 기능을 사용하세요.
외부 qBittorrent 드라이브 FAQ
qBittorrent에서 저장 경로로 ZimaOS 호스트의 전체 경로를 사용해야 하나요?
일반적으로 그렇지 않습니다. Docker 볼륨 매핑으로 생성된 컨테이너 측 경로를 사용해야 합니다.
소스에 최종 해결 방법이 확정되어 있나요?
아니요. 사용자가 설정을 게시한 후 스레드가 끝납니다.
볼륨 경로 다음에 무엇을 확인해야 하나요?
컨테이너 내부에 매핑된 디렉터리가 존재하고 qBittorrent의 실행 사용자 및 그룹이 해당 디렉터리에 쓸 수 있는지 확인하세요.
