Control panel cho thời đại AI: vibe code xong, push lên GitHub là chạy.Khám phá →
Tài liệuSao lưu

Sao lưu

Sao lưu toàn phần và tăng dần, bản sao mã hoá lên S3, sao lưu database và lịch của khách, cùng cách khôi phục tài khoản, file hoặc database.

ZoPanel có nhiều loại sao lưu bổ trợ cho nhau. Sao lưu toàn phần cho bạn một file nén đầy đủ, chuyển được sang bất kỳ server ZoPanel nào. Snapshot tăng dần (restic) là các bản nhỏ chạy mỗi đêm, khôi phục được từng file. Sao lưu database có thể chạy dày tới mỗi giờ. Mọi bản sao lưu đều có thể được mã hoá rồi chép lên kho lưu trữ tương thích S3. Trang này hướng dẫn cách thiết lập, các cơ chế kiểm tra an toàn và mọi cách khôi phục.

Tổng quan

Loại Nội dung Lịch Nơi lưu
Sao lưu toàn phần Website, database (MariaDB, PostgreSQL, MongoDB, Redis) và email của một tài khoản Thủ công, hoặc hằng ngày/hằng tuần lúc 02:00 ~/backups của tài khoản, và S3
Snapshot tăng dần (restic) File, database và mail của mọi tài khoản Mỗi đêm lúc 01:00 /var/backups trên server, hoặc S3
Sao lưu database Một database, của mọi loại Mỗi giờ, mỗi 6 giờ hoặc mỗi ngày backups/db của tài khoản, và S3
Lịch của khách File, database và mail tuỳ khách chọn Hằng ngày hoặc hằng tuần, giờ tuỳ chọn Trong tài khoản, và có thể chép lên S3 riêng của khách
Sao lưu cấu hình (.zpb) Cài đặt và database của panel Hằng ngày S3 (xem Cứu hộ thảm họa)
Sao lưu ứng dụng Dữ liệu của một ứng dụng từ Kho ứng dụng, hoặc thành phần lưu trữ S3 Thủ công, hoặc hằng ngày/hằng tuần /var/backups/zopanel-apps trên server (chỉ root)

Ứng dụng từ Kho ứng dụng và lưu trữ S3 có bản sao lưu riêng. Sao lưu tài khoản, sao lưu database, lịch của khách và snapshot tăng dần (restic) chỉ gồm thư mục website, database và hộp thư. Chúng không chứa dữ liệu của các ứng dụng cài từ Kho ứng dụng (/var/lib/zopanel-apps/<instance>/) hay bucket của lưu trữ S3 (/var/lib/zopanel-storage). Hai loại dữ liệu này được sao lưu bằng thẻ Sao lưu riêng: xem Sao lưu ứng dụng và lưu trữ S3.

Sao lưu toàn phần

Trên trang Sao lưu, chọn tài khoản rồi bấm Tạo bản sao lưu. Toàn bộ website, database và email của tài khoản được nén vào ~/backups.

Bản sao lưu tài khoản gồm những gì

File nén (backup-<ngày>.tar.gz) chứa:

Đường dẫn trong file Nội dung Cách làm
domains/<domain>/ Mọi file của từng website, kể cả ứng dụng deploy từ git cùng virtualenv hoặc node_modules Giữ nguyên file; symlink được giữ là symlink
databases/<tên>.sql Mỗi database MariaDB mariadb-dump (một transaction, kèm routine, trigger)
databases/<tên>.pgsql Mỗi database PostgreSQL pg_dump dạng SQL (--clean --if-exists --no-owner --no-acl), chạy bằng tài khoản hosting qua một role chỉ có quyền của chủ database
databases/<tên>.mongo Mỗi database MongoDB File mongodump của riêng database đó, tạo bằng user tạm chỉ được đọc database này
databases/<tên>.redis Mỗi database Redis Các key của nó (<user>:* trên Redis dùng chung), kèm giá trị và thời hạn
mail/<domain>.tar Hộp thư và thư của từng domain email
manifest.json Tài khoản, website và danh sách database kèm loại Để Khôi phục từ file dựng lại tài khoản trên server khác

