대용량 데이터 풀에 테라바이트 단위의 여유 공간이 있더라도 시스템 파티션이 가득 차면 NAS 앱이 중단될 수 있습니다.
앱은 로그, 데이터베이스, 임시 파일, 업데이트, 컨테이너 레이어, 소켓 및 설정 변경 내용을 기록할 로컬 공간이 필요합니다. 가득 찬 마운트를 확인하고, 앱 오류를 실패한 쓰기 작업과 연결한 다음, 공간을 차지하는 항목을 찾아 해당 항목을 관리하는 구성 요소를 통해 공간을 확보하세요.
시스템 파티션이 가득 찬 마운트인지 확인하기
마운트된 모든 파일 시스템을 확인하고 루트, 부팅, 애플리케이션, 컨테이너 및 데이터 경로를 매핑하세요. 가장 먼저 공간이 가득 찬 마운트를 정확히 확인해야 합니다. 데이터 풀에 여유 공간이 있어도 루트 파일 시스템을 대상으로 한 쓰기 작업에는 사용할 수 없기 때문입니다.
블록 용량은 df -h로, 파일 레코드는 df -i로 확인하세요. 사용 가능한 블록과 inode는 별도의 한도이므로 둘 중 하나가 고갈되면 해당 경로에 새 파일을 만들 수 없습니다.
| 앱 증상 | 쓰기에 실패한 것으로 추정되는 항목 | 확인 항목 |
|---|---|---|
| 로그인 또는 데이터베이스 오류 | 데이터베이스 저널 또는 소켓 | 앱 로그 및 데이터베이스 경로 |
| 업데이트 또는 설치 실패 | 패키지 캐시 또는 임시 파일 | 루트 및 임시 마운트 |
| 컨테이너가 시작되지 않음 | Overlay 레이어, 로그 또는 상태 데이터 | 컨테이너 저장 공간 사용량 |
| 업로드 실패 | 임시 스테이징 경로 | 설정된 임시 디렉터리 |
앱 오류와 쓰기 공간 부족 연결하기
앱, 데이터베이스, 컨테이너 및 시스템 로그에서 “공간 부족”, 읽기 전용 파일 시스템, 저널 실패 또는 임시 파일 생성 불가 메시지를 확인하세요. 앱은 메모리에 있는 웹 페이지를 계속 표시하면서도 백그라운드 작업, 업로드 및 데이터베이스 커밋은 실패할 수 있습니다.
타임스탬프를 기록하고 문제가 발생한 경로에 무해한 쓰기 작업을 한 번 테스트하세요. 증거를 저장할 때까지 광범위한 재시작은 피하세요. 모든 앱을 재시작하면 로그가 더 쌓이고, 최초 오류가 가려지며, 다음에 어떤 서비스가 실패할지도 달라질 수 있습니다.
로그, 컨테이너 레이어, inode 및 삭제된 파일 찾기
시스템의 최상위 디렉터리 사용량을 측정한 다음, 가장 큰 디렉터리를 자세히 살펴보세요. 공간을 많이 차지하는 항목으로는 저널, 애플리케이션 로그, 이미지 레이어, 빌드 캐시, 크래시 덤프, 패키지 캐시, 썸네일, 임시 파일 등이 있습니다. 내용을 파악하기 어려운 데이터 디렉터리를 삭제하기 전에 앱이나 컨테이너 관리자의 사용량 보고서를 확인하세요.
디렉터리별 사용량으로 파일 시스템 사용량이 설명되지 않는다면, 삭제된 파일을 계속 열어 둔 프로세스가 있는지 확인하세요. inode가 부족하다면 작은 캐시 파일이나 세션 파일이 대량으로 들어 있는 디렉터리를 찾으세요. 복구 후에는 긴급하게 파일을 삭제하는 일을 반복하지 않도록 로그 순환 및 보존 기간 제한을 설정하세요.
안전하게 공간을 확보하고 복구 상태 확인하기
문서화된 정리 절차부터 진행하세요. 로그를 순환하거나 vacuum으로 정리하고, 사용하지 않는 것이 확인된 패키지 캐시를 삭제하고, 사용하지 않는 컨테이너 아티팩트만 정리하며, 도구를 사용해 오래된 크래시 덤프를 삭제하세요. 검증된 백업을 확보하기 전까지 데이터베이스, 이름 지정 볼륨, 활성 이미지, 설정은 보존하세요.
파일 시스템 및 inode 사용량을 다시 확인한 다음, 영향을 받은 종속 서비스 체인만 재시작하고 실제로 앱에 쓰기 작업을 해 보세요. 복구가 계속 실패하면 공간이 여전히 원인이라고 단정하지 말고 재부팅 후 서비스 시작 순서를 살펴보세요.
FAQ
NAS 데이터 풀에 여유 공간이 있는데 앱이 실패하는 이유는 무엇인가요?
앱이 데이터베이스, 로그, 임시 파일 또는 컨테이너 상태를 용량이 더 작은 시스템 파티션에 기록할 수 있습니다. 마운트 지점 간에 용량이 자동으로 공유되지는 않습니다.
로그 파일을 삭제하면 문제가 더 심해질 수 있나요?
네. 실행 중인 프로세스가 삭제된 로그 파일을 계속 열어 두면 경로는 사라져도 공간은 계속 차지할 수 있습니다. 해당 서비스의 올바른 절차에 따라 로그를 순환하거나 비우세요.
시스템 파티션에 여유 공간을 얼마나 남겨 두어야 하나요?
일률적인 비율은 없습니다. 업데이트, 로그, 데이터베이스 유지 관리, 컨테이너 증가, 복구 작업을 위한 여유 공간을 충분히 확보한 다음, 증가 속도와 남은 용량을 모두 기준으로 알림을 설정하세요.
지원 및 팁
더 읽어보기

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

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

홈 서버에서 Open WebUI 코딩 에이전트 예약 실행하는 방법
Open WebUI에서 보고 전용 코딩 에이전트 자동화를 설정하고, 터미널과 작업 공간을 선택한 다음 권한, 로그 및 오류 복구를 확인하세요.



