Docker Desktop 트러블슈팅

Docker Desktop의 문제를 진단하고 해결하는 방법을 설명한 문서예요. 진단 정보 생성, 로그 수집, 재시작 등 기본적인 트러블슈팅 절차를 다뤄요.

출처: Troubleshoot

본문

Docker Desktop이 예상대로 동작하지 않을 때 다음과 같은 순서로 문제를 좁혀나가면 돼요.

Docker Desktop 재시작: Dashboard의 트러블슈팅 메뉴나 docker desktop restart 명령으로 재시작해요.
리소스 확인: VM에 할당된 CPU/메모리/디스크가 부족하지 않은지 Settings > Resources에서 확인해요.
백엔드/설정 확인: WSL 2, Hyper-V, Docker VMM 같은 백엔드와 프록시/네트워크 설정을 확인해요.
진단 정보 생성: Docker Desktop의 Troubleshoot 아이콘에서 진단 정보를 수집해 Docker 지원에 제출할 수 있어요.

Docker Desktop Dashboard에서 트러블슈팅 아이콘을 선택하면 Get support 와 Diagnose & feedback 옵션이 있어요. 문제가 지속되면 진단 정보를 생성하고 Docker에 제출해 도움을 받을 수 있어요.

Docker Desktop이 시작되지 않는 경우: Docker Engine, WSL 2, Hyper-V를 포함해 관련 서비스를 확인하거나 재시작해요.
컨테이너가 느리거나 멈추는 경우: 리소스 할당을 늘리거나, 파일 공유 설정(VirtioFS 등)을 확인해요.
네트워크/포트 문제: 프록시 설정, VPN, 포트 충돌을 확인해요.

특정 주제별 트러블슈팅은 아래 "더 알아보기"의 관련 문서와 트러블슈팅 토픽 문서를 참고하세요.