Câu hỏi thường gặp (FAQ) — Backup & Restore

Sử dụng

Backup bao gồm những gì?

Loại backup	Bao gồm	Không bao gồm
Full	Database (tất cả collections, cấu hình, users) + file uploads + attachments	Log files, cache, node_modules
Database only	Chỉ database — collections, cấu hình, users, permissions	File uploads, attachments

Có thể restore lên server khác không?

Có. Quy trình:

Download file backup từ server gốc
Cài đặt Digiforce trên server mới (cùng phiên bản hoặc mới hơn)
Bật plugin-backup-restore trên server mới
Upload file backup
Nhấn Restore — dữ liệu được chuyển sang server mới

TIP

Đảm bảo server mới có đủ:

Dung lượng disk cho file backup + database
Cùng loại database (PostgreSQL → PostgreSQL)
Phiên bản Digiforce tương thích

Restore có ghi đè toàn bộ dữ liệu không?

Có. Restore thay thế hoàn bộ database hiện tại bằng dữ liệu từ backup. Điều này có nghĩa:

Dữ liệu tạo sau thời điểm backup sẽ bị mất
Cấu hình hiện tại bị thay thế bằng cấu hình trong backup
Users và permissions cũng bị ghi đè

Luôn tạo backup mới nhất trước khi restore để có thể quay lại nếu cần.

Backup tự động có được hỗ trợ không?

Plugin backup-restore hỗ trợ backup thủ công (qua giao diện hoặc API). Để backup tự động theo lịch trình:

Sử dụng plugin-backups — plugin nâng cao hỗ trợ cron schedule, multi-destination, retention policy
Hoặc dùng cron job bên ngoài gọi API backupFiles:create

File backup lưu ở đâu?

Mặc định trong thư mục ./storage/backups/ trên server. Không lưu trong database.

Thuộc tính	Giá trị
Thư mục	`./storage/backups/`
Định dạng	`.nbdump`
Tên file	`backup-{timestamp}.nbdump`
Kích thước	Phụ thuộc vào lượng dữ liệu

Có thể chọn backup một số collections thôi không?

Có. Khi tạo backup, bạn có thể chọn collections cụ thể thay vì backup toàn bộ. Sử dụng API backupFiles:dumpableCollections để xem danh sách collections khả dụng.

Lỗi thường gặp

Restore bị lỗi?

Nguyên nhân	Giải pháp
Phiên bản không tương thích	Backup từ phiên bản mới không restore được trên phiên bản cũ — nâng cấp trước
Disk full	Restore cần dung lượng tạm — đảm bảo ≥ 2x kích thước backup
Database connection lỗi	Kiểm tra database connection string và quyền truy cập
File backup bị corrupt	Thử tải lại backup file gốc; kiểm tra checksum

Backup thất bại với dữ liệu lớn?

Kiểm tra dung lượng disk — cần đủ cho file backup
Tăng timeout nếu dump mất nhiều thời gian
Chạy backup ngoài giờ cao điểm để giảm tải database
Nếu database rất lớn, cân nhắc backup từng phần (chọn collections)

Server không khởi động lại sau restore?

Kiểm tra log server (./storage/logs/) để tìm lỗi
Database có thể ở trạng thái không nhất quán — thử restore lại
Kiểm tra file cấu hình (.env) có đúng connection string
Trường hợp xấu nhất: restore từ backup trước đó hoặc khởi tạo database mới

Backup lâu quá?

Kích thước DB	Thời gian ước tính	Giải pháp
< 100MB	Vài giây	Bình thường
100MB – 1GB	1–5 phút	Chạy ngoài giờ cao điểm
1GB – 10GB	5–30 phút	Backup database only (bỏ files)
> 10GB	30+ phút	Cân nhắc incremental backup (plugin-backups)