Hướng dẫn sử dụng ZoCloud
ZoCloud build và chạy app của bạn từ GitHub, từ thư mục trên máy hoặc từ một Docker image, kèm database, object storage, tên miền, e-mail doanh nghiệp, AI gateway và thanh toán bằng ví VND. Máy chủ và bản sao lưu chính đặt tại Việt Nam.
- Portal:
https://app.zocloud.io - API:
https://api.zocloud.io/v1 - Trang trạng thái hệ thống:
https://app.zocloud.io/status
Mục lục
| Tài liệu | Nội dung |
|---|---|
| App: project, service và deploy | Project, environment, service (web, worker, cron, riêng tư), nguồn deploy, zocloud.json, biến môi trường, mạng nội bộ, volume, scale, chế độ ngủ, preview, log, rollback, tên miền riêng, bảo mật |
| Database | PostgreSQL, MySQL (MariaDB), Redis (Valkey): kết nối, truy cập từ Internet, backup và khôi phục, xem dữ liệu |
| Object storage (S3) | Object storage (S3) trên s3.zocloud.app |
| Tên miền | Mua, gia hạn, chuyển tên miền, giấy tờ .vn, DNS của ZoCloud, kết nối Cloudflare |
| E-mail doanh nghiệp (Google Workspace, Microsoft 365) | Google Workspace và Microsoft 365 |
| AI gateway | AI gateway chuẩn OpenAI |
| Thanh toán | Ví, nạp tiền, gói, tính theo mức dùng, bảng kê, hoá đơn VAT |
| Tổ chức, thành viên và bảo mật tài khoản | Tổ chức, thành viên và vai trò, 2FA, token, hoạt động, thông báo, hỗ trợ |
| zo CLI và MCP server | zo CLI, MCP server cho AI agent, kết nối ChatGPT |
Các mục trên portal
Sau khi đăng nhập và chọn tổ chức, thanh điều hướng có: Project, Tên miền, E-mail, AI, Thanh toán, Thành viên, GitHub, Thông báo, Hoạt động, Hỗ trợ. Menu tài khoản (góc phải) có Tài khoản, Thanh toán, Giao diện sáng/tối, Đăng xuất.
Bấm Ctrl+K (macOS: ⌘K) để mở Bảng lệnh: tìm project, service, database hoặc thao tác.
Trên trang service, project hay tổ chức đôi khi có gợi ý của ZoCloud (ví dụ volume sắp đầy, nên bật tường lửa). Bạn có thể Bỏ qua hoặc Nhắc lại sau.
Bắt đầu nhanh (5 phút)
1. Tạo tài khoản
- Mở
https://app.zocloud.io/signup. - Điền Họ tên, Email, Mật khẩu (ít nhất 10 ký tự), bấm Đăng ký. Nếu ZoCloud đã bật đăng nhập Google, bạn có thể bấm Tiếp tục với Google.
- ZoCloud tự tạo cho bạn một tổ chức cá nhân.
2. Xác minh e-mail và hoàn tất thiết lập
- Mở hộp thư, bấm liên kết xác minh. Nếu không thấy thư, bấm Gửi lại trên banner "Hãy xác minh … bằng liên kết trong hộp thư".
- Portal hiện khung Hoàn tất thiết lập tài khoản. Ngoài Xác minh địa chỉ email, bạn làm thêm một trong hai việc:
- Nạp tiền: nạp vào ví một số tiền tối thiểu (số tiền vẫn là của bạn để dùng dịch vụ), hoặc
- Kết nối GitHub: kết nối một tài khoản GitHub đã tạo đủ số ngày yêu cầu.
- Làm xong là tổ chức chạy được ngay. Trong một số trường hợp đội ZoCloud duyệt tay ("Đội ngũ của chúng tôi duyệt từng tài khoản mới…"); bạn sẽ nhận e-mail khi xong. Trong lúc chờ, bạn chưa deploy hay tạo database được.
3. Tạo project
- Ở mục Project, bấm Tạo project.
- Nhập Tên project (chữ thường, số và dấu
-), chọn Vị trí (nơi app và database chạy), bấm Tạo. - Bạn vào canvas của project, environment mặc định là
production.
4. Deploy app
Bấm Thêm trên canvas và chọn một cách:
Từ repo GitHub (mở hộp thoại Deploy từ Git), có ba thẻ:
| Thẻ | Khi nào dùng |
|---|---|
| GitHub | Repo công khai hoặc riêng tư qua GitHub App của ZoCloud. Cần Kết nối GitHub trước (xem App: project, service và deploy). Push lên nhánh là tự deploy. |
| URL Git công khai | Repo công khai qua https://… |
| Docker image | Image công khai trên Docker Hub, GHCR, Quay…, ví dụ wordpress:6 hay ghcr.io/owner/app:1.0 |
Chọn repo (hoặc dán URL / tên image), kiểm tra Tên service, Nhánh, Thư mục gốc, Lệnh chạy (để trống để ZoCloud tự chọn), rồi bấm Tạo và deploy.
Từ máy của bạn (zo CLI): đẩy một thư mục lên, không cần Git.
curl -fsSL https://app.zocloud.io/install.sh | sh
zo login # dán token tạo ở Tài khoản → Token truy cập
zo deploy -to <tổ-chức>/<project>/web # chạy trong thư mục app
Từ template: WordPress, n8n, Ghost, Uptime Kuma… đã cấu hình sẵn database, ổ lưu trữ và biến môi trường. Chọn template, bấm Deploy template.
ZoCloud tự nhận diện framework, build và chạy app. Theo dõi tiến trình ở tab Deploy của service.
5. Mở app
Mỗi web service có sẵn một địa chỉ HTTPS dạng:
https://<service>-<project>.zocloud.app
Địa chỉ hiện ngay dưới tên service (và in ra cuối lệnh zo deploy). Nếu tên đó đã có người dùng, ZoCloud thêm một hậu tố ngắn.
Lưu ý quan trọng: app phải nghe trên 0.0.0.0 và cổng trong biến PORT. Lỗi deploy hay gặp nhất là app chỉ nghe localhost hoặc một cổng cố định khác.
Bước tiếp theo
- Thêm database: Database
- Gắn tên miền riêng: App: project, service và deploy
- Cho AI agent tự deploy: zo CLI và MCP server