ECLOYOUR SYSTEM.
YOUR WAY.
Tải Eclo Local
Trang chủCài đặt Eclo Panel
ECLO · Hướng dẫn

Cài Eclo Panel
trên Linux.

Từ một server Linux đến website đầu tiên: chuẩn bị, cài đặt, kết nối và quản lý.

1. Chuẩn bị server

Eclo Panel cài trực tiếp trên server Linux để quản lý website và dịch vụ. Nên bắt đầu bằng một server mới, chưa cài bảng điều khiển hosting khác để tránh xung đột cấu hình.

  • Hệ điều hành: Ubuntu 24.04 hoặc Debian 12/13, sử dụng systemd.
  • Kiến trúc: x86_64 (x64) hoặc ARM64.
  • Quyền: tài khoản SSH có quyền sudo hoặc root.
  • Kết nối: internet để tải bộ cài và các gói dịch vụ; IP public nếu cần truy cập từ bên ngoài.

Tài nguyên cần thiết tùy website và dịch vụ. Database, Docker và bộ quét ClamAV có thể sử dụng nhiều RAM; kiểm tra tài nguyên trước khi cài thêm.

Server đang có dữ liệu? Sao lưu website, database và cấu hình trước khi cài. Không cài chồng lên hệ thống có panel khác mà chưa đánh giá xung đột Nginx, PHP, database và cổng.

2. Tải và chạy bộ cài

Kết nối SSH vào server. Tải script từ tên miền chính thức của ECLO:

Terminal · SSH
curl -fsSL https://eclo.vn/panel/install.sh -o eclo-panel-install.sh

Bạn có thể xem nội dung bằng less eclo-panel-install.sh trước khi chạy. Bộ cài cần quyền quản trị để thiết lập thư mục hệ thống, tài khoản và dịch vụ.

Terminal · SSH
sudo bash eclo-panel-install.sh

Để chọn cổng khác từ lúc cài, dùng tham số --port:

Terminal · SSH
sudo bash eclo-panel-install.sh --port 22893

Đợi bộ cài hoàn thành và giữ lại thông tin truy cập được hiển thị. Không đóng phiên SSH khi quá trình cài đang chạy.

3. Mở Panel lần đầu

Khi cài mới thành công, Terminal hiển thị địa chỉ truy cập, tài khoản quản trị, mật khẩu ban đầu và dấu vân tay chứng chỉ TLS. Mở đúng URL được bộ cài cung cấp, thường có dạng:

Địa chỉ minh họa
https://IP-CUA-SERVER:22891

Nếu nhà cung cấp VPS có firewall hoặc security group, cho phép cổng TCP của Panel từ địa chỉ quản trị của bạn. Website công khai thường cần thêm TCP 80 và 443. Không cần mở database ra internet để website cùng server sử dụng.

Chứng chỉ lần đầu: Panel tạo chứng chỉ riêng. Đối chiếu TLS fingerprint hiển thị trong Terminal với chứng chỉ khi kết nối trước khi tin cậy. Sau đó cấu hình tên miền và chứng chỉ phù hợp cho địa chỉ quản trị.

Đăng nhập bằng tài khoản vừa tạo, đổi mật khẩu theo nhu cầu và giữ thông tin truy cập ở nơi an toàn. Không đưa mật khẩu hoặc URL truy cập riêng vào ảnh chụp công khai.

4. Chọn dịch vụ và tạo website

  1. Trong bước thiết lập đầu tiên, chọn dịch vụ và phiên bản cần dùng. Ví dụ: Nginx, một phiên bản PHP và MySQL.
  2. Chờ tác vụ cài đặt báo hoàn thành rồi mở Website để tạo site.
  3. Nhập tên miền, chọn loại website và thư mục mã nguồn. Có thể tạo database hoặc FTP đi kèm nếu cần.
  4. Đặt thư mục chạy web theo cấu trúc source: thư mục gốc, public hoặc thư mục khác.
  5. Tải code bằng File Manager, FTP hoặc triển khai từ Eclo Local. Chạy Composer / npm thủ công nếu dự án cần.