Không có trong bản sao lưu tài khoản:

  • Ứng dụng từ Kho ứng dụng và lưu trữ S3: có bản sao lưu riêng (xem Sao lưu ứng dụng và lưu trữ S3). Danh sách Sao lưu không liệt kê chúng trong các website của bản sao lưu tài khoản.
  • Database trên server database bên ngoài: chúng không nằm trên server này.
  • Object cache của WordPress: đây là bộ nhớ đệm (Redis riêng của tài khoản không ghi gì xuống đĩa). Sau khi khôi phục database, object cache của các site WordPress dùng database đó được làm trống, nên site hiển thị ngay dữ liệu đã khôi phục.

Cột Nội dung trong danh sách Sao lưu đếm database theo loại (ví dụ 2 MariaDB, 1 PostgreSQL); di chuột lên nhãn để xem tên.

Để tự động sao lưu mọi tài khoản, mở Cài đặt → Chung:

  • Sao lưu tự động: Tắt, Hằng ngày hoặc Hằng tuần (Chủ nhật). Sao lưu chạy lúc 02:00 theo giờ máy chủ.
  • Số bản giữ lại mỗi tài khoản: từ 1 đến 90 (mặc định 7).

Trước khi sao lưu, ZoPanel kiểm tra dung lượng trống. Nếu còn dưới 1 GB, hoặc dưới 5% ổ đĩa, sao lưu sẽ không chạy, để không bao giờ làm đầy ổ và kéo sập website. Mỗi file sao lưu xong được tính checksum SHA-256, và checksum này được kiểm tra lại trước mọi lần khôi phục.

Sao lưu từ xa lên S3

Sao lưu từ xa cần license Pro. Mở Cài đặt → Sao lưu từ xa, bật công tắc và điền:

Trường Ghi chú
Nhà cung cấp AWS, Cloudflare R2, Backblaze B2, Wasabi, MinIO và các nhà cung cấp khác
Endpoint, Region, Bucket Lấy từ nhà cung cấp lưu trữ
Thư mục gốc Mặc định là zopanel
Access key, Secret key Nên dùng key chỉ có quyền trên bucket này
Số bản giữ lại trên cloud mỗi tài khoản Từ 1 đến 365 (mặc định 14)
URL dạng path (R2, MinIO) Một số nhà cung cấp yêu cầu
HTTP thường (chỉ MinIO nội bộ) Chỉ dùng cho MinIO trong mạng riêng

Bấm Kiểm tra kết nối, rồi Lưu. Từ đó, mọi bản sao lưu tài khoản và sao lưu database đều được tải lên sau khi hoàn tất.

Endpoint, region và cách tạo key chỉ dùng cho một bucket ở Wasabi, Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, Google Cloud Storage và MinIO có trong Nhà cung cấp lưu trữ S3.

Mã hoá và khoá khôi phục

Bản sao được mã hoá ngay trên server trước khi tải lên, bằng XChaCha20-Poly1305 với khoá suy ra từ khoá khôi phục của panel. Nhà cung cấp lưu trữ, hay bất kỳ ai có access key của bucket, chỉ thấy dữ liệu đã mã hoá. File mã hoá được chia thành các khối có xác thực, nên file bị cắt cụt hay bị sửa sẽ không mở được, thay vì khôi phục ra dữ liệu hỏng.

Để xem khoá, mở Sao lưu → Cứu hộ thảm họa → Xem khóa. Hãy ghi lại và cất khoá ở ngoài server, ví dụ trong trình quản lý mật khẩu. Không có khoá thì không đọc được gì trong bucket từ server khác.

Sao lưu tăng dần (restic)

Quản trị viên thiết lập sao lưu tăng dần trên trang Sao lưu, ở thẻ Sao lưu tăng dần:

  1. Bật Tạo snapshot mọi tài khoản mỗi đêm (01:00).
  2. Chọn Nơi lưu: Máy chủ này (/var/backups) hoặc S3. S3 dùng bucket trong Cài đặt → Sao lưu từ xa, nên cần cấu hình phần đó trước.
  3. Đặt số bản giữ lại: Theo ngày (mặc định 7), Theo tuần (mặc định 4) và Theo tháng (mặc định 6).
  4. Bấm Xem khoá khôi phục và cất cả khoá này. Kho restic được mã hoá bằng nó.

