🐋 Docker 주요 명령어 요약집

🐋 1. Docker 기본 명령어

이미지 관리

# 이미지 목록 확인
docker images

# 이미지 다운로드
docker pull nginx:latest

# 이미지 삭제
docker rmi <이미지ID>

# 사용하지 않는 이미지 모두 삭제
docker image prune -a

컨테이너 관리

# 컨테이너 실행
docker run -d --name my-container nginx

# 실행 중인 컨테이너 확인
docker ps

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

# 컨테이너 중지
docker stop <컨테이너ID>

# 컨테이너 삭제
docker rm <컨테이너ID>

# 컨테이너 강제 삭제
docker rm -f <컨테이너ID>

로그 및 접속

# 컨테이너 로그 확인
docker logs <컨테이너명>

# 실시간 로그 확인
docker logs -f <컨테이너명>

# 컨테이너 내부 접속
docker exec -it <컨테이너명> /bin/bash

---

🐋 2. Docker Compose 명령어

기본 실행/중지

# 서비스 실행 (백그라운드)
docker-compose up -d

# 서비스 중지
docker-compose down

# 서비스 중지 (볼륨까지 삭제)
docker-compose down -v

# 특정 서비스만 실행
docker-compose up -d <서비스명>

빌드 관련

# 이미지 빌드
docker-compose build

# 캐시 없이 빌드
docker-compose build --no-cache

# 빌드 후 바로 실행
docker-compose up --build -d```

모니터링

# 실행 중인 서비스 확인
docker-compose ps

# 모든 서비스 로그 확인
docker-compose logs -f

# 특정 서비스 로그만 확인
docker-compose logs -f <서비스명>

---

🐋 3. Docker 완전 초기화

Docker 완전 초기화

# 모든 컨테이너 중지 및 삭제
docker-compose down -v --remove-orphans

# 모든 Docker 리소스 삭제 (이미지, 볼륨, 네트워크, 캐시)
docker system prune -a --volumes

# 확인: 모든 리소스가 삭제되었는지 체크
docker ps -a
docker images
docker volume ls
docker network ls

코드를 입력하세요

선택적 리소스 삭제

# 중지된 컨테이너만 삭제
docker container prune

# 사용하지 않는 이미지만 삭제
docker image prune -a

# 사용하지 않는 볼륨만 삭제
docker volume prune

# 사용하지 않는 네트워크만 삭제
docker network prune

---

🐋 4. 실무에서 자주 사용하는 패턴

개발 환경 재시작

# 1. 서비스 중지 및 재빌드
docker-compose down
docker-compose build --no-cache
docker-compose up -d

# 2. 실시간 로그 확인
docker-compose logs -f

데이터베이스 초기화

# DB 볼륨까지 완전 삭제 후 재시작
docker-compose down -v
docker-compose up -d

특정 서비스만 재시작

# 특정 서비스 재시작
docker-compose restart <서비스명>

# 특정 서비스 재빌드 후 실행
docker-compose up --build -d <서비스명>

컨테이너 디버깅

# 컨테이너 내부 파일 시스템 확인
docker exec -it <컨테이너명> ls -la

# 컨테이너 리소스 사용량 확인
docker stats

# 컨테이너 세부 정보 확인
docker inspect <컨테이너명>

---

🐋 5. 트러블슈팅 명령어

포트 충돌 해결

# 포트 사용 중인 프로세스 확인 (macOS/Linux)
lsof -i :3000

# 프로세스 종료
kill -9 <PID>

용량 관리

# Docker 전체 용량 확인
docker system df

# 상세 용량 정보
docker system df -v

네트워크 문제 해결

# 네트워크 목록 확인
docker network ls

# 특정 네트워크 상세 정보
docker network inspect <네트워크명>

---

💡 유용한 팁

1. 자주 사용하는 별칭(alias) 설정

# ~/.bashrc 또는 ~/.zshrc에 추가
alias dps='docker ps'
alias dcu='docker-compose up -d'
alias dcd='docker-compose down'
alias dcl='docker-compose logs -f'
alias dprune='docker system prune -a --volumes'

2. 한 번에 여러 컨테이너 삭제

# 모든 중지된 컨테이너 삭제
docker rm $(docker ps -aq --filter "status=exited")

# 특정 패턴의 컨테이너 삭제
docker rm $(docker ps -aq --filter "name=test*")

3. 이미지 태그 관리

# 태그 없는 이미지(dangling) 삭제
docker rmi $(docker images -f "dangling=true" -q)

---

⚠️ 주의사항

• docker system prune -a --volumes 명령어는 모든 데이터를 삭제하므로 신중히 사용
• 프로덕션 환경에서는 v 옵션 사용 시 데이터 백업 필수
• -no-cache 옵션은 빌드 시간이 오래 걸리므로 필요할 때만 사용

---