시작하기¶

이 페이지는 갓 설치한 Unraid 장비에서 첫 백업까지 안내합니다.

요구 사항¶

요구 사항	참고
Unraid 6.12+	이전 버전은 테스트되지 않았습니다.
Restic 저장소 위치	로컬 경로(권장: 배열 또는 캐시), SMB, NFS, 또는 모든 rclone 백엔드.
Docker 소켓	템플릿이 자동으로 마운트합니다(`/var/run/docker.sock`).
Unraid 플래시 (`/boot`)	템플릿이 전체를 자동으로 마운트합니다(`/boot`을 `/host/boot`로). 플래시 백업을 구동하고, 복원된 컨테이너가 정상적이고 편집 가능한 Unraid 앱으로 다시 나타나게 합니다.
KVM VM (선택 사용)	VM 백업은 SSH를 통해 libvirt와 통신하며 libvirt 마운트가 없습니다. 설정에서 구성하세요(구성 참고).

Unraid에 설치¶

가장 쉬운 방법은 Community Applications입니다.

Unraid에서 Apps 탭을 엽니다.
BombVault를 검색합니다.
Install을 클릭하고, 필수 변수(아래)를 설정한 후 적용합니다.

수동 템플릿 설치

템플릿을 직접 추가하려면:

Docker, Add Container, Template repositories로 이동하여 다음을 추가합니다:
```
https://github.com/junkerderprovinz/unraid-apps
```
Templates에서 BombVault를 검색합니다.
필수 변수를 설정하고 Apply를 클릭합니다.

유일한 필수 설정¶

반드시 설정해야 하는 유일한 변수는 APP_KEY이며, restic 저장소 비밀번호를 파생하는 데 사용되는 32바이트 16진수 비밀 값(64개의 16진수 문자)입니다.

아무 장비에서나 하나 생성하세요:

openssl rand -hex 32

결과를 템플릿의 APP_KEY 필드에 붙여넣으세요.

APP_KEY를 잃어버리지 마세요

APP_KEY를 잃어버리면 암호화된 백업을 복구할 수 없게 됩니다. 서버와 분리된 안전한 곳에 보관하세요. BombVault가 실행되면, 원클릭 암호화 키 복구 키트(오프사이트 및 복구 참고)를 사용하여 전체 복구 번들을 저장하세요.

템플릿은 또한 Docker 소켓, 플래시(/boot), 그리고 Host Data 루트(/mnt)를 대신 마운트합니다. 백업 소스와 대상은 모두 Host Data 아래에 있습니다. 전체 변수 참조와 오프사이트 설정은 구성을 참고하세요.

첫 실행¶

https://<your-unraid-ip>:3443에서 웹 UI를 엽니다(기본으로 자체 서명된 인증서).
설정에서 원하는 백업 도메인(컨테이너, VM, 플래시, 구성, 파일)을 활성화하고 강조 색상을 선택합니다.
컨테이너 탭에서 컨테이너를 선택하고 백업을 클릭하여 첫 복원 지점을 만듭니다. 저장소 경로는 기본적으로 /mnt/user/bombvault/{container,vms,flash,config,files}이며 첫 백업 시 생성됩니다.
설정, 일정에서 예약을 구성합니다. 컨테이너와 VM에 대해 원클릭 일정에 모두 포함이 있습니다.

선택 사항: 백업 순서 지정

일부 컨테이너를 항상 다른 것보다 먼저 백업해야 한다면(예: 앱을 사용하는 데이터베이스를 먼저), 컨테이너 페이지에서 백업 순서 패널을 열고 원하는 순서로 드래그하세요. 예약 및 다중 선택 실행은 그 순서를 따릅니다. 순서를 지정하지 않은 항목은 이전과 같이 가장 기한이 지난 것부터 백업됩니다.

호스트 통합 확인

컨테이너가 시작된 후 웹 UI에서 /spike를 엽니다. 모든 마운트와 CLI(Docker 소켓, libvirt, restic, qemu-img, rclone)를 검사하고 누락된 부분을 보고하므로, 컨테이너에 의존하기 전에 올바르게 연결되었는지 확인할 수 있습니다.

간단 모드 vs 고급 모드¶

기본적으로 인터페이스는 필수 항목(백업, 복원, 예약)만 표시합니다. 사이드바의 간단히 보기 / 고급 보기 스위치를 사용하여 전문가용 컨트롤을 표시하세요: 보존, 오프사이트 복사, 사전/사후 훅, 파일 수준 복원, 알림, Prometheus 메트릭, 무결성/유지 관리 도구. 브라우저별 설정이며 기본적으로 꺼져 있으므로, 처음 오는 사람은 깔끔한 UI를, 파워 유저는 모든 기능을 얻습니다.

다음 단계¶

전체 기능을 둘러보세요.
하나 이상의 오프사이트 및 복구 복제본을 추가하고(각 도메인은 여러 대상에 동시에 전송할 수 있음) 복구 키트를 저장하세요.
설정을 복제하거나 새 장비로 옮기시나요? 설정 내보내기 및 가져오기 카드로 전체 구성을 옮기세요. 구성을 참고하세요.
문제가 생겼나요? 문제 해결을 참고하세요.