[Redmine] Docker 컨테이너 백업 및 복원(가져오기) 가이드

Synology NAS에서 Docker 컨테이너를 안정적으로 운영하려면 정기적으로 컨테이너 백업(Export) 을 수행하는 것이 중요하다.
특히 Redmine, PostgreSQL, pgAdmin, Nextcloud, Vaultwarden 등 설정이 많은 서비스를 운영하는 경우 컨테이너가 손상되거나 업데이트 시 오류가 나면 즉시 복원할 수 있어야 한다.

아래는 Synology Container Manager에서 제공하는 컨테이너 내보내기(Export) 및 가져오기(Import) 기능을 활용하여
컨테이너를 백업·복원하는 전체 과정을 상세히 정리한 가이드다.

1. 컨테이너 백업(Export)

ynology Container Manager에서
백업하고자 하는 컨테이너를 선택 → 마우스 우클릭 → 설정 → 내보내기 를 선택한다.

설명

내보내기 기능은 컨테이너의 설정(Configuration) + 데이터(컨테이너 내부 파일) 를 하나의 .tar 파일로 저장한다.
외부 볼륨(/volume1/docker/…)은 별도 백업 대상이므로 수동으로 관리해야 한다.

2. 내보내기 설정

내보내기 설정 시 다음 항목을 지정한다.

내보내기 유형

컨테이너 콘텐츠 및 설정 내보내기
(가장 완전한 백업 파일 생성)

대상(백업 저장 위치)

NAS의 공유폴더 선택
예: /volume1/backup/docker

설명

백업은 이미지 레이어, 환경 변수, 네트워크 설정, 포트 매핑 등
컨테이너 실행정보 전체가 포함된다.
일반적으로 200MB~5GB까지 다양하다.

3. 백업 파일 확인

내보내기 완료 후 다음 위치에 .tar 백업 파일이 생성된다.

예:

/volume1/backup/docker/redmine_2025-11-27_01-30.tar

설명

파일명은
컨테이너이름_날짜시간.tar 형태로 자동 생성된다.
여러 버전을 보관하여 롤백 전략을 세우는 것이 안정적이다.

4. 문제가 발생된 컨테이너 – 재설정

컨테이너 오류, 업데이트 실패, 플러그인 충돌 등 문제가 발생했을 때
먼저 컨테이너를 중지한 후:

문제가 발생한 컨테이너 선택 → 작업 → 재설정(Reset) 클릭

재설정 기능 설명

단, 볼륨(/volume1/docker)은 그대로 유지된다.

다운로드된 이미지 기반으로 초기 상태로 되돌린다.

컨테이너 내부 변경된 파일, 설치된 패키지, Gem, Python 모듈 등은 모두 초기화된다.

사용 시점

  • 경미한 오류 해결
  • 컨테이너 내부 파일 손상 재설정
  • 이미지 기반 초기화가 필요한 경우

5. 문제가 발생된 컨테이너 삭제

Reset으로 해결되지 않거나
플러그인 충돌·빌드 오류·환경변수 오염 등
컨테이너 자체를 교체해야 할 때 수행한다.

절차:

  1. 컨테이너 중지
  2. 마우스 우 클릭 → 삭제

설명

컨테이너 삭제는 이미지나 외부 볼륨을 삭제하지 않는다.
동일한 이미지로 다시 컨테이너를 생성할 수 있다.

6. 컨테이너 복구(Import): 백업 파일을 이용한 복원

컨테이너를 복원하려면:

Container Manager → 설정 → 가져오기(Import)
→ 백업해 둔 .tar 파일 선택

휴지통 기능과 유사하게 백업된 상태 그대로 복구된다.

가져오기 시 복원되는 정보

  • 컨테이너 설정(포트, 네트워크, 링크 등)
  • 환경 변수
  • 컨테이너 내부 파일
  • ENTRYPOINT, CMD, 이미지 레이어 정보

가져오기 시 복원되지 않는 정보

네트워크 브리지 설정이 수동으로 생성된 경우 재구성이 필요할 수 있음

외부 볼륨(/volume1/docker/… 폴더)은 별도로 존재해야 동작

7. 전체 요약 (SEO 최적화 버전)

핵심 요약

  • Synology NAS에서 Docker 컨테이너를 안전하게 운영하려면
    Container Manager의 내보내기(Export) 기능으로 정기 백업을 수행하는 것이 필수다.
  • 내보내기는 설정+컨테이너 콘텐츠를 .tar 파일로 백업한다.
  • 컨테이너 손상 시 재설정(Reset) 또는 삭제 후 가져오기(Import) 를 통해 손쉽게 복구 가능하다.
  • 외부 볼륨은 내보내기에 포함되지 않으므로 반드시 별도 백업 관리가 필요하다.

SEO 키워드 자동 포함

  • Synology NAS Docker 컨테이너 백업 및 복원
  • Synology Container Manager 내보내기 가져오기 가이드
  • DSM Docker 컨테이너 초기화, 복구, 재설정
  • Redmine/PostgreSQL 컨테이너 백업 복원 방법
태그: ,

답글 남기기