디스크 여유가 있는데 파일을 못 만든다면: df -h와 df -i를 함께 보는 이유

2026년 10월 20일

저장 용량과 inode 정보를 구분해 살피는 돋보기와 파일 목록의 3D 일러스트

🤖 AI Summary

디스크 용량이 남아 있어도 파일 생성은 실패할 수 있습니다. 바이트 용량과 inode 사용량은 서로 다른 확인 항목입니다. GNU df에서는 문제가 난 경로를 지정해 df -h와 df -i를 함께 읽습니다. 두 항목에 여유가 있어도 권한·할당량·읽기 전용 상태를 구분해야 합니다.

블로그 목차

파일 저장이 실패했는데 디스크 사용률은 높지 않은 상황이 있습니다. 이때 서버 전체의 남은 용량만 보고 저장 공간 문제를 제외하기는 어렵죠. 실제로 쓰려던 경로가 어느 파일시스템에 속하는지 맞추는 것이 출발점이죠.

남은 용량과 남은 inode는 왜 다른가요?

파일 내용에 쓸 공간과 파일의 메타데이터를 관리하는 inode는 구분해서 확인해야 하는 자원입니다.

inode는 파일 크기를 다른 단위로 표현한 값이 아닙니다. Linux 커널의 ext4 inode 문서는 파일의 시간 정보와 블록 매핑 등 메타데이터를 inode에 저장한다고 설명합니다. 파일 내용을 담을 공간이 남았다는 결과만으로 메타데이터 쪽 여유까지 확인한 셈은 아니죠.

작은 파일이 많이 생기는 작업은 용량과 inode를 함께 볼 계기가 됩니다. 같은 총용량이라도 파일을 만드는 방식과 개수가 다를 수 있기 때문이죠. 이 설명은 원인 후보를 좁히는 관점이며, 특정 서비스에서 inode 부족이 발생했다는 사례는 아닙니다.

다만 모든 파일시스템의 inode 공급 방식이 같다고 생각하면 안 됩니다. ext4의 구조를 모든 Linux 저장소의 고정 한계로 일반화하지 말아야 하죠. 파일시스템 종류와 실제 보고 값을 함께 살펴봐야 하죠.

같은 파일시스템에서 용량과 inode를 나누어 확인하고 실제 오류와 함께 판단

df -h와 df -i는 각각 무엇을 보여주나요?

GNU df의 -h는 공간을 읽기 쉬운 용량 단위로, -i는 블록 대신 inode 사용 정보로 보여줍니다.

GNU df 매뉴얼에서 -h와 -i의 목적을 확인할 수 있습니다. -h는 표시 단위를 바꾸는 옵션이며, -i가 보여주는 것은 별도의 자원 정보죠.

확인 명령	읽을 항목	결과의 범위
`df -h /var/lib/myapp`	Avail과 Use% 등 공간 정보	지정 경로가 속한 파일시스템의 용량입니다.
`df -i /var/lib/myapp`	IFree와 IUse% 등 inode 정보	같은 파일시스템이 보고한 inode 여유입니다.
`df -T /var/lib/myapp`	Type 등 파일시스템 정보	구현별 차이를 살필 때 함께 남길 정보입니다.

표의 경로는 예시이므로 실제로 존재하는 저장 디렉터리로 바꿔 사용합니다. 명령은 파일 삭제나 설정 변경을 수행하지 않습니다. Linux의 모든 도구가 GNU 구현인 것은 아니므로 로컬 매뉴얼도 확인하세요.

inode 사용률만 따로 보는 것도 충분하지 않죠. 공간과 inode 중 어느 쪽이 부족한지, 같은 대상의 결과인지 함께 읽어야 해요.

오류가 난 경로의 파일시스템은 어떻게 확인하나요?

생성에 실패한 파일을 대신해 실제로 존재하는 부모 디렉터리를 지정하고 두 결과의 마운트 대상을 맞춥니다.

GNU df는 인자로 받은 경로가 속한 파일시스템의 공간을 보여줍니다. 경로 없이 실행한 목록에서 여유 있는 행 하나만 고르면, 저장 대상과 다른 곳을 볼 수 있죠.

예를 들어 서비스가 /var/lib/myapp에 저장한다면 두 명령에도 그 디렉터리를 지정해야 하죠. /에 여유가 있어도 저장 경로가 별도 파일시스템에 있으면 그 결과만으로 판단할 수 없습니다. 출력의 Filesystem과 Mounted on을 함께 기록하면 대상을 맞추기 쉬워요.

아직 만들어지지 않은 파일 경로를 그대로 넣는 대신, 그 파일이 생성될 기존 부모 디렉터리를 확인합니다. 중간 디렉터리도 없다면 실제로 존재하는 상위 경로와 생성 실패 지점을 먼저 구분해야 하죠.

컨테이너 안에서 실패한 작업이라면 그 작업이 보는 경로를 기준으로 확인합니다. 호스트에서 이름이 비슷한 디렉터리를 본 것만으로 같은 저장소를 확인했다고 결론 내리지 마세요. 작업 환경과 경로를 함께 남기는 것이 좋아요.