미디어 폴더를 다른 ZimaOS 드라이브로 옮겨도 기존 경로를 사용하던 모든 Docker 앱이 자동으로 업데이트되지는 않습니다. 소스에서 정확히 이런 일이 발생했습니다. 영화 파일을 새 NVMe로 옮기고 Radarr에는 새 저장 위치가 반영되었지만, Jellyfin은 여전히 기존 바인드 마운트를 참조하고 있어 영화를 찾지 못했습니다.
해결 방법은 안정적인 컨테이너 측 경로인 /movies 또는 /media 등을 유지하면서 애플리케이션의 호스트 측 볼륨 경로를 업데이트하는 것입니다. Zima-Giorgio는 CLI를 통한 경로 확인 방법과 GUI 폴더 선택기를 모두 보여 주었고, 사용자는 곧바로 GUI 방법으로 문제가 해결되었다고 확인했습니다.
Docker에는 호스트 경로와 컨테이너 경로가 있습니다
매핑은 개념적으로 다음과 같습니다.
/ZimaOS의/실제/경로 → /앱 내부의/경로
왼쪽은 파일이 실제로 저장된 저장 장치와 폴더를 가리켜야 합니다. 오른쪽은 컨테이너 내부에서 Jellyfin/Radarr가 보는 경로입니다.
두 번째 ZimaOS 저장 장치는 자동으로 /DATA 아래에 연결되지 않습니다
/DATA/... 경로를 입력하면 잘못된 저장 장치에 폴더가 생성되었습니다.이것이 핵심적인 혼동이었습니다. /DATA/extra-movies는 시스템/기본 데이터 영역을 가리키며, 새 NVMe에 있는 폴더를 자동으로 가리키지 않습니다.
Zima-Giorgio는 /media 확인을 제안했습니다
호스트 경로를 직접 확인하려면 Giorgio는 다음 명령어를 제안했습니다.
ls /media
당시에는 독립형 저장 장치나 마운트된 저장 장치가 /media 아래에 표시되었습니다. 정확한 경로는 현재의 저장소 관리 방식과 장치 이름에 따라 달라질 수 있으므로, 추측하지 말고 현재 UI에 표시된 경로를 사용하세요.
GUI 폴더 선택기가 소스에서 확인된 해결 방법입니다
현재 ZimaOS는 데이터 이동 후 볼륨 경로 업데이트를 명시적으로 지원합니다
현재 IceWhale 앱 경로 문서에는 드라이브가 가득 찬 경우 앱을 다시 설치하지 않고 앱 데이터를 다른 드라이브로 옮긴 뒤 앱 설정에서 경로를 업데이트할 수 있다고 명시되어 있습니다.
현재 ZimaOS Docker 경로 작업 방식을 사용하세요.
가능하면 컨테이너 경로는 그대로 유지하세요
Jellyfin이 이미 내부적으로 /Media를 사용하고 있다면 실제 물리 폴더에 해당하는 호스트 측 경로만 변경하세요. 컨테이너 경로를 유지하면 애플리케이션 데이터베이스와 라이브러리가 완전히 다른 경로 문자열로 인식하는 것을 방지할 수 있습니다.
이동한 폴더를 매핑하는 모든 앱을 업데이트하세요
Radarr, Sonarr, qBittorrent, Jellyfin, Plex 및 가져오기 도구는 각각 별도의 볼륨 매핑을 사용할 수 있습니다. 한 앱에 새 폴더가 표시된다고 해서 다른 앱까지 자동으로 업데이트되지는 않습니다.
기존 폴더를 삭제하기 전에 확인하세요
Jellyfin에서 영화를 열고, Radarr가 루트 폴더를 스캔하도록 하며, 필요한 경우 qBittorrent 가져오기 경로를 테스트하고 권한을 확인하세요. 모든 애플리케이션이 새 호스트 매핑을 정상적으로 사용하는 것이 확인될 때까지 기존 원본 폴더를 유지하세요.
미디어 이동과 앱 데이터 이동은 다릅니다
영화 및 TV 폴더는 일반적인 콘텐츠 라이브러리입니다. 앱 데이터에는 SQLite/PostgreSQL 데이터베이스, 썸네일, 인덱스 및 애플리케이션 상태가 포함될 수 있으며, 일관성을 유지하려면 앱을 중지하거나 ZimaOS 데이터 마이그레이션을 사용해야 할 수 있습니다. 모든 볼륨을 단순한 드래그 앤 드롭 방식의 미디어 폴더로 취급하지 마세요.
새 저장 장치의 권한을 다시 확인하세요
새 호스트 경로가 올바르더라도 컨테이너의 사용자 ID가 기존 드라이브는 읽을 수 있지만 새 드라이브에는 접근할 수 없으면 문제가 발생할 수 있습니다. 경로를 다시 매핑한 후 앱이 대상 폴더를 읽을 수 있는지, 필요한 경우 쓸 수도 있는지 확인하세요. 불필요하게 모든 사용자에게 쓰기 권한을 부여하지는 마세요.
이동한 미디어 경로 FAQ
미디어를 옮긴 후 Jellyfin에서 파일이 사라진 이유는 무엇인가요?
Jellyfin의 Docker 바인드 마운트가 여전히 기존 호스트 폴더를 가리키고 있었기 때문입니다.
소스 사용자가 GUI 선택기가 도움이 되었다고 확인했나요?
예. 사용자는 경로 선택기가 있는 줄 몰랐으며, 이를 사용해 혼동이 해결되었다고 곧바로 답했습니다.
새 저장 장치마다 /DATA를 입력해야 하나요?
아니요. 해당 저장 장치에 대해 ZimaOS에 표시되거나 선택되는 실제 호스트 경로를 사용하세요.
