홈 NAS에서 실행 중인 데이터베이스 컨테이너의 일관성을 유지하는 백업 방법은 무엇인가요?

Eva Wong 는 테크니컬 라이터 이자 상주 메이커 로 ZimaSpace에서 활동합니다. 평생 기술을 사랑해 온 그녀는 홈랩과 오픈 소스 소프트웨어에 열정을 품고 있으며, 복잡한 기술 개념을 누구나 이해하기 쉬운 실습 가이드로 풀어내는 데 전문성을 갖추고 있습니다. Eva는 셀프 호스팅이 어렵고 부담스러운 일이 아니라 즐거워야 한다고 믿습니다. 그녀는 튜토리얼을 통해 커뮤니티가 하드웨어 설정의 어려움을 풀어내고, 첫 NAS를 조립하는 것부터 Docker 컨테이너를 능숙하게 다루는 것까지 도전하도록 돕습니다.

대부분의 홈 NAS 및 셀프 호스팅 서버 사용자에게 가장 안전한 기본 방법은 데이터베이스가 실행 중일 때 데이터베이스 네이티브 논리 백업을 만든 다음, 덤프를 컨테이너 구성 및 애플리케이션 파일과 함께 일반 백업하는 것입니다. 다운타임을 허용할 수 있다면 컨테이너를 잠시 중지한 뒤 복사하고, 데이터베이스를 플러시하거나 잠그거나 체크포인트를 수행하는 등 스냅샷에 맞게 준비한 경우에만 파일 시스템 스냅샷을 함께 사용하세요. 실행 중인 데이터베이스 볼륨을 그대로 복사하는 것은 일관성 있는 백업 방법이 아닙니다.

데이터베이스가 정상적으로 복원 가능한 상태를 '일관성 있음'으로 정의하기

일관성 있는 백업은 단순히 폴더 트리 전체를 복사한 것이 아닙니다. 복원 후에는 데이터베이스 엔진이 시작되고 트랜잭션을 올바르게 복구하며 무결성 검사를 통과하고 애플리케이션에서 사용할 수 있는 특정 시점의 상태를 제공해야 합니다. Immich, Nextcloud, Paperless-ngx, Home Assistant 또는 다른 셀프 호스팅 앱을 실행하는 홈 서버에서는 데이터베이스, 업로드 파일, 구성 및 시크릿이 서로 일치해야 합니다.

컨테이너의 영속성은 파일이 저장되는 위치만 설명합니다. 실행 중인 데이터베이스를 안전하게 복사할 수 있다는 뜻은 아닙니다. NAS 백업 소프트웨어가 볼륨을 읽는 동안 데이터베이스에서 활성 트랜잭션이 진행 중이거나, 캐시된 페이지, 미리 쓰기 로그, 임시 파일 또는 메타데이터가 변경될 수 있습니다.

방법 1: 데이터베이스 네이티브 논리 덤프를 홈 NAS 기본 백업으로 사용하기

논리 덤프는 데이터베이스 엔진에 스키마와 레코드의 일관된 표현을 내보내도록 요청합니다. 가정용 NAS에서 실행되는 적당한 규모의 PostgreSQL 또는 MariaDB 컨테이너라면, 일반적으로 예약 실행, 검사, 오프사이트 복사, 새 컨테이너로 복원하기 가장 쉬운 방법입니다. 최신 Docker 백업 가이드에서는 예약 백업 컨테이너에서 데이터베이스 네이티브 덤프를 실행하는 방식을 소개합니다.

덤프는 실제 데이터 볼륨 외부의 전용 백업 디렉터리에 저장하세요. 그런 다음 NAS 백업 작업으로 덤프, Compose 파일, 환경 템플릿, 애플리케이션 구성 및 업로드 데이터를 보호하세요. 운영 환경 암호를 덤프 파일 이름이나 보호되지 않은 로그에 노출하지 마세요.

데이터베이스 홈 서버 기본값 백업 작업에서 수집할 항목
PostgreSQL 네이티브 논리 덤프 또는 데이터베이스 네이티브 물리 백업 도구 필요한 경우 덤프, 역할 또는 전역 설정, Compose 파일, 환경 변수 값, 앱 파일
MariaDB/MySQL 일관된 트랜잭션 옵션을 사용하는 네이티브 논리 덤프 필요한 경우 SQL 덤프, 사용자 또는 권한 부여 정보, Compose 파일, 시크릿, 앱 파일
SQLite 애플리케이션 백업, SQLite 온라인 백업 또는 정상적으로 중지한 뒤 복사 일관된 데이터베이스 복사본과 앱 구성 및 첨부 파일

방법 2: 볼륨을 복사하기 전에 데이터베이스를 잠시 중지하기

중지된 컨테이너를 복사하는 방법은 간단하며 물리 데이터 전체를 담을 수 있습니다. 먼저 애플리케이션의 쓰기 작업을 중지하고, 데이터베이스를 정상적으로 종료한 다음 프로세스가 종료되었는지 확인합니다. 전체 영구 볼륨 또는 바인드 마운트된 데이터베이스 디렉터리를 복사한 뒤 스택을 다시 시작하세요. Docker 및 MariaDB 가이드에서는 물리 볼륨 복사본이 빠르지만 버전에 따라 다르며 일반적으로 다운타임이 필요하다고 설명합니다.

