Cài đặt Agent lên máy chủ
Cài OneDash Agent để bật giám sát thời gian thực và mở khoá toàn bộ tính năng quản lý nâng cao — chạy một lệnh cài đặt, qua terminal nhúng trong OneDash hoặc terminal riêng của bạn.
OneDash Agent là một chương trình nhỏ chạy nền trên máy chủ. Sau khi cài, máy chủ sẽ gửi thông tin sức khỏe về OneDash theo thời gian thực và mở khoá các tính năng quản lý nâng cao.
Vì sao nên cài Agent?
- Giám sát thời gian thực — theo dõi CPU, RAM, ổ đĩa và mạng kèm biểu đồ trực tiếp, cảnh báo sớm khi có bất thường.
- Kết nối nhanh hơn — Agent giữ kết nối thường trực, mở Terminal tức thì, không phải đăng nhập SSH lại mỗi lần.
- Quản lý sâu hơn — quản lý tệp tin, tiến trình, dịch vụ web và dự án ngay trên giao diện OneDash.
- Cảnh báo bảo mật & tự khôi phục — phát hiện đăng nhập đáng ngờ và tự khởi động lại dịch vụ khi gặp sự cố.
Khi máy chủ chưa cài Agent, trang chi tiết máy chủ hiển thị lời mời cài đặt kèm các lợi ích chính.
Không cài Agent, vẫn dùng được Terminal SSH cơ bản, nhưng các tính năng giám sát và quản lý nâng cao sẽ bị giới hạn.
Cần chuẩn bị trước khi cài
- Đã thêm máy chủ vào OneDash.
- Quyền quản trị trên máy chủ: tài khoản
roothoặc tài khoản có quyềnsudo(Linux), hoặc tài khoản Administrator (Windows). - Máy chủ kết nối được Internet để tải Agent về.
Cách cài Agent
Bấm Cài đặt Agent ở lời mời trên trang chi tiết máy chủ (hoặc bấm lại bất cứ lúc nào từ trang này nếu cần cài lại). OneDash hiển thị khối Lệnh cài đặt — một dòng lệnh duy nhất, kèm token cài đặt dùng một lần (tự huỷ sau khi sử dụng).
Có hai cách chạy lệnh này:
- Chạy ngay trong OneDash (nhanh nhất): bấm Chạy ngay — OneDash mở một phiên Terminal nhúng, tự dán và chạy lệnh trên máy chủ. Nếu tài khoản đăng nhập không phải
root, terminal sẽ hỏi mật khẩu sudo — nhập trực tiếp vào terminal (không dán qua nơi khác). - Tự chạy trên terminal riêng: bấm Sao chép, dán lệnh vào Terminal SSH quen thuộc của bạn (hoặc Terminal SSH ngay trong OneDash), rồi nhấn Enter.
Với máy chủ Windows, OneDash cung cấp lệnh cài tương ứng (PowerShell). Hãy mở cửa sổ dòng lệnh với quyền Administrator rồi dán lệnh.
Theo dõi tiến trình cài
Trong lúc chờ, OneDash tự kiểm tra trạng thái mỗi 5 giây — không cần thao tác thêm. Khi Agent cài xong và đăng ký thành công, trang tự chuyển sang trạng thái đang giám sát.
Nếu muốn xác nhận thủ công ngay trên máy chủ, dùng 2 lệnh có sẵn trong khối "Kiểm tra trạng thái agent": onedash status (kiểm tra dịch vụ) và onedash logs -f (xem log thời gian thực).
Kiểm tra Agent đã hoạt động
Khi cài xong, trang chi tiết máy chủ chuyển sang trạng thái "Máy chủ của bạn đang được bảo vệ", hiển thị đầy đủ các khối Sức khỏe & tài nguyên, An toàn & truy cập, Truy cập web.
Trong danh sách máy chủ, máy chủ đã có Agent cũng hiển thị nhãn online kèm chỉ số CPU/RAM/ổ đĩa cập nhật liên tục.
Xử lý sự cố thường gặp
| Hiện tượng | Nguyên nhân thường gặp | Cách xử lý |
|---|---|---|
| Lệnh báo thiếu quyền / Permission denied | Tài khoản chạy lệnh không có quyền quản trị | Dùng tài khoản root/sudo (Linux) hoặc Administrator (Windows) rồi chạy lại lệnh |
| Terminal nhúng ("Chạy ngay") không kết nối được máy chủ | Máy chủ chặn kết nối SSH từ bên ngoài (tường lửa), hoặc agent kết nối thất bại | Tự chạy lệnh trên terminal riêng của bạn đang có sẵn quyền truy cập máy chủ |
| Đã chạy lệnh nhưng Agent vẫn báo offline | Máy chủ chưa ra được Internet, hoặc tường lửa chặn cổng kết nối | Dùng onedash status để kiểm tra dịch vụ, kiểm tra kết nối mạng/tường lửa rồi thử lại |
| Token trong lệnh cài đặt đã hết hạn | Token cài đặt tự huỷ sau khi dùng hoặc sau một thời gian | Mở lại lời mời cài Agent trên trang chi tiết máy chủ để lấy lệnh với token mới |
Cài lại hoặc gỡ Agent
- Cài lại: vào trang chi tiết máy chủ và chọn cài lại Agent — phù hợp khi Agent gặp lỗi hoặc cần cập nhật.
- Gỡ Agent: sau khi gỡ, máy chủ sẽ ngừng gửi dữ liệu giám sát nhưng vẫn dùng được kết nối SSH cơ bản.