이 초보자용 튜토리얼은 실제 혼란의 원인을 해결했습니다. ZimaOS Files에 표시되는 이름과 경로가 애플리케이션이 Docker 컨테이너 내부에서 보는 경로와 항상 같은 것은 아닙니다. 원 게시자는 웹 터미널을 사용해 디스크 마운트 지점을 확인한 다음, 호스트 저장소 폴더를 Immich 또는 Syncthing에 다음과 같이 더 간단한 컨테이너 경로로 매핑했습니다. /SYNC.
이후 스레드에는 중요한 정정 내용이 추가되었습니다. ZimaOS에서 관리형 저장소 경로를 제공할 수 있는 경우, 원시 마운트 경로를 장기적으로 선호되는 앱 저장소 인터페이스로 취급해서는 안 됩니다. 최신 ZimaOS에서는 2025년의 작업 흐름보다 이 과정이 훨씬 간단합니다.
원본 튜토리얼은 개발자 모드에서 시작했습니다
사용자는 마운트 지점을 확인하기 위해 lsblk를 사용했습니다
앱 설정을 열고 볼륨 추가
호스트 열과 컨테이너 열은 서로 다른 의미를 가집니다
컨테이너 경로가 다음과 같다면 /SYNC애플리케이션은 다음 경로를 사용해야 합니다. /SYNC 또는 다음과 같은 하위 폴더라면 /SYNC/Photos호스트 마운트 경로로 다시 지정해서는 안 됩니다.
커뮤니티 답변, 원시 /mnt 경로 사용에 주의 당부
다른 참여자는 직접 지정한 원시 마운트 경로가 디스크 새로 고침, 풀 재구축 또는 기타 저장소 작업 후 변경될 수 있으며 ZimaOS 저장소 계층의 가정을 우회할 수 있다고 지적했습니다.
응답자는 다음과 같은 안정적인 ZimaOS 관리 저장소를 매핑할 것을 권장했습니다. /DATA/Media 또는 임의의 원시 마운트 식별자를 기준으로 앱을 구성하는 대신, 의도한 AppData 위치를 사용하세요.
IceWhale, 기본적으로 외부 미디어가 /media 아래에 있다고 명확히 밝혀
Zima-Giorgio는 외부 저장 매체 경로가 다음 위치 아래에 배치된다고 덧붙였습니다. /media 기본적으로. 해당 공식 안내는 다음에 나오는 내부 애플리케이션 데이터 예시와 외부 저장소를 구분하는 데 도움이 됩니다. /DATA.
현재 ZimaOS에서는 경로 모델이 더 명확합니다
2026년 8월까지 원 튜토리얼 작성자는 이후 사용자에게 최신 ZimaOS 버전에서는 이 과정이 훨씬 쉬워졌다고 설명했습니다.
현재 IceWhale 지침은 앱 설정에서 ZimaOS 호스트 저장소와 컨테이너 경로를 매핑하는 방법을 설명합니다. 낮은 수준의 마운트 출력에서 경로를 수동으로 구성하기 전에 먼저 이 방법을 사용하세요.
파일 선택기 또는 사용 가능한 경우 관리형 저장소를 사용하세요
일반 앱의 경우 현재 가장 안전한 작업 방식은 앱의 볼륨 설정에서 원하는 ZimaOS 저장 공간에 있는 실제 폴더를 선택하고, 앱에서 요구하는 컨테이너 경로를 선택하거나 유지한 다음, 저장하고 애플리케이션 내부에서 해당 컨테이너 경로를 사용하는 것입니다.
애플리케이션 폴더에 원시 디바이스 노드를 사용하지 마세요
소스 스크린샷에는 다음으로 시작하는 경로가 포함되어 있습니다. /dev/... 실험적인 볼륨 매핑에서 사용되는 경로입니다. 블록 디바이스 노드는 마운트된 파일 시스템 디렉터리와 같지 않습니다. Syncthing 및 Immich와 같은 일반 애플리케이션에는 마운트되지 않은 원시 디스크 디바이스가 아니라 마운트된 폴더를 전달해야 합니다.
/DATA는 모든 디스크를 가리키는 자리 표시자가 아니라 ZimaOS 데이터 위치입니다
이후 한 초보 사용자가 다음과 같은 경로인지 물었습니다. /DATA 단순히 “모든 경로를 여기서 시작하라”는 의미일 뿐입니다. 그렇지 않습니다. /DATA 는 시스템에서 관리하는 애플리케이션 및 사용자 데이터에 사용되는 ZimaOS 관리형 데이터 위치입니다. 별도의 외부 저장소는 다음 경로 아래에 표시될 수 있습니다. /media 또는 ZimaOS에서 등록한 방식에 따라 다른 관리형 저장소 경로를 사용하세요.
중요한 규칙은 원하는 저장 공간에서 실제 호스트 폴더를 선택한 다음, 이를 안정적인 컨테이너 경로에 매핑하는 것입니다.
튜토리얼 작성자는 이후 최신 ZimaOS에서 이 작업이 더 쉬워졌다고 설명했습니다
2026년 8월, 원 작성자가 돌아와 다른 초보 사용자에게 최신 ZimaOS 릴리스에서는 작업 과정이 간소화되었다고 설명했습니다. 이후의 이 댓글은 역사적 경계를 다시 확인해 줍니다. 호스트 경로와 컨테이너 경로를 이해하려면 2025년 터미널 스크린샷을 사용하되, 현재의 모든 마운트 지점을 수동으로 찾을 필요는 없습니다.
외부 드라이브 액세스 FAQ
Docker 볼륨에서 실제 디스크 경로는 어느 쪽인가요?
호스트 측입니다.
Immich, Syncthing 또는 다른 앱은 내부적으로 어떤 경로를 사용해야 하나요?
볼륨 매핑에서 구성한 컨테이너 측 경로입니다.
모든 앱을 /mnt 또는 디바이스 노드에 직접 지정해야 하나요?
아니요. ZimaOS에서 제공하는 안정적인 관리형 저장소 경로를 우선 사용하세요.
IceWhale은 외부 미디어가 기본적으로 어디에 마운트된다고 말했나요?
Zima-Giorgio는 외부 저장 미디어가 다음 경로 아래에 있다고 말했습니다. /media 기본적으로.
