[250617 TIL] Docker dangling 이미지 삭제

Docker Desktop에서 <none> 이미지가 "in use" 상태로 표시되어 삭제되지 않는 문제

1. 숨겨진 컨테이너 확인 및 정리

터미널에서 다음 명령어로 모든 컨테이너(중지된 것 포함)를 확인해보세요:

# 모든 컨테이너 확인 (중지된 것 포함)
docker ps -a

# 중지된 모든 컨테이너 삭제
docker container prune -f

2. Dangling 이미지 정리

태그가 없는 이미지들을 정리합니다:

# dangling 이미지 확인
docker images -f "dangling=true"

# dangling 이미지 삭제
docker image prune -f

3. 네트워크 및 볼륨 정리

이미지가 네트워크나 볼륨에 연결되어 있을 수 있습니다:

# 사용하지 않는 네트워크 정리
docker network prune -f

# 사용하지 않는 볼륨 정리
docker volume prune -f

4. 빌드 캐시 정리

Docker 빌드 캐시가 이미지를 참조하고 있을 수 있습니다:

# 빌드 캐시 정리
docker builder prune -f

5. 전체 시스템 정리 (강력한 방법)

위 방법들이 효과가 없다면, 전체적으로 정리합니다:

# 사용하지 않는 모든 리소스 정리
docker system prune -a -f

# 또는 더 강력하게 (볼륨 포함)
docker system prune -a --volumes -f

6. Docker Desktop 재시작

여전히 문제가 해결되지 않으면:

1. Docker Desktop을 완전히 종료
2. 잠시 기다린 후 다시 시작
3. 이미지 목록 새로고침

7. 특정 이미지 강제 삭제

이미지 ID를 알고 있다면 강제로 삭제할 수 있습니다:

# 이미지 ID 확인
docker images

# 강제 삭제 (IMAGE_ID를 실제 ID로 교체)
docker rmi -f <IMAGE_ID>

대부분의 경우 1-4번 단계를 순서대로 실행하면 문제가 해결됩니다. 특히 docker container prune -f와 docker image prune -f 명령어가 가장 효과적입니다.