---
title: 备份与恢复
description: 使用nexcmp backup对NexCMP数据和配置进行一致性备份，并可在同一服务器或新服务器上进行恢复。
url: https://nexcmp.com/zh-cn/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
```

将该文件夹复制到服务器外部（Object Storage、NAS或其他服务器）。

## 恢复 {#restore}

恢复至安装了**相同版本（或更新版本）**NexCMP的服务器上。

1. 使用相同的许可证和域名通过[安装程序](https://nexcmp.com/zh-cn/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服务器及其上的虚拟机——请使用其自带工具进行备份。