맥에서 Docker가 용량을 차지하고 있습니다

1. Docker가 무엇을 쓰고 있다고 보는지 확인

언제나 여기서 시작하세요. 이미지, 컨테이너, 볼륨, 빌드 캐시로 나누어 각각 얼마나 회수 가능한지 알려줍니다.

docker system df -v

2. 빌드 캐시 비우기

이미지를 자주 빌드하는 머신에서는 보통 이것이 가장 큰 단일 항목이면서 제거하기 가장 안전합니다. 다음 빌드가 느려질 뿐입니다.

docker builder prune -a

3. 정말로 쓰이지 않는 것 정리

멈춘 컨테이너, 떠 있는 이미지, 쓰이지 않는 네트워크:

docker system prune

다음을 붙이면 -a 실행 중인 컨테이너가 쓰지 않는 이미지까지 모두 제거됩니다. 나중에 다시 받아야 한다는 뜻입니다. 다음 옵션은 --volumes 확신이 있을 때만 붙이세요: 볼륨에는 데이터베이스의 데이터가 들어 있습니다. 이 페이지에서 다시 내려받을 수 없는 것을 파괴하는 유일한 명령입니다.

4. 손대기 전에 볼륨 목록 확인

실제로 무엇이 사라질지 확인하세요:

docker volume ls
docker volume ls -f dangling=true

5. macOS가 파일을 회수하게 하기

prune 이후, 해제된 블록을 돌려주는 공식적인 방법이 Docker Desktop에 있습니다: 설정 → 리소스 → 고급 → 디스크 사용량, 또는 Docker Desktop을 종료했다 다시 열면 시작할 때 TRIM이 실행됩니다. 1분쯤 기다렸다가 파일 크기를 다시 확인한 뒤에 효과가 없었다고 판단하세요.

6. 디스크 한도 낮추기

다음 위치의 설정 → 리소스에서 가상 디스크 한도는 Docker.raw가 얼마나 커져도 되는지를 정합니다. 낮춘다고 그 자체로 공간이 생기지는 않지만, 문제의 상한을 정할 수 있습니다. 「혹시 몰라서」 올린 것이 그 파일이 64GB가 된 이유입니다.

7. 최후의 수단

설정 → 문제 해결 → Clean / Purge data 는 가상 머신의 디스크를 완전히 초기화해 파일을 거의 0으로 되돌립니다. 가지고 있는 모든 이미지, 컨테이너, 볼륨이 지워집니다. 다른 방법이 통하지 않고, 볼륨에 무엇이 있는지 알고 있을 때 쓰세요.

Finder에서 Docker.raw를 지우지 마세요. 캐시 파일이 아니라 Docker 설치 전체의 데이터이며, Docker가 실행 중일 때 제거하면 결국 초기화가 필요한 상태로 가상 머신이 남을 수 있습니다.