백업 및 복구

관리자 위치: System › Admin › Backup(/backup)은 DDoS & BGP 모듈이 활성화된 경우에만 표시됩니다. 표준 설치의 경우 아래의 명령줄을 사용하세요.

백업되는 항목

sudo nexcmp backup은(는) 다음이 포함된 압축 아카이브 하나를 생성합니다:

항목	내용
data/**/*.db	/var/lib/nexcmp의 모든 SQLite 데이터베이스, SQLite의 온라인 백업 API로 복사됨 — 패널이 실행 중인 동안에도 일관성 유지
files.tar	/var/lib/nexcmp의 다른 모든 파일(설정 파일, 브랜딩 업로드, secrets/), 단 데이터베이스와 updates/ 폴더는 제외
etc/	/etc/nexcmp의 사본(인스톨러 설정, 인스턴스 ID, 포트 및 바인드)

아카이브에 마스터 키가 포함되어 있습니다

secrets/에는 데이터베이스에 저장된 API 키, 결제 자격 증명, SMTP 비밀번호를 암호화하는 키가 포함되어 있습니다. 아카이브는 권한 0600(으)로 생성됩니다. 암호화하여 서버 외부에 보관하세요. 이 키가 없으면 복원된 데이터베이스는 보안 비밀을 복호화할 수 없습니다.

백업 수행

sudo nexcmp backup                 # writes to /var/backups/nexcmp
sudo nexcmp backup /mnt/nas/nexcmp # or to another directory

이 명령어는 /var/backups/nexcmp/nexcmp-backup-20261030-120000.tar.zst과(와) 같이 아카이브 경로를 출력합니다.

일정 지정

echo '17 3 * * * root /usr/local/bin/nexcmp backup /var/backups/nexcmp && find /var/backups/nexcmp -name "nexcmp-backup-*" -mtime +14 -delete' | sudo tee /etc/cron.d/nexcmp-backup

해당 폴더를 서버 외부로 복사합니다 (오브젝트 스토리지, NAS, 다른 서버).

복원

NexCMP **동일 버전(또는 그 이상)**이 설치된 서버에 복원합니다.

1. 동일한 라이선스와 도메인을 사용하여 installer(으)로 NexCMP를 설치하되, 설정 마법사는 실행하지 마세요.
2. 서비스를 중지합니다:

   sudo systemctl stop nexcmp-vmd nexcmp

3. 임시 디렉터리에 아카이브를 풉니다:

   sudo mkdir /root/restore && sudo tar --zstd -xf nexcmp-backup-20261030-120000.tar.zst -C /root/restore

4. 파일을 원래 위치로 되돌립니다:

   sudo tar -xf /root/restore/files.tar -C /var/lib/nexcmp
   sudo cp -a /root/restore/data/. /var/lib/nexcmp/
   sudo cp -a /root/restore/etc/. /etc/nexcmp/
   sudo chown -R nexcmp:nexcmp /var/lib/nexcmp

5. 서비스를 시작하고 확인합니다:

   sudo systemctl start nexcmp nexcmp-vmd
   sudo nexcmp status

6. 백업된 시스템의 관리자 계정으로 https://<domain>/admin에 로그인합니다.

리허설 수행

필요해지기 전에 여분의 서버에서 1~6단계를 한 번 연습해 보세요. 한 번도 복원해 보지 않은 백업은 희망사항일 뿐입니다.

포함되지 않는 항목

• nginx 설정 및 인증서 (설インストーラー에 의해 재생성됨; Let's Encrypt 인증서는 재발급됨).
• CloudStack / Proxmox VE 서버 및 그 위의 가상 머신 — 자체 도구를 사용하여 백업하세요.