Docker가 읽기 전용 경로를 전달하거나 호스트 파일 시스템이 쓰기 작업을 더 이상 허용하지 않으면 Docker 바인드 마운트는 읽기 전용이 됩니다.
바인드 마운트는 호스트 경로를 컨테이너 내부에 직접 노출하므로, 컨테이너 자체로는 근본적인 디스크, 파일 시스템, 마운트 플래그 또는 보안 정책을 복구할 수 없습니다. 가장 안전한 복구 방법은 쓰기 작업을 중단하고, 컨테이너 마운트와 호스트 마운트를 비교하고, 읽기 전용 동작이 설정된 것인지 오류로 인해 발생한 것인지 확인한 뒤, 애플리케이션을 다시 시작하기 전에 스토리지 상태를 복구하는 것입니다.
어떤 경로가 읽기 전용인지 확인하기
컨테이너 안에서 바인드 대상 경로에 쓰기 작업을 하나 시도하고, 호스트에서 원본 경로에도 쓰기 작업을 하나 시도하세요. 모든 권한 오류가 읽기 전용 파일 시스템을 뜻한다고 가정하지 말고 정확한 오류 메시지를 기록하세요.
Docker 포럼 사례에 따르면 읽기 전용 상위 바인드 마운트에서는 Docker가 중첩 마운트 지점을 만들지 못할 수 있습니다. 필요한 디렉터리를 읽기 전용 상위 파일 시스템에 만들 수 없기 때문입니다.
호스트에서는 쓸 수 있지만 컨테이너에서는 쓸 수 없다면 Docker 마운트 옵션과 보안 제어를 살펴보세요. 양쪽 모두 읽기 전용 파일 시스템 오류가 발생한다면 컨테이너 사용자를 변경하는 작업은 중단하고 호스트 마운트와 스토리지 장치 진단으로 넘어가세요.
Docker의 실제 마운트 플래그 확인하기
현재 Compose 파일만 보지 말고 실행 중인 컨테이너 설정을 확인하세요. 원본, 대상, 전파 모드와 함께 :ro, 긴 형식 구문, 오버라이드 파일 또는 배포 도구를 통해 마운트가 읽기 전용으로 표시되었는지 확인하세요.
Docker 클라이언트 문제 사례에는 런타임 설정이 의도한 읽기-쓰기 구성과 달라 마운트 경로가 읽기 전용으로 표시된 경우가 기록되어 있습니다. 중요한 근거는 실행 중인 컨테이너에 적용된 실제 마운트 모드입니다.
마운트가 의도적으로 읽기 전용으로 설정된 경우, 애플리케이션에 쓰기 작업이 실제로 필요한 때에만 해당 플래그를 제거하세요. 선언을 변경한 후 컨테이너를 다시 만드세요. Compose 파일을 수정해도 기존 마운트에는 소급 적용되지 않기 때문입니다.
호스트가 파일 시스템을 읽기 전용으로 다시 마운트했는지 확인하기
호스트 마운트 테이블, 커널 로그, 스토리지 로그, 파일 시스템 상태에서 I/O 오류, 저널 오류, 체크섬 오류, 장치 재설정 또는 보호를 위한 재마운트가 있었는지 확인하세요. 보호 기능이 작동한 이유를 파악하기 전에는 강제로 읽기-쓰기로 다시 마운트하지 마세요.
Unraid 지원 사례에서는 파일 시스템이 읽기 전용이 된 후 Docker 앱 데이터에 문제가 발생했으며, Plex 디렉터리를 만들 때 오류가 발생했습니다. 이러한 양상은 컨테이너 권한 설정보다는 호스트 파일 시스템 문제를 가리킵니다.
영향을 받는 컨테이너를 중지하고 진단 정보를 보존하세요. 플랫폼에서 지원하는 유지 관리 절차를 통해 디스크, 풀, 케이블, 파일 시스템 또는 저널을 복구한 다음, 데이터베이스나 미디어 컨테이너에 다시 쓰기를 허용하기 전에 호스트 경로가 정상인지 확인하세요.
중첩되거나 겹치는 마운트 검사
대상 경로가 다른 마운트 디렉터리 안에 위치한 바인드 마운트와 이름 있는 볼륨을 모두 나열하세요. 마운트가 겹치면 디렉터리가 가려지거나 예상치 못한 접근 동작이 적용될 수 있으며, Docker가 읽기 전용 상위 경로 아래에 마운트 지점을 만들어야 할 수도 있습니다.
Server Fault의 한 토론에서는 서로 연관된 컨테이너 경로에 읽기-쓰기 마운트와 더 넓은 범위의 읽기 전용 마운트를 겹쳐 설정하면 결과가 혼란스러워질 수 있다고 설명합니다. 이 배치의 다른 곳에서 이미 해당 도메인을 사용했으므로, 여기서 적용할 실용적인 원칙은 권한을 변경하기 전에 전체 대상 트리를 매핑하는 것입니다.
컨테이너를 시작하기 전에 필요한 호스트 디렉터리를 만들고, 런타임이 직접 생성해야 하는 읽기 전용 상위 경로 아래에 쓰기 가능한 하위 경로를 마운트하지 마세요. Compose 파일에는 영구 저장 경로를 명시적으로 지정하세요. 마운트 트리를 단순화한 뒤 컨테이너를 다시 만드세요.
읽기 전용 상태를 권한 및 보안 정책 문제와 구분하기
쓰기 테스트에서 발생한 오류를 원본 디렉터리의 소유자, 모드, ACL, SELinux 레이블, AppArmor 프로필, 컨테이너 사용자 ID와 비교하세요. 권한 거부와 읽기 전용 파일 시스템은 서로 다른 오류이므로 각각 다른 방식으로 복구해야 합니다.
스토리지 문제 해결 가이드에서는 읽기 전용 볼륨 문제를 마운트 플래그, 파일 시스템 오류, 보안 컨텍스트, 스토리지 드라이버 문제로 분류합니다. 이런 분류를 통해 스토리지 계층의 읽기 전용 상태에 무턱대고 chmod 777을 적용하는 일을 방지할 수 있습니다.
권한이 잘못된 경우, 컨테이너에 사용할 UID와 GID를 지정해 호스트에서 소유권이나 ACL을 수정하세요. 파일 시스템 자체가 읽기 전용이면 권한 변경은 실패하므로, 파일 시스템 복구를 대신하는 방법으로 사용해서는 안 됩니다.
호스트 쓰기 테스트를 통과한 후에만 애플리케이션 다시 시작하기
호스트 경로에 임시 파일을 쓰고, 동기화하고, 읽고, 삭제한 다음, 동일한 마운트 선언과 사용자로 단기간 실행되는 테스트 컨테이너에서도 같은 작업을 반복하세요. 재부팅 후에도 예상한 파일 시스템이 마운트된 상태인지 확인하세요.
스토리지를 쓰기 가능한 상태로 만든 뒤에도 애플리케이션이 계속 재시작을 반복한다면, 다음 단계로 컨테이너 재시작의 종속성 파악하기에 관한 ZimaSpace 가이드를 확인하세요.
호스트 파일 시스템이 정상이고, Docker가 실제로 적용하는 마운트가 설계상 읽기-쓰기로 설정되어 있으며, 애플리케이션이 영구 파일을 업데이트할 수 있고, 지속적으로 사용해도 새로운 I/O 오류나 파일 시스템 오류가 나타나지 않아야 복구가 완료된 것입니다.
지원 및 팁
더 읽어보기

How to Keep Adult Videos on Your NAS Hidden from Family Members
Keep adult videos private on a family NAS. Check folder permissions, Plex and Jellyfin library access, thumbnails, watch history, shared TV logins and DLNA.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