Ví dụ: mã nguồn ở /srv/eclo/sites/example.com còn document root ở /srv/eclo/sites/example.com/public. Hai đường dẫn này có mục đích khác nhau; không cần đưa toàn bộ source vào public.

FTP/FTPS và một số công cụ hệ thống được chuẩn bị khi cài Panel. Kiểm tra trạng thái firewall trước khi bật hoặc thay đổi rule để tránh mất quyền truy cập SSH.

5. Trỏ tên miền và bật HTTPS

  1. Trỏ bản ghi DNS A của tên miền về IPv4 server. Chỉ thêm AAAA nếu IPv6 server đã hoạt động đúng.
  2. Kiểm tra tên miền mở được website qua HTTP và cổng 80 truy cập được từ internet.
  3. Mở website trong Panel → SSL / HTTPS, chọn tên miền và đăng ký Let's Encrypt.
  4. Kiểm tra trạng thái chứng chỉ, tên miền, ngày hiệu lực và ngày hết hạn sau khi tác vụ hoàn tất.

Nếu dùng CDN hoặc proxy, đường dẫn /.well-known/acme-challenge/ phải được chuyển đến đúng website. Bạn cũng có thể nhập chứng chỉ và private key riêng trong phần SSL.

Chứng chỉ cho website và chứng chỉ của địa chỉ quản trị Panel là hai cấu hình khác nhau. Cấp SSL cho website không tự thay chứng chỉ cổng quản trị.

6. Kết nối từ Eclo Local

  1. Mở bộ chọn máy / server trên Eclo Local và chọn thêm kết nối.
  2. Nhập IP hoặc tên miền server, cổng Panel (mặc định 22891) và tài khoản Eclo Panel.
  3. Xác minh chứng chỉ / fingerprint khi ứng dụng yêu cầu, rồi kết nối.
  4. Trong dự án local, mở Triển khai và liên kết với website trên server.
  5. Chọn file cần chuyển, ghi chú gói và theo dõi tiến trình đến khi hoàn thành.

Chỉ những website và chức năng được tài khoản cho phép mới truy cập được. Triển khai code không tự nhập database; dùng sao lưu / khôi phục hoặc nhập dữ liệu riêng khi cần.

7. Các lệnh quản trị cần biết

Khi không truy cập được giao diện, dùng SSH để kiểm tra Panel:

Terminal · SSH
sudo eclo-panel --help
sudo eclo-panel status

Xem thông tin truy cập và dấu vân tay chứng chỉ:

Terminal · SSH
sudo eclo-panel credentials
sudo eclo-panel fingerprint

Đặt lại mật khẩu tài khoản quản trị admin (thay tên nếu bạn dùng tài khoản khác):

Terminal · SSH
sudo eclo-panel reset-password admin

Cập nhật Panel hoặc quay về bản trước khi có sự cố cập nhật:

Terminal · SSH
sudo eclo-panel update
Terminal · SSH
sudo eclo-panel rollback

Chạy --help để xem các lệnh và tham số của phiên bản đang cài. Khôi phục phiên bản Panel không thay thế việc khôi phục dữ liệu website.

8. Khi cần kiểm tra sự cố

Không mở được Panel

Kiểm tra IP, cổng, trạng thái dịch vụ và firewall cả trên hệ điều hành lẫn nhà cung cấp VPS. Dùng URL đầy đủ do bộ cài hiển thị.

Website báo 403 hoặc “No input file specified”

Kiểm tra document root, file index, phiên bản PHP, quyền đọc thư mục của tài khoản website và nhật ký Nginx / PHP. Không đổi toàn bộ quyền thành 777 để bỏ qua lỗi.

Cấp SSL không thành công

Kiểm tra DNS, cổng 80, IPv6, CDN và đường dẫn xác minh. Đọc lỗi trong tác vụ trước khi gửi lại yêu cầu để tránh chạm giới hạn của nhà cấp chứng chỉ.

Bảo vệ Panel và website →Liên hệ ECLO →