DEV WIKI
인프라 · 문제 해결 가이드

Docker로 실행한 서비스가 시작되지 않아요

Docker 명령 뒤 서비스가 시작되지 않을 때 daemon 연결, 포트 점유, 컨테이너 이름 충돌을 구분해 다음 Problem 문서를 선택합니다.

대상
사이트 운영자, 웹 에이전시, 프리랜서, 쇼핑몰 운영자
최종 검토
2026-07-28
참고 자료
있음

빠른 답변

Docker 서비스가 시작되지 않으면 실행 명령과 오류 원문을 먼저 보존한 뒤 Docker daemon 연결 실패인지, 호스트 포트 점유인지, 컨테이너 이름 충돌인지 구분합니다. 원인을 확인하기 전에 알 수 없는 프로세스나 컨테이너를 삭제하지 않습니다.

이 가이드가 맞는 경우

  • 애플리케이션 오류 메시지
  • 빌드 성공, 배포 실패

상황별 다음 단계

호스팅사·개발자에게 전달할 내용

변경 전 기록

  • 실행한 Docker 명령, 이미지·태그, context, 오류 원문과 발생 시각을 전달합니다.
  • 호스트 포트·컨테이너 이름·daemon 대상과 최근 Compose 변경을 기록합니다.
  • 인증 토큰, 환경 변수의 비밀값, 운영 데이터는 전달하지 않습니다.

알아둘 점

이 가이드는 Docker 실행이 중단된 상황에서 오류 원문을 기준으로 다음 확인 문서를 고릅니다. 원인과 삭제·권한 변경 조치는 각 Problem의 범위에서만 확인합니다.

먼저 기록할 것

  1. 실행한 명령과 이미지·태그를 그대로 기록합니다.
  2. docker context, 호스트 운영체제, Docker Desktop 또는 daemon 실행 방식을 기록합니다.
  3. 오류 원문, 사용한 포트와 컨테이너 이름을 보존합니다.

상황별 다음 단계

  1. daemon 소켓에 연결하지 못했다면 Cannot connect to the Docker daemon at unix:///var/run/docker.sock을 확인합니다.
  2. 호스트 포트가 이미 사용 중이면 listen tcp 0.0.0.0:8080: bind: address already in use를 확인합니다.
  3. 컨테이너 이름이 이미 사용 중이면 Conflict. The container name "/app" is already in use by container를 확인합니다.

세 문구와 다르면 로그의 첫 오류와 실행 명령을 보존한 뒤 Docker 환경별 문서를 추가로 확인합니다. 알 수 없는 컨테이너·프로세스·볼륨을 먼저 삭제하지 않습니다.

참고 자료

Running containers | Docker Docs (새 창에서 열림)

Docker · 공식 자료 · 확인 범위: Docker 컨테이너 실행 시 이미지, 이름, 포트와 파일 시스템 옵션을 확인할 수 있습니다. · 확인일: 2026-07-28