# Chuyển sang ZoPanel

> Chuyển tài khoản từ bản backup cPanel hoặc DirectAdmin kèm website, database, email và mật khẩu, hoặc chuyển website giữa các server ZoPanel.

Source: https://zopanel.net/vi/docs/migration  
Updated: 2026-10-07

ZoPanel nhập được tài khoản hosting từ bản backup cPanel và DirectAdmin, và chuyển được website giữa các server ZoPanel. Trong cả hai trường hợp, server cũ được giữ nguyên. Bạn chỉ đổi DNS khi bản trên server mới đã sẵn sàng.

## Từ cPanel hoặc DirectAdmin

Trình nhập đọc bản backup đầy đủ của một tài khoản, cho bạn xem những gì tìm thấy, rồi dựng lại tài khoản trên server này. Bản backup được chuyển thành bản sao lưu tài khoản ZoPanel và khôi phục qua đúng quy trình khôi phục thông thường, nên mọi bước kiểm tra an toàn đều được áp dụng.

Bản backup được coi là dữ liệu không đáng tin:

- được đọc bằng Go, không bao giờ giải nén bằng quyền root;
- mọi đường dẫn bị giới hạn trong phạm vi tài khoản;
- dung lượng và số lượng file có giới hạn.

### Những gì được chuyển sang

| Hạng mục | cPanel | DirectAdmin | Ghi chú |
| --- | --- | --- | --- |
| Tài khoản và mật khẩu panel | Có | Có | Mật khẩu cũ vẫn dùng được cho panel và SFTP nếu định dạng hash kiểm tra được ở đây. Nếu không, log sẽ nhắc đặt mật khẩu mới. |
| Website (chính, addon, subdomain, tên miền phụ) | Có | Có | Domain pointer của DirectAdmin không được tạo thành website; log liệt kê chúng để bạn tạo chuyển hướng. |
| Phiên bản PHP | Có | – | Lấy từ thiết lập `ea-php`/`alt-php` của cPanel. Bản cũ (5.x) được ánh xạ sang bản đã cài gần nhất. Các trường hợp còn lại dùng PHP mặc định của server. |
| File website | Có | Có | Liên kết trỏ ra ngoài tài khoản không được sao chép. |
| Database MySQL/MariaDB và user | Có | Có | Tên database đi theo tên đăng nhập của tài khoản trên server này. Mật khẩu được giữ nếu hash dùng chung được (`mysql_native_password`). Nếu không, hệ thống tạo mật khẩu mới và ghi vào file cấu hình của ứng dụng. |
| Hộp thư và thư | Có | Có | Giữ mật khẩu và quota. Nhập thư dạng Maildir; hộp thư dạng `mdbox` không được nhập. |
| Chuyển tiếp và trả lời tự động | Có | Có | Chỉ chuyển tiếp tới địa chỉ email. Trả lời tự động được chuyển thành quy tắc của hộp thư. |
| Cron | Có | Có | Tối đa 100 cron. |
| Zone DNS | Có | – | Cần DNS server trên server này. Bản ghi của zone cũ được giữ, nhưng bản ghi web, mail (MX, SPF) và CAA của server này được ưu tiên, và IP của server cũ được thay bằng IP server này. Zone đã tồn tại ở đây được giữ nguyên. |
| Tài khoản FTP | Có | – | Cần FTP server. `ten@domain` được đổi thành `<tài khoản>_ten`. |
| Chứng chỉ SSL | Có | – | Được cài dưới dạng chứng chỉ tuỳ chỉnh. Nếu không cài được, chứng chỉ miễn phí sẽ được cấp khi DNS trỏ về đây. |

Database PostgreSQL trong bản backup cPanel không được nhập tự động. Hãy tạo database rồi khôi phục bản dump trong thư mục `psql/` của bản backup. Mọi thứ không chuyển được đều được ghi chú trong log, kèm lý do.

Nếu server chưa cài mail server, hộp thư sẽ được nhập sau khi bạn cài. Bản đã chuyển đổi được giữ trong mục backup của tài khoản cho tới lúc đó.

### Các bước thực hiện

1. **Tạo bản backup trên server cũ.**
   - cPanel: trong WHM, dùng **Backup → Backup Wizard** hoặc **Transfer Tool**, hoặc chạy `pkgacct` bằng root. Khách hàng có thể dùng **cPanel → Backup → Download a Full Account Backup**. File có dạng `cpmove-USER.tar.gz`.
   - DirectAdmin: dùng **Admin/Reseller Backup/Transfer → Create Backup** cho user, chọn tất cả mục. Hoặc user tự vào **Create/Restore Backups → Create Backup**. File có dạng `user.RESELLER.USER.tar.gz` hoặc `.tar.zst`.
