---
title: 백업 및 복구
description: nexcmp backup으로 NexCMP 데이터와 설정의 일관된 백업을 수행하고, 동일한 서버나 새 서버에 복구하세요.
url: https://nexcmp.com/ko/docs/getting-started/backup-and-restore/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 백업 및 복구 {#backup-and-restore}

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

## 백업되는 항목 {#what-is-backed-up}

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

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

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

## 백업 수행 {#take-a-backup}

```bash
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`과(와) 같이 아카이브 경로를 출력합니다.

### 일정 지정 {#schedule-it}

```bash
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, 다른 서버).

## 복원 {#restore}

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

1. 동일한 라이선스와 도메인을 사용하여 [installer](https://nexcmp.com/ko/docs/getting-started/installation/)(으)로 NexCMP를 설치하되, 설정 마법사는 실행하지 **마세요**.
2. 서비스를 중지합니다:
   ```bash
   sudo systemctl stop nexcmp-vmd nexcmp
   ```
3. 임시 디렉터리에 아카이브를 풉니다:
   ```bash
   sudo mkdir /root/restore && sudo tar --zstd -xf nexcmp-backup-20261030-120000.tar.zst -C /root/restore
   ```
4. 파일을 원래 위치로 되돌립니다:
   ```bash
   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. 서비스를 시작하고 확인합니다:
   ```bash
   sudo systemctl start nexcmp nexcmp-vmd
   sudo nexcmp status
   ```
6. *백업된* 시스템의 관리자 계정으로 `https://<domain>/admin`에 로그인합니다.

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

## 포함되지 않는 항목 {#not-included}

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