로그, 캐시, 임시 파일 또는 의도치 않은 쓰기 작업이 Docker의 로컬 저장소에 남아 있으면 컨테이너가 시스템 디스크를 가득 채울 수 있습니다.
미디어 라이브러리나 데이터베이스 볼륨을 다른 풀로 옮겨도 컨테이너 이미지, 쓰기 가능 레이어, JSON 로그, BuildKit 캐시, 메타데이터, 마운트 목록에서 빠진 경로는 옮겨지지 않습니다. 외부 마운트에 실패하면 예상한 호스트 디렉터리가 비어 있을 수도 있습니다. 이 경우 명확한 오류 없이 애플리케이션이 시스템 디스크에 새 데이터를 기록할 수 있습니다.
애플리케이션 데이터 검사 전에 Docker 루트 사용량 측정하기
Docker 데이터 루트가 있는 파일시스템을 확인하고, 호스트 디렉터리 크기를 Docker의 이미지, 컨테이너, 볼륨, 빌드 캐시 사용량과 비교하세요. 삭제하기 전에 사용량을 기록해 두세요.
Cloudron 사용자는 /var/lib/docker/overlay2가 눈에 보이는 애플리케이션 데이터 전체보다 더 많은 공간을 차지하는 것을 발견했습니다. 이는 외부 라이브러리와 별도로 Docker 저장소 루트의 사용량을 측정해야 하는 이유를 보여줍니다.
시스템 디스크는 가득 찼지만 외부 풀에는 여유 공간이 있다면 컨테이너, 오버레이 레이어, 볼륨, 이미지, 빌드 캐시 중 어디에서 용량이 늘어나는지 파악하세요. 활성 데이터와 복구 가능한 데이터를 분류하기 전에는 광범위한 정리 작업을 실행하지 마세요.
제한 없이 커지는 컨테이너 JSON 로그 확인하기
로그 드라이버와 각 컨테이너 로그 파일의 크기를 확인하세요. 서비스의 주요 데이터는 다른 곳에 저장하더라도 Docker의 로컬 컨테이너 디렉터리에서 stdout과 stderr 로그가 무한정 커질 수 있습니다.
Code Maven은 기본 로그 파일이 요약에 포함되지 않은 채 계속 커져서 docker system df로는 주된 문제가 드러나지 않았던 사례를 소개합니다. 눈에 띄지 않는 공간 점유 요인은 계속 커지는 컨테이너 로그였습니다.
로그를 로테이션하거나 잘라내기 전에 로그를 폭증시키는 애플리케이션 오류를 찾아 해결하세요. 향후 컨테이너에 적용할 로그 로테이션 한도를 설정하고, 새 로그 파일이 예상 한도에서 더 이상 커지지 않는지 확인하세요.
컨테이너 쓰기 가능 레이어에 기록된 데이터 찾기
의도한 영구 저장 경로와 애플리케이션의 실제 캐시, 트랜스코딩, 다운로드, 데이터베이스, 썸네일, 백업, 임시 디렉터리를 비교하세요. 마운트되지 않은 경로에 쓰인 데이터는 시스템 디스크의 컨테이너 쓰기 가능 레이어에 남습니다.
Docker 포럼의 설명에 따르면 쓰기 작업과 변경된 이미지 파일은 쓰기 가능 레이어에 저장되고, 로테이션되지 않은 대용량 로그는 컨테이너 메타데이터에 저장됩니다. 외부 데이터 볼륨이 있어도 이 두 가지 때문에 컨테이너 하나가 로컬 공간을 거의 전부 차지할 수 있습니다.
컨테이너별 크기 보고 기능을 사용해 컨테이너 내부에서 변경된 경로 중 가장 큰 항목을 검사합니다. 유지해야 하는 데이터에만 명시적 바인드 마운트 또는 명명된 볼륨을 추가한 다음, 중요한 데이터를 백업한 후 컨테이너를 다시 생성해 더는 필요하지 않은 쓰기 가능 레이어의 콘텐츠를 제거합니다.
컨테이너 시작 시 외부 마운트가 적용되어 있었는지 확인
Docker가 컨테이너를 시작하기 전에 SSD, NAS 공유 또는 스토리지 풀이 예상한 호스트 경로에 마운트되었는지 확인합니다. 장치 식별 정보와 마운트 출력을 컨테이너에서 확인되는 디렉터리와 비교합니다.
외부 마운트가 없어도 시스템 파일 시스템에는 비어 있는 기본 디렉터리가 남아 있을 수 있습니다. 컨테이너가 이 대체 디렉터리에 정상적으로 쓸 수 있어 외부 풀에는 변화가 없는데 시스템 디스크 사용량만 증가할 수 있습니다.
데이터가 있는 대체 저장 위치 위에 스토리지를 다시 마운트하기 전에 컨테이너를 중지합니다. 숨겨진 파일을 안전하게 이동하거나 정리하고, 마운트 종속성 또는 시작 시 검사를 추가해 예상한 장치가 없으면 애플리케이션 시작을 거부합니다.
이미지 레이어, 빌드 캐시, 방치된 객체 검사
사용하지 않는 이미지, 중지된 컨테이너, 익명 볼륨, BuildKit 캐시를 검토합니다. 애플리케이션의 영구 데이터가 다른 위치에 올바르게 마운트되어 있어도 업데이트나 로컬 빌드를 자주 수행하면 여러 레이어가 누적될 수 있습니다.
Moby 프로젝트 포럼의 설명에 따르면 오버레이 마운트로 인해 디스크 용량 수치가 혼란스러울 수 있으며, 실제 파일 시스템 사용량을 신중하게 해석해야 합니다. 별도의 Home Assistant 사례에서도 시간이 지나면서 로그와 레이어로 인해 overlay2 사용량이 증가하는 현상이 나타났습니다.
현재 Compose 프로젝트와 백업에서 사용하지 않는 것으로 확인된 객체만 제거합니다. Docker 메타데이터 참조가 불일치할 수 있으므로 개별 overlay2 디렉터리를 직접 삭제하지 마세요.
증가 기준선을 사용해 수정 사항 검증
문제의 원인이 된 경로를 수정한 후, 이전에 사용량 증가를 유발했던 워크로드를 진행하면서 정기적으로 Docker 루트 사용량, 로그 크기, 컨테이너 쓰기 가능 영역 크기, 외부 풀 사용량을 기록합니다.
대규모 NAS 전송을 준비하는 ZimaSpace 워크플로는 의도한 풀에 데이터가 저장되는지 확인할 수 있는 반복 가능한 부하를 제공합니다.
시스템 디스크 사용량이 예상된 이미지 및 로그 동작에 맞게 증가하고, 영구 애플리케이션 데이터는 외부 풀에 저장되며, 외부 마운트가 없을 때 루트 파일 시스템에 조용히 쓰는 대신 안전하게 시작이 실패해야 문제가 해결된 것입니다.
지원 및 팁
더 읽어보기

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 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



