홈 서버에서 Docker를 사용하다 보면 어느 순간 컨테이너가 정상적으로 실행되지 않고 계속 꺼졌다가 다시 시작되는 상황을 만날 수 있습니다. 저도 처음에는 컨테이너가 계속 재시작되는 모습을 보고 Docker 자체에 문제가 생긴 것은 아닌지 걱정했던 적이 있습니다. 하지만 하나씩 원인을 확인해 보니 Docker가 고장 난 것이 아니라 설정 파일이나 저장공간, 권한, 환경 설정처럼 특정 부분에서 문제가 발생한 경우가 많았습니다. 중요한 것은 무작정 컨테이너를 삭제하고 다시 만드는 것이 아니라 재시작이 발생하는 이유부터 확인하는 것입니다. 이번 글에서는 Docker 컨테이너가 계속 재시작되는 대표적인 원인과 초보자가 어떤 순서로 문제를 확인하면 좋은지 쉽게 정리해 보겠습니다.
Docker 컨테이너가 계속 재시작되는 이유
Docker 컨테이너가 반복적으로 재시작되는 현상은 생각보다 다양한 원인으로 발생할 수 있습니다.
가장 흔한 원인은 설정 오류입니다. 컨테이너를 실행하는 데 필요한 환경 설정이 잘못되었거나 필요한 값이 빠져 있으면 프로그램이 시작되지 못하고 종료될 수 있습니다.
또한 연결된 폴더의 경로가 잘못되었거나 파일 권한이 적절하지 않은 경우에도 문제가 발생할 수 있습니다.
저장공간이 부족하거나 포트가 이미 다른 프로그램에서 사용되고 있는 경우도 확인해야 합니다.
따라서 컨테이너가 재시작된다는 사실만 보고 특정 원인을 바로 판단하기보다는 하나씩 범위를 좁혀가는 것이 좋습니다.
가장 먼저 컨테이너 상태를 확인한다
문제가 발생했을 때 가장 먼저 확인해야 할 것은 해당 컨테이너가 현재 어떤 상태인지입니다.
정상적으로 실행되고 있는지, 종료되었는지, 계속해서 다시 시작되고 있는지 확인합니다.
컨테이너가 짧은 간격으로 반복해서 종료되고 다시 실행된다면 프로그램 내부에서 오류가 발생하고 있을 가능성이 있습니다.
이때 컨테이너를 무작정 삭제하기보다는 현재 상태와 로그를 먼저 확인하는 것이 중요합니다.
특히 문제가 발생하기 직전에 설정을 변경했거나 서비스를 업데이트했다면 최근 변경 사항부터 살펴보는 것이 좋습니다.
컨테이너 로그를 확인한다
Docker 컨테이너 문제를 해결할 때 가장 유용한 정보 중 하나가 로그입니다.
프로그램이 실행되는 과정에서 어떤 오류가 발생했는지 로그에 기록되는 경우가 많기 때문입니다.
예를 들어 설정 파일을 찾지 못했다거나 특정 폴더에 접근할 수 없다는 메시지가 나타날 수 있습니다.
데이터베이스 연결에 실패했다는 내용이 표시되기도 합니다.
로그를 확인할 때는 모든 내용을 이해하려고 하기보다 오류와 관련된 메시지를 찾는 것부터 시작하는 것이 좋습니다.
특히 error, failed, permission, denied, cannot, missing과 같은 표현이 포함된 부분을 살펴보면 문제의 원인을 찾는 데 도움이 될 수 있습니다.
환경 설정을 확인한다
Docker Compose 등을 이용해 서비스를 구성했다면 환경 설정도 확인해야 합니다.
서비스에 필요한 환경 변수의 값이 빠져 있거나 잘못된 값을 입력하면 프로그램이 시작되지 않을 수 있습니다.
예를 들어 데이터베이스의 주소나 사용자 이름, 서비스가 사용하는 경로 등이 잘못 설정되어 있을 수 있습니다.
처음에는 정상적으로 작동하다가 어느 날부터 문제가 발생했다면 최근에 환경 설정 파일을 수정했는지도 확인해 보는 것이 좋습니다.
설정 파일을 수정하기 전에는 기존 내용을 별도로 저장해 두는 습관을 들이면 문제가 발생했을 때 이전 설정과 비교하기도 쉽습니다.
Docker Compose 파일을 확인한다
여러 개의 컨테이너를 함께 운영하는 환경에서는 Compose 파일의 설정도 중요한 확인 대상입니다.
서비스 이름이나 이미지 정보, 포트 연결, 저장공간 연결 등이 잘못되어 있으면 컨테이너가 정상적으로 실행되지 않을 수 있습니다.
특히 경로를 수정한 뒤 컨테이너가 갑자기 재시작되기 시작했다면 변경한 경로가 실제로 존재하는지 확인해야 합니다.
오타 하나 때문에 프로그램이 필요한 파일을 찾지 못하는 경우도 있습니다.
따라서 문제가 발생했다면 최근 변경된 부분부터 확인하는 것이 효율적입니다.
저장공간 연결을 확인한다
Docker에서 서비스 데이터를 저장할 때는 컨테이너 내부가 아니라 호스트의 특정 폴더나 저장장치를 연결하는 경우가 많습니다.
이 연결이 잘못되면 서비스가 필요한 데이터를 읽지 못할 수 있습니다.
예를 들어 기존 서버에서 사용하던 데이터 폴더의 위치를 변경했는데 Compose 설정은 이전 경로를 계속 사용하고 있다면 문제가 발생할 수 있습니다.
새로운 저장장치를 추가하거나 서버를 다른 PC로 이전한 직후 문제가 발생했다면 저장공간 경로를 우선적으로 확인하는 것이 좋습니다.
디스크 용량이 부족하지 않은지 확인한다
저장공간 부족도 자주 놓치는 원인입니다.
서버를 장기간 운영하면 사진이나 영상뿐만 아니라 Docker 이미지, 로그, 캐시와 서비스 데이터가 계속 쌓일 수 있습니다.
어느 순간 저장공간이 부족해지면 새로운 데이터를 기록하지 못하면서 서비스가 정상적으로 작동하지 않을 수 있습니다.
따라서 컨테이너가 갑자기 재시작되기 시작했다면 서버의 전체 저장공간과 해당 서비스가 사용하는 공간을 확인하는 것이 좋습니다.
특히 여러 서비스를 운영하는 서버라면 사용하지 않는 데이터를 정리하고 저장공간에 충분한 여유가 있는지 주기적으로 확인해야 합니다.
파일과 폴더 권한을 확인한다
리눅스 기반 서버에서는 파일과 폴더의 권한 문제도 자주 발생합니다.
컨테이너가 특정 폴더의 파일을 읽거나 새로운 파일을 저장해야 하는데 해당 작업에 필요한 권한이 없다면 프로그램이 실행되지 않을 수 있습니다.
예를 들어 데이터 폴더의 소유자나 권한을 변경한 이후 문제가 발생했다면 이 부분을 확인해야 합니다.
특히 새로운 저장장치를 연결하거나 기존 데이터를 다른 위치로 복사한 뒤 문제가 발생했다면 권한 구조가 기존 환경과 달라졌을 가능성도 있습니다.
따라서 데이터가 존재하는지만 확인하지 말고 컨테이너가 해당 데이터에 정상적으로 접근할 수 있는지도 확인하는 것이 중요합니다.
포트 충돌 여부를 확인한다
서비스가 사용하는 포트가 다른 프로그램에 의해 이미 사용되고 있다면 컨테이너가 정상적으로 시작되지 않을 수 있습니다.
예를 들어 새로운 서비스를 추가하면서 기존 서비스와 동일한 포트를 사용하도록 설정하면 충돌이 발생할 수 있습니다.
이런 경우에는 최근에 새로운 컨테이너를 추가했는지 확인해 보는 것이 좋습니다.
특히 여러 서비스를 한 서버에서 운영하고 있다면 각각의 서비스가 어떤 포트를 사용하는지 문서로 기록해 두면 관리하기 편합니다.
이미지 문제도 확인한다
Docker 컨테이너는 특정 이미지를 기반으로 실행됩니다.
이미지가 손상되었거나 예상하지 못한 변경이 발생한 경우 서비스에 문제가 생길 수도 있습니다.
특히 정상적으로 작동하던 서비스를 업데이트한 직후 재시작 문제가 발생했다면 업데이트가 원인인지 확인할 필요가 있습니다.
이런 상황에서는 무조건 최신 버전을 사용하는 것보다 현재 환경에서 안정적으로 작동했던 버전과 비교해 보는 것이 도움이 될 수 있습니다.
중요한 서비스는 업데이트 전에 설정과 데이터를 백업해 두는 습관을 들이는 것이 좋습니다.
데이터베이스 연결 문제를 확인한다
일부 Docker 서비스는 데이터베이스와 함께 작동합니다.
이 경우 애플리케이션 컨테이너 자체에는 문제가 없더라도 데이터베이스에 연결하지 못하면 프로그램이 종료될 수 있습니다.
예를 들어 데이터베이스 컨테이너가 정상적으로 실행되고 있는지, 연결 정보가 올바른지, 데이터베이스가 준비되기 전에 애플리케이션이 먼저 실행되고 있지는 않은지 등을 확인해야 합니다.
여러 컨테이너가 서로 연결되어 있는 환경에서는 하나의 문제가 다른 서비스의 작동에도 영향을 줄 수 있습니다.
따라서 문제가 발생했을 때 해당 컨테이너 하나만 보는 것이 아니라 관련된 컨테이너의 상태도 함께 확인하는 것이 좋습니다.
최근에 변경한 설정부터 확인한다
문제 해결에서 가장 효과적인 방법 중 하나는 최근 변경 사항을 되돌아보는 것입니다.
어제까지 정상적으로 작동하던 컨테이너가 오늘 갑자기 재시작되기 시작했다면 그 사이에 무엇을 변경했는지 생각해 봅니다.
Docker 이미지 업데이트를 했는지, Compose 파일을 수정했는지, 저장장치를 변경했는지, 운영체제 업데이트를 했는지 등을 확인합니다.
문제 발생 시점과 변경 시점을 비교하면 원인을 찾는 범위를 크게 줄일 수 있습니다.
그래서 앞서 설명한 서버 운영 기록을 남기는 습관이 중요합니다.
컨테이너를 바로 삭제하지 않는다
초보자가 문제를 해결할 때 흔히 하는 실수 중 하나가 문제가 발생한 컨테이너를 바로 삭제하는 것입니다.
컨테이너를 다시 만드는 것이 해결책이 될 수도 있지만, 원인을 확인하지 않고 삭제하면 문제를 해결하는 데 필요한 정보까지 사라질 수 있습니다.
특히 설정이나 데이터 연결에 문제가 있는 경우 컨테이너를 다시 만들어도 같은 문제가 반복될 수 있습니다.
따라서 먼저 로그와 설정을 확인하고 필요한 데이터를 백업한 뒤 재생성을 결정하는 것이 좋습니다.
재생성하기 전에 데이터를 확인한다
컨테이너를 다시 만드는 작업을 진행해야 한다면 먼저 데이터가 안전하게 보관되어 있는지 확인해야 합니다.
Docker 컨테이너와 실제 서비스 데이터는 항상 동일한 위치에 존재하는 것은 아닙니다.
설정에 따라 호스트의 특정 폴더나 별도의 저장장치에 데이터가 보관될 수 있습니다.
따라서 컨테이너를 재생성하기 전에 데이터 위치와 설정 파일을 확인하는 것이 중요합니다.
이 과정을 건너뛰면 서비스는 다시 실행되지만 기존 데이터가 보이지 않는 문제가 발생할 수도 있습니다.
문제 해결은 단순한 순서로 진행한다
Docker 컨테이너가 계속 재시작될 때는 다음과 같은 순서로 확인하면 좋습니다.
먼저 컨테이너의 현재 상태를 확인합니다.
그다음 로그에서 오류 메시지를 확인합니다.
이후 최근 변경 사항을 살펴보고 Compose 파일과 환경 설정을 확인합니다.
그다음 저장공간과 파일 권한을 확인합니다.
포트 충돌 여부와 관련 컨테이너의 상태도 확인합니다.
마지막으로 문제가 해결되지 않을 경우 이미지나 서비스 자체의 문제를 확인하고 재생성을 고려합니다.
이처럼 기본적인 부분부터 하나씩 확인하면 불필요하게 서버 전체를 다시 설치하는 일을 줄일 수 있습니다.
문제 해결 과정을 기록하면 다음에 더 쉬워진다
한 번 해결한 문제라고 해도 시간이 지나면 같은 상황이 다시 발생할 수 있습니다.
따라서 해결 과정도 간단하게 기록해 두는 것이 좋습니다.
예를 들어 “저장공간 부족으로 컨테이너 재시작 → 불필요한 로그 정리 후 정상 작동”처럼 짧게 적어도 충분합니다.
또는 “Compose 설정 변경 후 재시작 발생 → 저장 경로 오타 수정”과 같이 원인과 해결 방법을 기록할 수도 있습니다.
이러한 기록은 자신만의 문제 해결 자료가 됩니다.
처음에는 사소해 보이지만 서버를 장기간 운영할수록 이런 기록이 상당히 유용해집니다.
안정적인 Docker 운영을 위한 기본 습관
컨테이너가 계속 재시작되는 문제를 예방하려면 평소 관리도 중요합니다.
서비스를 업데이트하기 전에 설정 파일과 중요한 데이터를 백업합니다.
Compose 파일은 별도로 관리하고 서버의 서비스 목록을 기록합니다.
저장공간과 로그 사용량도 주기적으로 확인합니다.
새로운 서비스를 추가할 때는 기존 서비스와 포트가 충돌하지 않는지 확인합니다.
그리고 설정을 변경했다면 변경 날짜와 내용을 기록해 두는 것이 좋습니다.
이런 습관을 만들어 두면 문제가 발생했을 때 원인을 찾는 데 걸리는 시간을 줄일 수 있습니다.
마무리
Docker 컨테이너가 계속 재시작되는 문제를 처음 경험하면 서버 전체에 문제가 생긴 것처럼 느껴질 수 있습니다. 저 역시 처음에는 컨테이너가 반복해서 꺼졌다 켜지는 모습을 보고 Docker를 다시 설치해야 하는 것은 아닌지 고민했던 적이 있습니다. 하지만 실제로는 설정 파일의 작은 오류나 저장공간 부족, 파일 권한, 포트 충돌처럼 특정한 원인 때문에 발생하는 경우가 많습니다. 그래서 중요한 것은 컨테이너를 바로 삭제하거나 서버를 처음부터 다시 구성하는 것이 아니라 로그와 설정을 확인하면서 원인을 하나씩 좁혀가는 것입니다. 특히 최근에 변경한 설정이 있다면 그 부분부터 확인하고, 데이터 저장 위치와 환경 설정, Compose 파일도 함께 살펴보는 것이 좋습니다. 데이터베이스를 사용하는 서비스라면 관련 컨테이너의 상태도 함께 확인해야 합니다. 또한 문제가 해결된 뒤에는 원인과 해결 방법을 간단하게 기록해 두면 같은 문제가 다시 발생했을 때 훨씬 빠르게 대응할 수 있습니다. 홈 서버는 시간이 지날수록 운영하는 서비스가 늘어나기 때문에 모든 설정을 기억하는 것보다 기록하고 확인하는 습관을 만드는 것이 중요합니다. Docker 컨테이너가 계속 재시작되는 상황도 당황하지 않고 기본적인 점검 순서에 따라 하나씩 확인한다면 대부분의 문제를 훨씬 체계적으로 접근할 수 있습니다.