ECLO · Hướng dẫn

Cài Eclo Local.
Bắt đầu dự án đầu tiên.

Tải đúng bộ cài, chọn dịch vụ và chuẩn bị môi trường phát triển trên máy tính của bạn.

1. Chọn đúng bộ cài

Tải bộ cài từ trang tải ECLO. Hiện có macOS Apple Silicon và Windows x64. Không dùng bản dành cho kiến trúc khác với máy.

Windows dùng dịch vụ native, không yêu cầu cài Ubuntu hay WSL. Một số dịch vụ như Swoole, Docker và Redis không có trong bản Windows native; xem bảng hỗ trợ trước khi chuyển dự án.

2. Cài trên macOS

  1. Mở file .dmg vừa tải.
  2. Kéo Eclo Local vào Applications.
  3. Mở ứng dụng từ Applications và hoàn tất các bước thiết lập.
  4. Nếu macOS yêu cầu quyền cho thao tác hệ thống hoặc Keychain, kiểm tra đúng ứng dụng ECLO trước khi cho phép.

Chỉ tải từ nguồn chính thức. Nếu macOS chặn hoặc cảnh báo bộ cài, kiểm tra nguồn tải và thông tin trong Privacy & Security; không tắt cơ chế bảo vệ hệ thống trên toàn máy.

3. Cài trên Windows

  1. Mở bộ cài .exe cho Windows x64.
  2. Kiểm tra tên ứng dụng và vị trí cài, rồi làm theo hướng dẫn.
  3. Mở Eclo Local, chọn thiết lập môi trường và chờ tải các công cụ cần thiết.
  4. Chấp nhận yêu cầu Administrator khi cần thiết lập tên miền hoặc chứng chỉ local.

Nếu quá trình tải dịch vụ gặp sự cố, xem chi tiết thiết lập và kiểm tra kết nối mạng, quyền ghi thư mục ứng dụng hoặc phần mềm bảo vệ trước khi thử lại.

4. Thiết lập dịch vụ và cổng

Trong ứng dụng, cài phiên bản PHP, Node.js và database cần cho dự án. Bạn không cần cài mọi dịch vụ ngay từ đầu.

Chọn cổng HTTP / HTTPS phù hợp trong cấu hình. Cổng 80 và 443 cho phép URL không cần ghi cổng. Nếu đang có dịch vụ khác dùng các cổng này, chọn cổng trống và dùng URL được Eclo hiển thị.

Tên miền .eclo và chứng chỉ local dùng trên máy của bạn. Chúng không phải tên miền công khai hoặc chứng chỉ để triển khai lên internet.

Bật khởi động cùng hệ điều hành nếu muốn ứng dụng sẵn sàng sau khi đăng nhập. Kiểm tra thêm tùy chọn tự chạy của từng website / dịch vụ theo nhu cầu.

5. Thêm website đầu tiên

  1. Mở Website / Sites, tạo dự án hoặc thêm một thư mục code có sẵn.
  2. Đặt tên miền .eclo, chọn dịch vụ và phiên bản cần dùng.
  3. Chọn document root; với source có thư mục public, chọn thư mục đó để phục vụ web.
  4. Tạo hoặc liên kết database. Cập nhật cấu hình kết nối trong source của bạn.
  5. Chạy website và mở địa chỉ Eclo cung cấp. Dùng Terminal hoặc công cụ dự án để cài thư viện khi cần.

PHP thuần, Laravel, Node.js hoặc HTML đều có thể có quy trình chuẩn bị riêng. ECLO không bắt mọi dự án chạy Composer, npm hay lệnh Laravel khi triển khai.

6. Kết nối và triển khai lên server

Server đích cần cài Eclo Panel. Thêm kết nối bằng IP / tên miền, cổng và tài khoản Panel, rồi liên kết website trong phần Triển khai của dự án.

Kiểm tra danh sách file được chọn trước khi gửi. Thư mục thư viện ở gốc, cấu hình môi trường và dữ liệu local có thể không cần chuyển; bạn quyết định mục nào được gửi. Database được chuyển riêng.

Bạn cũng có thể kéo source từ Panel về để tạo môi trường local. Chỉ lấy dữ liệu cần thiết, đặc biệt khi bản sao chứa thông tin của người dùng thật.

7. Cập nhật và nhận hỗ trợ

Mở phần phiên bản / cập nhật trong Eclo Local để kiểm tra bản mới. Làm theo tiến trình cập nhật trong ứng dụng; giữ bản sao lưu dự án và database trước các thay đổi quan trọng.

Nếu cần cài lại thủ công, dùng đúng bộ cài cho nền tảng của bạn trên trang tải về. Không xóa thư mục dữ liệu ứng dụng hoặc dự án khi chưa có bản sao lưu.

Gửi lỗi, hệ điều hành, phiên bản ECLO và các bước tái hiện đến info@eclo.vn. Che mật khẩu, token và nội dung dữ liệu riêng trong ảnh chụp / nhật ký.