몇 분간의 유지 관리가 가능하고 호환되는 데이터베이스 버전으로 복원하는 소규모 홈 NAS에 적합한 방법입니다. 논리 덤프보다 이식성이 낮고 볼륨이 크면 다운타임이 길어질 수 있습니다. 물리 파일을 호환되지 않는 엔진 버전으로 복원하지 않도록 백업에 데이터베이스 이미지 태그와 저장소 레이아웃을 함께 보관하세요.

방법 3: 데이터베이스와 조율해 빠르게 스냅샷 만들기

ZFS, Btrfs, LVM 및 NAS 스냅샷 시스템은 대용량 데이터베이스 볼륨을 빠르게 캡처할 수 있지만, 데이터베이스와 조율해 스냅샷을 만들어야 합니다. MariaDB 또는 MySQL의 경우 짧은 잠금이나 플러시 시간이 필요할 수 있고, PostgreSQL의 경우 데이터베이스가 지원하는 백업 또는 체크포인트 절차가 필요할 수 있으며, 애플리케이션이 관리하는 데이터베이스의 경우 스냅샷 전 훅이 필요할 수 있습니다.

데이터베이스 스냅샷 관련 논의에 따르면 데이터베이스를 동결하거나 원자적으로 스냅샷을 생성하지 않으면 디스크의 실시간 복사본이 내부적으로 일관되지 않을 수 있습니다. 잠금 또는 일시 중지 시간은 짧아야 합니다. 데이터베이스를 준비하고 스냅샷을 만든 뒤 쓰기를 재개하고, 나중에 스냅샷을 복사하세요.

데이터베이스가 너무 커서 논리 덤프를 자주 만들기 어렵거나 복구 시점 간격을 줄여야 할 때 유용한 방법입니다. 기본적인 홈 서버 덤프 작업보다 세심한 스크립트 작성과 복원 테스트가 필요합니다.

Docker 이미지나 컨테이너 내보내기를 데이터베이스 백업으로 취급하지 마세요

컨테이너 이미지에는 애플리케이션 런타임이 들어 있지만, 현재 영구 데이터까지 반드시 포함되는 것은 아닙니다. 컨테이너를 내보내거나 커밋해도 이름이 지정된 볼륨은 누락될 수 있으며, 데이터베이스에 일관된 복구 지점을 만들도록 요청하지도 않습니다. PostgreSQL 컨테이너 백업 계정에 따르면 Docker 저장 및 커밋은 PostgreSQL 전용 백업 기법을 대체할 수 없습니다.

ZimaOS 또는 Docker 홈 서버에서는 배포 정의와 데이터 보호 계획을 분리하세요. 서비스를 다시 빌드할 수 있도록 Compose 파일과 이미지 태그를 보존하고, 상태를 복원할 수 있도록 데이터베이스 일관성을 유지하는 방법으로 데이터베이스를 백업하세요.

활발히 쓰기 작업 중인 데이터베이스 볼륨을 절대 그대로 복사하지 마세요

NAS 백업 소프트웨어는 데이터베이스 파일마다 서로 다른 시점에 읽을 수 있습니다. 그 결과 만들어진 아카이브에는 한 트랜잭션 상태의 데이터 파일, 다른 상태의 로그, 또 다른 상태의 메타데이터가 함께 들어갈 수 있습니다. 오픈소스 SQL 백업 방법을 개괄한 자료에서는 중요한 상태가 아직 메모리에 있는 동안 변경 중인 데이터베이스를 일관되지 않은 시점에 캡처할 수 있다고 경고합니다.

충돌 복구 과정에서 원자적으로 캡처된 스냅샷의 일부를 복구할 수는 있지만, 일반적인 재귀 파일 복사는 원자적이지 않습니다. 앱이 서비스 중단을 허용할 수 없다면 논리 덤프, 지원되는 물리 백업 도구 또는 조정된 스냅샷을 사용하세요.

SQLite 컨테이너를 일반 파일이 아닌 데이터베이스로 다루세요

많은 홈 서버 앱은 작고 배포하기 쉬워 SQLite를 사용합니다. 위험은 관리자가 .db 파일 하나만 보고 앱이 쓰기 작업을 하는 동안에도 복사할 수 있다고 생각하는 데 있습니다. WAL 모드에서는 최근에 커밋된 변경 사항이 기본 파일에 아직 기록되지 않았을 수 있습니다. 실용적인 SQLite 복구 안내에서는 실행 중인 데이터베이스 파일을 복사하는 대신 온라인 백업 메커니즘을 사용하거나 정상 종료 후 복사할 것을 권장합니다.

애플리케이션에 내장 백업 기능이 있다면 이를 사용하세요. 그렇지 않으면 SQLite 자체 온라인 백업 기능을 사용하거나 애플리케이션을 정상적으로 중지한 뒤 데이터베이스 디렉터리 전체를 복사하세요. 저널이나 WAL 상태는 남겨둔 채 기본 데이터베이스 파일만 복사하지 마세요.