Mỗi snapshot chỉ lưu phần thay đổi so với lần trước, đồng thời được khử trùng lặp, nén và mã hoá. Thứ bảy hằng tuần lúc 05:00, ZoPanel kiểm tra cấu trúc kho và đọc lại 2% dữ liệu. Nếu kiểm tra thất bại, quản trị viên nhận cảnh báo sao lưu thất bại.

Sao lưu database

Mở Cơ sở dữ liệu, rồi Sao lưu của từng database:

  • Sao lưu tự động: Tắt, Mỗi giờ, Mỗi 6 giờ hoặc Mỗi ngày, kèm số bản Giữ lại.
  • Sao lưu ngay để tạo bản thủ công. Danh sách được tải lại khi bản sao lưu xong, bản mới được đánh dấu mới.

Hỗ trợ mọi loại database: MariaDB và PostgreSQL dạng SQL nén (.sql.gz), MongoDB dạng mongodump nén (.archive.gz), Redis là các key của nó (.redis.gz). Snapshot tăng dần (restic) gồm database MariaDB, PostgreSQL và MongoDB, không gồm Redis.

Khi bật sao lưu từ xa, các bản này cũng được gửi lên S3 và được mã hoá theo cùng cách.

Lịch sao lưu và kho S3 riêng của khách

Khách tự đặt lịch trên trang Sao lưu của mình, ở thẻ Sao lưu tự động:

  • Lịch: hằng ngày hoặc hằng tuần, với Thứ và Giờ (máy chủ).
  • Nội dung: File website, Database, Email.
  • Số bản giữ trên máy chủ: từ 1 đến 30 (mặc định 3).
  • Chép lên kho của tôi: mọi kho tương thích S3 (Amazon S3, Cloudflare R2, Backblaze B2, Wasabi, Google Cloud Storage với khoá HMAC), với Số bản giữ trên kho từ 1 đến 365.

Kho của khách phải là endpoint HTTPS công khai. Địa chỉ trong mạng nội bộ của server bị từ chối. Thử kết nối kiểm tra bucket có ghi được hay không.

Sao lưu ứng dụng và lưu trữ S3

Mỗi ứng dụng từ Kho ứng dụng có thẻ Sao lưu ở tab Docker của website, và thành phần lưu trữ S3 có thẻ tương tự trên trang Lưu trữ S3:

  • Sao lưu ngay nén toàn bộ thư mục dữ liệu: /var/lib/zopanel-apps/<instance>/ của ứng dụng (gồm cả file .env chứa key và mật khẩu), hoặc /var/lib/zopanel-storage với mọi bucket. Container được tạm dừng vài giây trong lúc sao chép, nên bản sao nhất quán.
  • Lịch: Tắt (mặc định), Mỗi ngày hoặc Mỗi tuần, kèm số bản Giữ lại (từ 1 đến 60, mặc định 7). Các bản cũ hơn bị xoá.
  • Khôi phục dừng ứng dụng và thay dữ liệu bằng bản sao. Mọi thay đổi từ sau thời điểm đó sẽ mất. Dữ liệu hiện tại được giữ lại cho tới khi ứng dụng khởi động với bản khôi phục, và được đặt lại chỗ cũ nếu ứng dụng không khởi động được.

Bản sao lưu nằm trong /var/backups/zopanel-apps/<instance>/ (lưu trữ S3: /var/backups/zopanel-apps/_storage/), thư mục chỉ root đọc được. Bản sao lưu của một ứng dụng tính vào dung lượng đĩa của tài khoản sở hữu nó (bản của lưu trữ S3 không thuộc tài khoản nào). Xoá ứng dụng kèm dữ liệu (hoặc gỡ lưu trữ S3 có tích Xoá luôn toàn bộ dữ liệu và bucket) thì bản sao lưu của nó cũng bị xoá. Ai quản lý ứng dụng cũng có thể bấm sao lưu ngay và xem danh sách; lịch, Khôi phục và xoá bản sao lưu chỉ dành cho quản trị viên (khách thấy dòng "hãy liên hệ nhà cung cấp hosting" dưới danh sách). Khi một lần sao lưu theo lịch bị lỗi, quản trị viên nhận cảnh báo Sao lưu thất bại.

