Chuyển đến nội dung chính
Doanh nghiệp có thể tự triển khai và quản lý phần mềm CyStack Endpoint trên máy chủ của Doanh nghiệp theo hướng dẫn dưới đây.
Lưu ý: Hiện tại Endpoint Server chỉ hỗ trợ máy chủ Linux.

​
Yêu cầu hệ thống

Lưu ý chung:
  • Máy chủ cần có IP công khai (Public IP).
  • Người dùng không nên ấn Ctrl + C trong quá trình cài đặt.
  • Mở các port để kết nối đến API của CyStack: 80, 443, 9900

​
Trường hợp quản lý ít hơn 100 thiết bị

Cài tất cả các dịch vụ phụ thuộc redis, mySQL trực tiếp trên Server thì cần Server đáp ứng tối thiểu những yêu cầu như sau:
Số máy chủCPU (core)RAMỔ đĩa (SSD)
124GB75GB

​
Trường hợp quản lý từ 100 - 1000 thiết bị

Trường hợp 1: Cài tất cả các dịch vụ phụ thuộc redis, mySQL trực tiếp trên Server thì cần Server đáp ứng tối thiểu những yêu cầu như sau:
Số máy chủCPU (core)RAMỔ đĩa SSD
110.517.1 GB200 – 300 GB
Trường hợp 2: Đối với các dịch vụ phụ thuộc redis, mySQL mà triển khai trong các Container thì yêu cầu tối thiểu về cấu hình của Container như sau:
Thành phầnSố containerCPU/containerRAM/containerỔ đĩa SSD
Fleet10.54 GB-
Redis 6321.47 GB-
MySQL 8.0 (Aurora 3.07.1)224.3 GB10 GB

​
Hướng dẫn cài đặt

Khách hàng có thể cài đặt tự động CyStack_Endpoint sử dụng endpointCtl (một file Binary).
1

Tải công cụ cài đặt

mkdir -p ~/endpoint && cd ~/endpoint
wget https://d.cystack.net/endpointctl/endpointctl
ls -l
install-server-1install-server-2
2

Cấp quyền thực thi

chmod +x endpointctl
3

Cài đặt

./endpointctl start
Khi được yêu cầu, nhập mật khẩu root. Quá trình cài đặt mất khoảng 1–3 phút.
4

Lựa chọn hình thức cài đặt

Tùy chọn 1: Sử dụng cấu hình mặc định
  • Hệ thống tự tạo cơ sở dữ liệu, người dùng không cần can thiệp.
  • Nhập 1 và nhấn Enter.
install-server-4Tùy chọn 2: Dùng MySQL có sẵn của doanh nghiệp
  • Nhập 2 và nhấn Enter.
  • Chuẩn bị sẵn thông tin sau:
TrườngVí dụ
MySQL Hostlocalhost
MySQL Port3306
Database/User/Password cho các dịch vụces_fleet / ces_api / ces_data_labeling
5

Nhập thông tin Workspace

Sau khi MySQL cấu hình xong, hệ thống yêu cầu nhập:
Work Space ID
Work Space Secret
(CyStack sẽ cung cấp 2 giá trị này)Thời gian cài đặt: 3–10 phút (tùy cấu hình server). Khi hoàn tất, chương trình sẽ hiển thị danh sách dịch vụ đang chạy.install-server-5
6

Sau khi cài đặt

✅ Kiểm tra file agentSau khi hoàn tất, file agent được tạo tự động:
cystack-endpoint_<phiên bản>_amd64.deb
✅ Tự động cập nhật định kỳChạy:
nohup ./endpointctl update > endpoint_updater.log 2>&1 &

​
Hướng dẫn sử dụng endpointctl

​
Danh sách các tham số và cờ

LệnhMô tả
./endpointctl startCài đặt Endpoint. Có thể thêm --config (đường dẫn file cấu hình) hoặc --re-config để cài lại.
./endpointctl stopDừng toàn bộ service.
./endpointctl statusXem trạng thái các service.
./endpointctl backupTạo file .zip chứa bản sao cơ sở dữ liệu tại ~/.cystack/endpoint_server/backupdb/.
./endpointctl restore <path>Phục hồi cơ sở dữ liệu từ file .zip.
./endpointctl updateCập nhật tự động hàng ngày. Có thể chạy nền bằng nohup.

​
Một số trường hợp lỗi

​
❌ Container báo “Unhealthy”

  • Nguyên nhân: server yếu hoặc lỗi cấu hình database.
  • Cách xử lý:
    • Kiểm tra log container: 
      docker logs -f ces_fleet_container
    • Nếu migrate xong chạy lại: 
      ./endpointctl start --re-config
    • Nếu lỗi database xóa config và cài lại từ đầu.

​
⚠️ Lỗi thiếu config

Chạy ./endpointctl start để tạo file config gốc, sau đó chỉnh sửa và dùng lại.

​
⚙️ Backup lâu

Do cấu hình server yếu. Hãy kiên nhẫn chờ hoàn tất.

​
🔑 Lỗi khi lấy Token

Liên hệ CyStack Support.

​
🌐 Lỗi domain (Caddy)

  • Kiểm tra log: 
    docker logs -f caddy_container
  • Nếu:
    • Domain chưa trỏ đúng IP cập nhật DNS.
    • Domain bị giới hạn SSL đổi domain khác.