ncdu - NCurses Disk Usage Analyzer Cheatsheet
ncdu (NCurses Disk Usage)는 완전히 터미널에서 실행되는 상호작용하는 디스크 사용량 분석기입니다. 디렉토리 트리를 한 번 스캔한 후 크기별로 정렬하여 탐색하고, 하위 디렉토리로 드릴 인하고, 파일이나 폴더를 즉시 삭제할 수 있습니다. 터미널만 필요하므로 headless 또는 SSH를 통한 원격 서버에서 공간을 먹는 것이 무엇인지 찾는 go-to 도구입니다.
Installation
| Platform | Command |
|---|
| Ubuntu/Debian | sudo apt install ncdu |
| Fedora/RHEL | sudo dnf install ncdu |
| Arch Linux | sudo pacman -S ncdu |
| openSUSE | sudo zypper install ncdu |
| Alpine | sudo apk add ncdu |
| macOS (Homebrew) | brew install ncdu |
| FreeBSD | sudo pkg install ncdu |
Basic Usage
| Command | Description |
|---|
ncdu | 현재 디렉토리 스캔 |
ncdu / | 전체 파일 시스템 스캔 |
ncdu /var/log | 특정 경로 스캔 |
ncdu -x / | 한 파일 시스템에 머물기 (마운트 포인트를 넘지 않음) |
sudo ncdu / | 보호된 파일을 포함하도록 루트로 스캔 |
ncdu --help | 모든 옵션 표시 |
Navigation Keys
| Key | Action |
|---|
↑ / ↓ 또는 j / k | 선택 이동 |
→ / Enter 또는 l | 선택한 디렉토리 진입 |
← 또는 h | 부모 디렉토리로 이동 |
n | 이름별 정렬 |
s | 크기별 정렬 (기본값) |
C | 항목 개수별 정렬 |
a | 명백한 크기와 디스크 사용량 토글 |
g | 백분율 / 그래프 표시 토글 |
? | 도움말 화면 |
q | 종료 |
Managing Files
| Key | Action |
|---|
d | 선택한 파일 또는 디렉토리 삭제 |
i | 선택한 항목에 대한 정보 표시 |
t | 정렬에서 파일 전 디렉토리 토글 |
e | 숨긴 파일 표시/숨기기 |
r | 현재 디렉토리 재계산 (재스캔) |
Export & Import (Remote Workflows)
ncdu는 스캔을 파일에 저장하고 나중에 또는 다른 곳에서 볼 수 있습니다 — SSH 세션을 유지하지 않고도 서버를 감사하는 데 유용합니다.
| Command | Description |
|---|
ncdu -o scan.json / | 스캔하고 결과를 파일로 내보내기 |
ncdu -o- / > scan.json | stdout으로 내보내기 (파일로 리디렉트) |
ncdu -f scan.json | 이전에 저장한 스캔 열기 (오프라인) |
ssh host 'ncdu -o- /' > scan.json | 원격 상자 스캔, 로컬에서 탐색 |
Options Worth Knowing
| Option | Description |
|---|
-x | 파일 시스템 경계를 넘지 마기 |
--exclude PATTERN | glob과 일치하는 경로 건너뛰기 |
--exclude-kernfs | 슈도 파일 시스템 건너뛰기 (/proc, /sys) |
-r | 읽기 전용 모드 (삭제 비활성화) |
-q | 느린 링크에 대해 조용함/느린 새로고침 |
--color dark | 색상 scheme 활성화 |
Common Workflows
# 서버에서 가장 큰 공간 낭비 찾기, 안전하게 (읽기 전용)
sudo ncdu -x -r /
# 상호작용하는 세션 없이 원격 호스트 감사
ssh prod-box 'ncdu -o- -x /' > prod-scan.json
ncdu -f prod-scan.json
# 빌드 캐시 디렉토리를 대화형으로 정리
ncdu ~/.cache # navigate, press d to delete
| Tool | Style | Best for |
|---|
| ncdu | 상호작용하는 TUI | 탐색 + 삭제, 원격 서버 |
| dust | One-shot 트리+막대 | 빠른 시각적 개요 (Rust) |
| duf | 마운트/사용량 테이블 | ”내 디스크가 얼마나 찼나?“ |
| du | 순수 텍스트 | 스크립팅 및 파이프라인 |
Resources
