Compose 파일의 모든 컨테이너에 unless-stopped를 지정하는 대신, 서비스의 수명 주기와 종료 방식에 맞춰 Docker 재시작 정책을 선택하세요.
재시작 정책은 컨테이너의 주 프로세스가 종료될 때 반응합니다. 상태 확인은 계속 실행 중인 프로세스를 비정상으로 표시할 수 있지만 자동으로 재시작하지는 않습니다. 따라서 데이터베이스, 작업자, 웹 앱, 마이그레이션, 예약 작업은 계속 실행되어야 하는지, 정상 종료가 무엇을 의미하는지, 반복되는 오류를 어떻게 드러낼지에 따라 서로 다른 설정이 필요합니다.
재시작 동작을 상태 및 준비 상태와 분리
재시작 정책은 프로세스가 중지된 뒤 Docker가 컨테이너를 다시 시작해야 하는지 결정합니다. 상태 확인은 실행 중인 서비스가 지정된 작업을 수행할 수 있는지 확인합니다. 종속성 준비 상태는 다른 서비스가 시작해도 되는지를 판단합니다. 서로 관련은 있지만 각기 다른 문제를 해결합니다.
2026년의 상태 확인과 재시작은 별개입니다에서는 이러한 차이를 설명하고, Compose 상태 조건을 통해 서비스가 실제로 준비될 때까지 종속 서비스의 시작을 지연하는 방법을 보여 줍니다.
restart: always가 종료되지 않는 비정상 웹 프로세스를 복구해 줄 것이라고 기대하지 말고, 상태 확인만으로 프로세스가 재시작될 것이라고 기대하지도 마세요. 계속 실행하는 것이 안전하지 않을 때 애플리케이션이 종료되도록 하거나, 외부 복구 메커니즘을 추가하거나, 서비스 설계에 맞게 비정상 상태를 경고하세요.
장시간 실행되는 데이터베이스에는 지속적인 재시작 정책 사용
홈 서버의 데이터베이스는 일반적으로 호스트나 Docker 데몬이 재시작된 뒤 다시 실행될 것으로 기대됩니다. 관리자가 의도적으로 중지한 상태를 유지해야 한다면 unless-stopped가 실용적인 기본 설정인 경우가 많습니다. 재부팅 시 수동 중지 상태를 의도적으로 무시해야 한다면 always가 적절합니다.
2026년 7월의 재시작 정책은 프로세스 종료를 따릅니다에서는 no, on-failure, always, unless-stopped의 차이를 자세히 설명하고, 정책은 상태가 아니라 프로세스 종료에 반응한다는 점도 다룹니다.
데이터베이스에는 실제 상태 확인과 영구 저장소도 필요합니다. PostgreSQL을 반복해서 재시작해도 디스크 용량 부족, 잘못된 구성, 손상된 상태, 호환되지 않는 마이그레이션 문제는 해결할 수 없습니다. 반복적인 재시작을 성공적인 복원력으로 간주하지 말고 경고를 설정하세요.
큐와 종료 방식에 따라 작업자 정책 선택
장시간 실행되는 큐 작업자는 항상 작업을 처리해야 한다면 unless-stopped를 사용하는 것이 적절할 수 있습니다. 유한 작업자나 일괄 처리 프로세스는 on-failure:N을 사용해 일시적인 오류는 횟수를 제한해 재시도하고, 지속적인 오류가 발생하면 눈에 띄게 중단할 수 있습니다.
현재의 제한된 실패 시 재시도 방식은 프로세스가 계속 실행되어야 하는지, 정상적으로 종료될 수 있는지에 따라 재시도 동작을 맞춰야 한다는 점을 강조합니다.
워커 이미지에서 종료 코드 0이 무엇을 의미하는지 확인하세요. “작업 완료”를 뜻한다면 always가 성공적으로 끝난 일회성 작업을 무한 반복하게 만들 수 있습니다. 워커가 데몬으로 동작해야 한다면, 예상치 못한 정상 종료도 unless-stopped를 통한 자동 재시작의 근거가 될 수 있습니다.
웹 앱은 장기 실행 상태로 유지하되 실제 종속 항목이 준비된 후 시작되도록 하기
대부분의 셀프 호스팅 웹 애플리케이션은 지속적인 가용성을 목표로 하므로, 일반적으로 횟수 제한이 있는 장애 전용 정책보다 unless-stopped를 더 쉽게 이해하고 관리할 수 있습니다. 재시작 설정만으로 데이터베이스, 캐시, DNS, 시크릿, 마운트 경로가 준비될 필요성이 없어지는 것은 아닙니다.
관련 ZimaSpace 진단 문서인 컨테이너 종속성 재시작 루프에서는 눈에 보이는 앱을 반복해서 재시작하면 데이터베이스, 캐시, 마운트, 마이그레이션 또는 메모리에서 먼저 발생한 장애가 가려질 수 있는 이유를 설명합니다.
적절한 경우 시작 순서에 종속성 헬스 체크를 사용하고, 애플리케이션의 재시도 횟수에는 제한을 두세요. PostgreSQL이 시작될 때까지 5초마다 충돌하는 웹 서비스보다 준비 상태를 기다린 뒤 한 번에 정상적으로 시작하는 서비스가 상태를 파악하기 쉽습니다.
마이그레이션 및 일회성 작업에 유한한 수명 주기 적용하기
마이그레이션 컨테이너, 가져오기 도구, 유지 관리 작업, 일회성 초기화 작업은 일반적인 데몬이 아닙니다. 이들의 성공 상태는 대개 “종료 코드 0으로 종료되고 중지 상태 유지”입니다. always 또는 unless-stopped를 사용하면 완료된 작업이 의도치 않게 다시 실행될 수 있습니다.
일회성 운영 도구는 명시적으로 관리하고, 보이지 않는 상시 실행 서비스가 되지 않게 하세요. 마이그레이션이나 가져오기 도구는 명령이 종료된 후에도 성공 상태가 계속 표시되는 유한한 작업이어야 합니다.
장애 발생 시 점검을 위해 중지해야 한다면 restart: "no"를 사용하고, 명령을 안전하게 재시도할 수 있는 경우에만 횟수 제한이 있는 on-failure를 사용하세요. 스키마 마이그레이션의 경우 재시도를 자동화하기 전에 부분 적용된 마이그레이션을 반복 실행해도 되는지 확인하세요.
실제 장애 상황에서 정책 테스트하기
각 서비스에 대해 정상적인 프로세스 종료, 0이 아닌 코드로 인한 충돌, 호스트 재부팅, Docker 데몬 재시작, 수동 중지, 실행 중이지만 비정상인 상태, 사용할 수 없는 종속성을 테스트하세요. 구성을 복원력이 있다고 판단하기 전에 각 이벤트 후 예상 상태를 기록하세요.
재시작 횟수를 추적하고, 일정 시간 내에 낮은 임계값을 넘으면 알림을 보내세요. 자동 재시작은 일시적인 장애에서 복구 시간을 줄여야 합니다. 새 컨테이너가 끝없이 생성되어 지속적인 충돌이 드러나지 않게 해서는 안 됩니다.
좋은 정책 매트릭스는 명확해야 합니다. 장기 실행 데이터베이스와 웹 앱은 인프라 재시작 후 다시 실행되고, 데몬 워커는 큐 의미 체계에 따라 복구되며, 유한 작업은 완료되면 멈춥니다. 헬스 체크와 준비 상태 체크는 재시작 정책으로 포착할 수 없는 장애를 드러냅니다.
지원 및 팁
더 읽어보기

가족에게 NAS의 성인 동영상을 숨기는 방법
가족용 NAS에서 성인 동영상을 비공개로 보관하세요. 폴더 권한, Plex 및 Jellyfin 라이브러리 액세스 권한, 썸네일, 시청 기록, TV 공유 로그인 및 DLNA를 확인하세요.

Transformers에서 커뮤니티 모델을 불러오기 전에 확인할 사항
Transformers Jinja 샌드박스 업데이트를 활용해 모델의 출처, 채팅 템플릿, 원격 코드, 직렬화된 가중치, 격리된 첫 실행을 검토하세요.

Mirage를 로컬에서 실행: 한 장의 이미지로 OCR 및 객체 감지
Cactus Compute의 소형 로컬 비전 모델을 사용해 보고, 실제 입력으로 OCR 및 객체 추출을 검증하며, 메모리, 언어 및 개인정보 보호의 한계를 파악해 보세요.



