# Đại lý

> Bán hosting qua đại lý: tài khoản đại lý bị giới hạn theo gói của chính họ, gói và khách của đại lý, bán vượt, white-label, tạm khoá và thời gian giữ dữ liệu.

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

Đại lý là tài khoản bán hosting cho khách hàng riêng của họ trên server của bạn. Đại lý tự tạo gói hosting và tài khoản khách, rồi quản lý bằng tài khoản đăng nhập panel của mình. ZoPanel giữ mỗi đại lý trong đúng gói bạn đã bán, nên không đại lý nào dùng được nhiều tài nguyên server hơn phần đã trả tiền.

Tài khoản đại lý cần license Pro.

## Vai trò

| Vai trò | Quyền |
| --- | --- |
| **Quản trị viên** | Toàn quyền: cài đặt server, mọi tài khoản, gói cho khách trực tiếp và cho đại lý |
| **Đại lý** | Tạo gói và tài khoản khách trong phạm vi gói của chính mình. Chỉ thấy khách của mình. Có thể chạy website của riêng mình. |
| **Khách hàng** | Quản lý website, database, mail, file và sao lưu của mình |

## Tạo đại lý

1. Trong **Gói hosting**, tạo một gói cho đại lý. Đặt **Tài khoản con (đại lý)** bằng số tài khoản khách mà đại lý được tạo (0 là không giới hạn). Trường này chỉ dùng cho gói đại lý.
2. Đặt các giới hạn còn lại theo tổng của đại lý: ổ đĩa, số website, CPU, RAM, số tiến trình, số PHP worker, v.v.
3. Trong **Tài khoản**, bấm **Tạo tài khoản**, chọn vai trò **Đại lý** và gói vừa tạo.

Chỉ quản trị viên đang đăng nhập panel mới tạo được tài khoản đại lý. API token không tạo được, kể cả token toàn quyền.

## Gói của đại lý giới hạn khách như thế nào

Gói của đại lý là mức trần cho mọi thứ bên dưới:

- **Gói hosting:** đại lý không tạo được gói cấp nhiều hơn gói của mình, ví dụ nhiều RAM, CPU, PHP worker hơn, hay có quyền shell hoặc PHP luôn chạy mà gói đại lý không có. Nếu vượt, việc lưu gói sẽ báo lỗi và nêu rõ các giới hạn vượt mức.
- **Số tài khoản:** giới hạn bởi **Tài khoản con (đại lý)**.
- **Website:** website của chính đại lý cộng với website của mọi khách phải nằm trong giới hạn website của gói đại lý.
- **Dung lượng ổ đĩa:** tổng dung lượng các gói của khách, cộng phần của chính đại lý, phải vừa với dung lượng của đại lý. Đại lý không thể bán mười gói 10 GB trên gói 20 GB. Việc nâng một gói đang có khách dùng cũng bị từ chối nếu các khách đó không còn vừa.
- **Thay đổi về sau:** nếu bạn hạ gói của đại lý, các gói của đại lý không bao giờ cấp nhiều hơn gói mới, và giới hạn mới được áp dụng ngay cho khách của họ.

### Bán vượt (oversell)

Mặc định, khách của đại lý phải vừa trong gói của đại lý như trên. Để cho phép bán vượt, bật **Cài đặt → Cho đại lý bán vượt**. Khi bật, việc kiểm tra tổng dung lượng và tổng số website được bỏ qua, nên tổng các gói của khách có thể vượt gói của đại lý. Riêng từng gói của khách vẫn không được vượt gói của đại lý.

## Đại lý quản lý những gì

Khi đăng nhập panel, đại lý có mục **Tài khoản** và **Gói hosting** cho khách của mình. Đại lý tạo, tạm khoá, mở khoá và xoá khách, đổi gói và mật khẩu cho khách, và xem mức sử dụng.

Đại lý cũng có thể kết nối hệ thống billing riêng bằng API token tạo từ tài khoản đại lý. Token đó chỉ bán gói của đại lý cho khách của đại lý. Xem [WHMCS và module billing](/vi/docs/whmcs).

## White-label

Với license Business, bạn có thể thay tên ZoPanel trong **Cài đặt → Chung → Tên panel (white-label)**. Tên này hiển thị trong panel và trong thông báo thay cho ZoPanel. Thiết lập áp dụng cho cả server, nên mọi đại lý và khách đều thấy cùng một tên. Trường này nhận tối đa 40 ký tự.

Để dùng địa chỉ riêng cho panel, đặt **Cài đặt → Chung → Tên miền & SSL cho panel**. Khi đó panel chạy tại `https://ten-mien:8888` với chứng chỉ hợp lệ.

## Tạm khoá

**Tạm khoá** một tài khoản sẽ hiện trang tạm khoá trên các website của tài khoản và chặn đăng nhập. Các phiên đang mở bị đăng xuất.

- Tạm khoá một **đại lý** sẽ tạm khoá luôn mọi khách của đại lý đó.
- Mở khoá đại lý sẽ mở lại các khách bị khoá cùng lúc với đại lý. Khách bị người khác khoá riêng vẫn giữ trạng thái khoá.
- Đại lý không mở khoá được tài khoản do quản trị viên khoá.
- Khi license không còn tính năng đại lý, ví dụ sau khi hạ gói, đại lý không quản lý khách được nữa. Website vẫn chạy bình thường.

## Xoá tài khoản và thời gian giữ dữ liệu

Xoá một tài khoản sẽ gỡ website, database, mail và file của tài khoản khỏi panel. Mặc định dữ liệu không bị huỷ ngay mà được giữ lại một thời gian, để có thể hoàn tác khi lỡ xoá, hoặc khi hệ thống billing xoá do khách trả tiền trễ.

Đặt thời gian giữ trong **Cài đặt → Chung → Giữ dữ liệu tài khoản đã xoá (ngày)**:

| Giá trị | Kết quả |
| --- | --- |
| 7 (mặc định) | Giữ dữ liệu 7 ngày |
| 1–90 | Giữ dữ liệu đúng số ngày đó |
| 0 | Xoá dữ liệu ngay |

Trong thời gian giữ:

- thư mục home và các file dump database nằm trong `/home/.zp-terminated/<user>-<time>/`,
- hộp thư nằm trong `/var/vmail/.zp-terminated/<user>-<time>/`.

Chỉ root đọc được các thư mục này, và file trong đó không bị tính vào quota của tài khoản mới. Để lấy lại tài khoản, xem mục "Lỡ xoá một tài khoản" trong [Cứu hộ thảm họa](/vi/docs/disaster-recovery).

Chỉ xoá được đại lý sau khi đã xoá hoặc chuyển hết khách của đại lý đó. Tài khoản bị xoá qua API cấp phát hay module billing cũng được giữ dữ liệu theo cùng thời gian này.