중단 시간, 데이터베이스 크기, 복원 이식성에 따라 방법 선택

홈 NAS 환경 가장 적합한 시작 방법 주요 절충점
소규모 데이터베이스, 일일 백업, 간편한 마이그레이션 논리 덤프 데이터베이스가 커질수록 덤프 시간 증가
소규모 데이터베이스, 유지 관리 시간 확보 가능 정상 종료 후 물리 볼륨 복사 서비스 중단 및 버전 호환성 필요
대규모 데이터베이스, 짧은 백업 시간 데이터베이스 조정 스냅샷 또는 네이티브 물리 백업 더 복잡한 훅, 보존 정책 및 복원 테스트
내장 내보내기 기능이 있는 SQLite 앱 애플리케이션 내보내기 또는 SQLite 온라인 백업 앱별 자동화가 필요할 수 있습니다
데이터베이스와 업로드 파일을 사용하는 미디어 또는 문서 앱 데이터베이스 일관성을 유지하는 백업과 동기화된 파일 백업 데이터베이스와 파일의 타임스탬프가 동일한 복구 시점에 속해야 합니다

자체 호스팅 애플리케이션 전체를 백업하세요. 데이터베이스만 백업하지 마세요

실제로 사용할 수 있는 복구 패키지에는 데이터베이스 백업, Docker Compose 파일, 이미지 버전, 환경 변수 또는 복구 가능한 보안 정보 패키지, 리버스 프록시 설정, 앱 설정, 업로드된 파일, 암호화 키가 포함되어야 합니다. SQL 덤프만 백업하면 레코드는 복원할 수 있어도 앱에서 사진, 문서, 미리보기 이미지, 인증서 또는 스토리지 경로를 찾지 못할 수 있습니다.

홈 서버 복구 계획을 세울 때 바인드 마운트 및 명명된 볼륨에 관한 ZimaSpace 가이드를 참고하세요. 이 가이드에서는 스토리지 경로를 명확히 해두면 복구에 도움이 되지만, 앱에 일관된 데이터베이스 백업을 대신할 수는 없는 이유를 설명합니다.

새 컨테이너에 복원해 백업 방식을 검증하세요

새 프로젝트 이름, 서로 다른 호스트 포트, 임시 데이터 디렉터리를 사용하는 격리된 테스트 스택을 만드세요. 덤프나 스냅샷을 복원하고 데이터베이스를 시작한 뒤, 무결성 또는 일관성 검사를 실행하고 테스트용 앱 복사본을 연결하세요. 사용자, 레코드, 첨부 파일, 최근 트랜잭션이 있는지 확인하세요.

복구 시점과 복구 시간을 모두 측정하세요. 논리 덤프의 일관성은 보장되지만 복원에 너무 오래 걸린다면, 이식 가능한 복구 수단으로 보관하고 더 빠른 조정 스냅샷을 추가하세요. 중지된 볼륨 복사본은 빠르게 복원되지만 동일한 데이터베이스 버전에서만 사용할 수 있다면, 마이그레이션을 위한 대체 수단으로 논리 덤프를 보관하세요.

자주 묻는 질문

볼륨을 복사하기 전에 데이터베이스 컨테이너를 일시 중지하는 것만으로 충분한가요?

일반적으로는 그렇지 않습니다. 일시 중지는 프로세스를 멈추지만, 데이터베이스가 이동 가능한 백업에 필요한 상태를 디스크에 올바르게 기록했음을 보장하지는 않습니다. 데이터베이스 전용 덤프, 정상 종료 또는 문서화된 일시 중지 및 스냅샷 절차를 사용하세요.

NAS 스냅샷만으로 PostgreSQL 또는 MariaDB를 충분히 백업할 수 있나요?

스냅샷이 원자적이고 데이터베이스에서 지원하는 일관성 유지 절차와 조정된 경우에만 충분합니다. 조정되지 않은 스냅샷은 단순히 충돌 후 일관성만 보장할 수 있으며, 원자성이 없는 파일 복사는 더 문제가 될 수 있습니다.

SQLite 기반 홈 서버 앱은 무엇을 백업해야 하나요?

가능하면 앱의 내보내기 기능이나 SQLite 온라인 백업을 사용하세요. 또한 주 데이터베이스 파일인 .db만으로 앱 전체를 복원할 수 있다고 가정하지 말고, 앱 설정, Compose 파일, 보안 정보, 첨부 파일, 데이터베이스가 들어 있는 디렉터리도 보존하세요.

최종 권장 사항

홈 NAS에서 대부분의 PostgreSQL 및 MariaDB 컨테이너에는 예약된 논리 덤프를 기본 백업 방식으로 사용하세요. 짧은 서비스 중단이 허용된다면 중지된 볼륨을 깔끔하게 복사하고, 데이터베이스가 크거나 복구 시점 목표가 촉박하다면 조정된 스냅샷이나 데이터베이스 전용 물리 백업 도구를 사용하세요. 어떤 방식을 선택하든 백업을 신뢰하기 전에 새 컨테이너에 복원해 보세요.

지원 및 팁

더 읽어보기

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.