Sao lưu và khôi phục

Vị trí trong admin: System › Admin › Backup (/backup) chỉ xuất hiện khi module DDoS & BGP được bật; với bản cài đặt tiêu chuẩn, hãy dùng dòng lệnh bên dưới.

Dữ liệu được sao lưu

sudo nexcmp backup tạo một file lưu trữ nén chứa:

Thành phần	Nội dung
data/**/*.db	Mọi cơ sở dữ liệu SQLite trong /var/lib/nexcmp, được sao chép bằng online backup API của SQLite — nhất quán ngay cả khi panel đang chạy
files.tar	Toàn bộ tệp khác trong /var/lib/nexcmp (tệp cài đặt, nội dung tải lên cho branding, secrets/), ngoại trừ cơ sở dữ liệu và thư mục updates/
etc/	Một bản sao của /etc/nexcmp (cài đặt bộ cài, instance ID, port và bind)

File lưu trữ chứa master key của bạn

secrets/ lưu giữ key mã hóa các API key, thông tin thanh toán và mật khẩu SMTP được lưu trong cơ sở dữ liệu. File lưu trữ được tạo với quyền 0600. Hãy lưu trữ tệp dưới dạng mã hóa và ở ngoài máy chủ. Không có các key này, cơ sở dữ liệu được khôi phục sẽ không thể giải mã các secret.

Tạo bản sao lưu

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

Lệnh sẽ in ra đường dẫn file lưu trữ, ví dụ /var/backups/nexcmp/nexcmp-backup-20261030-120000.tar.zst.

Lên lịch sao lưu

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

Sao chép thư mục ra ngoài máy chủ (Object Storage, NAS, máy chủ khác).

Khôi phục

Khôi phục sang máy chủ đã cài đặt NexCMP cùng phiên bản (hoặc mới hơn).

1. Cài đặt NexCMP bằng installer với cùng license và domain, nhưng không chạy setup wizard.
2. Dừng các dịch vụ:

   sudo systemctl stop nexcmp-vmd nexcmp

3. Giải nén file lưu trữ vào một thư mục tạm:

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

4. Đưa các tệp trở lại vị trí:

   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. Khởi động các dịch vụ và kiểm tra:

   sudo systemctl start nexcmp nexcmp-vmd
   sudo nexcmp status

6. Đăng nhập vào https://<domain>/admin bằng tài khoản administrator của hệ thống được sao lưu.

Diễn tập trước

Hãy thực hiện bước 1–6 trên máy chủ dự phòng một lần trước khi bạn thực sự cần đến. Bản sao lưu chưa từng được khôi phục thử chỉ là một niềm hy vọng.

Không bao gồm

• Cấu hình nginx và chứng chỉ (được bộ cài tạo lại; chứng chỉ Let's Encrypt sẽ được cấp lại).
• Các máy chủ CloudStack / Proxmox VE và máy ảo trên đó — hãy sao lưu bằng các công cụ riêng của chúng.