2. **Mở Chuyển đến** trong menu quản trị ZoPanel.
3. **Đưa bản backup lên**, bằng một trong hai cách:
   - **Tải lên bản backup**: tối đa 50 GB.
   - **Tải từ URL**: đường dẫn tới file, ví dụ đặt tạm trên server cũ hoặc cloud storage. Chỉ cho phép địa chỉ công khai.
4. **Xem lại kết quả phân tích.** Bạn thấy danh sách website, database, hộp thư, chuyển tiếp và cron. Mục **Cần xử lý trước khi nhập** liệt kê xung đột, ví dụ tên đăng nhập hoặc tên miền đã tồn tại. Bạn có thể:
   - đổi **Tên đăng nhập tại đây** rồi bấm **Kiểm tra** (tên database đi theo tên đăng nhập);
   - chọn **Gói** (tên gói cũ được hiển thị để tham khảo);
   - xem mật khẩu database và hộp thư nào **giữ nguyên**, mật khẩu nào là mới.
5. **Bấm Bắt đầu nhập.** Theo dõi log tác vụ: log cho biết dung lượng đã chuyển đổi và mọi ghi chú.
6. **Kiểm tra, rồi đổi DNS.** Trỏ bản ghi A/AAAA của tên miền về server mới. Trỏ cả MX nếu server này nhận mail. Chứng chỉ được cấp tự động khi từng tên miền đã phân giải về đây.

Bản backup đã phân tích chờ tối đa 12 giờ để bắt đầu nhập, sau đó bị xoá. File gốc được xoá ngay sau khi chuyển đổi xong, để giải phóng dung lượng.

Trước khi bắt đầu, hãy đảm bảo server còn đủ dung lượng trống cho bản backup và bản đã chuyển đổi.

## Từ một server ZoPanel khác

### Chuyển website giữa các server

Với tính năng quản lý tập trung ([xem trang Fleet](/vi/docs/fleet)), quản trị viên có thể chuyển nguyên trạng một website sang server ZoPanel khác.

1. **Trên server đích**: vào **Cài đặt → Hệ thống → Quản lý tập trung → Tạo token**. Chọn quyền **Đầy đủ: đăng nhập, chuyển website, tạo tài khoản**, rồi sao chép token. Token chỉ hiển thị một lần.
2. **Trên server nguồn**: vào **Máy chủ → Thêm máy chủ**. Nhập **Tên**, **Địa chỉ panel** và **Fleet token**, rồi bấm **Kết nối**.
3. **Chuyển một website**: mở website trong **Website**. Ở tab **Tổng quan**, tìm thẻ **Chuyển sang máy chủ khác**, chọn máy chủ đích và bấm **Bắt đầu chuyển**.
   **Chuyển nhiều website**: ở trang **Máy chủ**, bấm **Chuyển website** tại server đích và chọn các website.
4. **Đổi DNS** sang server mới. SSL được cấp ở đó khi tên miền đã phân giải về.
5. **Xoá bản cũ** trên server nguồn sau khi DNS đã chuyển xong.

Những gì được giữ nguyên:

- Tài khoản giữ tên đăng nhập và mật khẩu panel. Gói hosting được khớp theo tên, hoặc được tạo mới với cùng giới hạn.
- Database giữ tên, user và mật khẩu, nên `wp-config.php` và `.env` không cần sửa.
- Website trên server nguồn không bị thay đổi.

Mật khẩu SFTP không chuyển được giữa các server ZoPanel; hãy đặt mật khẩu mới trên server đích. Ứng dụng Git và ứng dụng tải lên được build lại trên server đích để tiến trình chạy tại đó.

Giới hạn:

- Chỉ database MariaDB được chuyển tự động.
- Website từ Kho ứng dụng và website Lưu trữ S3 không chuyển được; hãy cài lại trên server đích.
- Email không nằm trong phần chuyển website.

### Khôi phục bản sao lưu tài khoản trên server khác

Mỗi bản sao lưu tài khoản ZoPanel đều kèm mô tả tài khoản, nên khôi phục được trên bất kỳ server ZoPanel nào:

1. Tải bản sao lưu (`.tar.gz`) từ server cũ.
2. Trên server mới, quản trị viên vào **Sao lưu → Khôi phục từ file** và chọn file. Dung lượng tối đa 50 GB.
3. Tài khoản, website và database được dựng lại với đúng tên, user và mật khẩu. Nếu đã có website hoặc database trùng tên, thao tác khôi phục bị từ chối.

Email chỉ được khôi phục cho các tên miền email đã có trên server mới. Log tác vụ liệt kê các tên miền còn lại. Hãy thêm tên miền email và hộp thư, rồi khôi phục lại.

Để dựng lại **toàn bộ server**, gồm cài đặt, gói hosting, tài khoản đăng nhập và khoá, dùng bản sao lưu cấu hình (`.zpb`) với `zopanel ctl dr-restore`. Xem [Tham chiếu dòng lệnh](/vi/docs/cli).