Cài đặt trên máy chủ
Qubix chạy trên máy chủ của quý vị — một lệnh cài đặt duy nhất sẽ khởi động toàn bộ hệ thống (cơ sở dữ liệu, backend, máy chủ web, các tiện ích hỗ trợ). Quý vị chỉ cần một máy chủ Linux sạch có quyền truy cập SSH và Docker.
Yêu cầu về máy chủ
Trình cài đặt sẽ kiểm tra máy chủ trước khi bắt đầu và từ chối tiếp tục nếu máy chủ rõ ràng quá yếu. Cấu hình tối thiểu khuyến nghị:
| Tài nguyên | Tối thiểu khuyến nghị |
|---|---|
| CPU | 4 vCPU |
| RAM | 8 GB |
| Ổ đĩa | 20 GB SSD hoặc HDD |
Đây là các giá trị mà trình cài đặt khuyến nghị; dưới mức này hệ thống vẫn chạy nhưng sẽ cảnh báo rằng ClickHouse có thể chậm vào những ngày tải nặng. Ngưỡng cứng tối thiểu là 10 GB ổ đĩa trống — nếu thấp hơn, quá trình cài đặt sẽ dừng lại.
Loại ổ đĩa không ảnh hưởng đến việc phục vụ lưu lượng — cả SSD lẫn HDD đều hoạt động, và HDD giúp tiết kiệm chi phí; SSD chỉ giúp tăng tốc các báo cáo quản trị khi dữ liệu lớn. 20 GB là đủ để bắt đầu: chứa được nền tảng cùng hàng nghìn creative, và lịch sử lưu lượng hầu như không chiếm mấy dung lượng. Để biết chính xác một ổ đĩa nhất định có thể chứa bao nhiêu lưu lượng và bao nhiêu creative, xem Lựa chọn máy chủ.
Một số yêu cầu bắt buộc:
- Máy chủ Linux 64-bit (VPS/VDS hoặc máy chủ riêng), không phải máy tính cá nhân hay hosting chia sẻ.
- Docker với plugin
docker compose(V2).docker-composeđộc lập cũ (V1) không được hỗ trợ — trình cài đặt sẽ phát hiện và dừng lại. - Kết nối HTTPS ra ngoài để máy chủ có thể tải về các image Qubix.
Hãy cài đặt Qubix trên máy chủ dành riêng cho nó. Hệ thống yêu cầu các cổng 80, 443 (và 8443 cho tùy chọn Cloudflare) phải rảnh. Nếu một máy chủ web khác đang chiếm các cổng này, hãy giải phóng chúng trước hoặc chọn tùy chọn Cloudflare ở bước sau trong trình hướng dẫn.
Cài đặt
-
Kết nối đến máy chủ qua SSH với tư cách root.
-
Chạy lệnh cài đặt:
Bashcurl -sSL https://qubix.pro/install.sh | bash(hoặc
wget -qO- https://qubix.pro/install.sh | bash)
-
Trình cài đặt hiển thị banner Qubix, kiểm tra máy chủ, đặt một vài câu hỏi (thư mục cài đặt, giao diện mạng nào sẽ được sử dụng để công bố), sau đó tải về và khởi động hệ thống. Hãy chờ cho đến khi có thông báo rằng mọi thứ đã sẵn sàng.
Hãy để trình cài đặt hoàn tất. Dừng giữa chừng có thể để lại một hệ thống được cấu hình dở dang — nếu điều đó xảy ra, cách khôi phục an toàn nhất là xóa thư mục cài đặt và chạy lại lệnh trên một máy chủ sạch.
Kết quả quý vị nhận được
Trình cài đặt khởi động một tập hợp nhỏ các container tạo nên Qubix: cơ sở dữ liệu phân tích, backend Qubix, máy chủ web, và các tiện ích tự động cập nhật, chứng chỉ và AI. Quý vị không cần quản lý chúng thủ công — Qubix tự điều khiển chúng cho quý vị.
Hoàn tất cài đặt trên trình duyệt
Khi hệ thống đã sẵn sàng, trình cài đặt sẽ in ra một đường dẫn như:
http://<your-server-ip>:7000/install?k=…
Mở đường dẫn đầy đủ đó trong trình duyệt (khóa ?k=… là bắt buộc). Nó sẽ mở trình hướng
dẫn cài đặt, nơi quý vị chọn cách Qubix sẽ được truy cập, nhập giấy phép và tạo quản trị viên đầu tiên.
Trình hướng dẫn cài đặt chỉ có thể truy cập cho đến khi quý vị hoàn tất nó. Sau khi quản trị viên đầu tiên được tạo, đường dẫn sẽ ngừng hoạt động — đây là hành vi bình thường. Từ đó trở đi, quý vị đăng nhập tại địa chỉ riêng của bảng điều khiển.