Các bản này nằm lại trên server và không được gửi lên sao lưu từ xa. Hãy chép các bản quan trọng ra ngoài server (ví dụ bằng rclone hoặc scp) và lưu ở dạng mã hoá, vì chúng chứa các key và mật khẩu của ứng dụng. Muốn dùng trên server mới, hãy cài cùng ứng dụng đó trên cùng tên miền, chép bản sao lưu vào thư mục /var/backups/zopanel-apps/<instance>/ của nó rồi bấm Khôi phục. Một số ứng dụng giữ key trong cài đặt của panel chứ không trong dữ liệu (ví dụ key mã hoá của n8n): hãy xem hướng dẫn của ứng dụng đó trước khi chuyển. Với bucket, công cụ S3 bất kỳ dùng key của bucket (ví dụ rclone sync) cũng chép được file sang nơi lưu trữ khác.

Khôi phục

Cả tài khoản

  • Từ bản sao lưu trên server: Sao lưu → Khôi phục. File và database bị ghi đè bằng nội dung của bản sao lưu. Mỗi database được đưa về database cùng tên và cùng loại mà tài khoản đang có (database đã tạo lại với loại khác sẽ được bỏ qua, nhật ký có ghi). SQL của PostgreSQL chạy bằng tài khoản hosting qua một role chỉ có quyền của chủ database, MongoDB được khôi phục bằng user chỉ có quyền trên database đó, còn key Redis chỉ được khôi phục khi mọi key trong file đều thuộc database đó.
  • Từ file tạo trên bất kỳ server ZoPanel nào: Sao lưu → Khôi phục từ file. Tài khoản, website và database được dựng lại đúng tên, user và mật khẩu. Website hoặc database trùng tên với cái đang có sẽ bị từ chối. Database PostgreSQL, MongoDB và Redis được tạo lại với mật khẩu mới (nhật ký ghi rõ): đặt mật khẩu ở trang Database rồi cập nhật cấu hình của ứng dụng. Loại database chưa cài trên server mới sẽ được bỏ qua.
  • Từ S3: Sao lưu → Cứu hộ thảm họa → Duyệt S3, mở server → tài khoản, rồi bấm Khôi phục trên một bản sao lưu. Tài khoản chưa có sẽ được tạo lại. Cách này dùng được cả với bản sao lưu của server không còn tồn tại.

Từng file, thư mục và mail

Trong thẻ Snapshot (sao lưu tăng dần) trên trang Sao lưu, chọn một snapshot, duyệt tới file hay thư mục rồi bấm Khôi phục. File được đặt lại đúng chỗ, file cùng tên sẽ bị thay. Mail được gộp vào hộp thư. Khách tự làm được việc này cho tài khoản của mình, và có thể bấm Tạo snapshot trước khi thay đổi lớn.

Database

  • Trong danh sách Sao lưu của database, bấm Khôi phục. Dữ liệu hiện tại được sao lưu trước (loại trước khôi phục), nên có thể hoàn tác. Database Redis được làm trống trước, rồi các key trong bản sao lưu được đưa lại.
  • Sau mỗi lần khôi phục hoặc import database, object cache của các site WordPress dùng database đó được làm trống.
  • Database khôi phục từ snapshot được thêm vào danh sách sao lưu của database đó, sẵn sàng để khôi phục.

Kinh nghiệm nên làm

  • Bật sao lưu từ xa. Trung tâm bảo mật cảnh báo khi chưa đạt mục Có sao lưu ra ngoài server, và khi 48 giờ qua không có bản sao lưu nào thành công.
  • Cất khoá khôi phục và khoá của sao lưu tăng dần ở ngoài server.
  • Thỉnh thoảng thử khôi phục lên một server dự phòng. Bản sao lưu chưa từng được khôi phục thì chưa chắc đã dùng được.

← Bảo mật Cứu hộ thảm họa →