Cài đặt MKController Agent trên MikroTik

Tóm tắt MKController Agent là ứng dụng máy tính nhỏ gọn giúp quét mạng nội bộ, phát hiện các thiết bị MikroTik và cho phép quý vị tiếp nhận chúng vào MKController chỉ với một cú nhấp chuột — thay thế cho việc thực thi script thủ công khi triển khai tại chỗ. Hướng dẫn này giải thích agent làm gì, cách cài đặt trên Windows, macOS và Linux, cũng như cách xử lý thông báo chứng chỉ xuất hiện trong quá trình cài đặt.

MKController Agent là gì?

MKController Agent là trợ lý máy tính nhẹ, đóng vai trò cầu nối giữa mạng nội bộ của quý vị và nền tảng đám mây MKController. Ứng dụng chạy trên máy tính của quý vị, quét LAN để tìm các thiết bị MikroTik tương thích và hiển thị chúng trong luồng tiếp nhận của nền tảng với nút Adopt chỉ cần một nhấp chuột — thay thế cho việc sao chép và thực thi script tiếp nhận thủ công trên từng thiết bị.

Với những nhóm quen thuộc với UniFi Device Discovery Tool hay các công cụ hỗ trợ tương tự của nhà cung cấp, quy trình làm việc hoàn toàn có thể so sánh được: tiến trình cục bộ xử lý việc phát hiện, còn nền tảng đám mây xử lý việc quản lý.

Điểm khác biệt quan trọng: phát hiện và tiếp nhận là hai hành động riêng biệt. Agent xác định các thiết bị đủ điều kiện và hiển thị chúng cho quý vị — agent không tự động tiếp nhận hay sửa đổi bất cứ điều gì. Mọi thao tác tiếp nhận đều yêu cầu xác nhận rõ ràng từ quý vị.

Khi nào nên dùng Agent so với phương pháp thủ công?

Tình huống	Phương pháp khuyến nghị
Triển khai lần đầu tại địa điểm mới với nhiều thiết bị	Agent — phát hiện tất cả thiết bị tương thích cùng một lúc
Tiếp nhận từ xa thiết bị đã trực tuyến	Script thủ công qua WebFig, Winbox hoặc SSH
Chuẩn bị trong phòng lab trước khi giao cho khách hàng	Agent
Một thiết bị duy nhất, kỹ thuật viên đã có quyền truy cập CLI	Script thủ công
Các lần ghé thăm địa điểm khách hàng định kỳ	Agent giúp đẩy nhanh quá trình onboarding lặp lại

Agent xuất hiện ở đâu trong MKController?

Với tài khoản mới chưa có thiết bị, MKController nêu bật hai lộ trình onboarding: cài đặt agent hoặc sử dụng script thủ công.

MKController device list page showing the Adoption Assistant button and the manual script option for first-time users

Với các tài khoản đã có thiết bị, menu Add Device bao gồm tùy chọn Adoption Assistant.

MKController Add Device menu showing the Adoption Assistant option for adding new devices to an existing account

Chỉ báo trạng thái ở góc dưới bên trái của nền tảng hiển thị trạng thái agent là Bật (xanh lá), Đang chờ hoặc Tắt — để quý vị luôn biết trợ lý máy tính có sẵn sàng quét không.

Cách cài đặt và kết nối Agent?

Quy trình cài đặt gồm ba bước: tải xuống, ghép nối, xác nhận.

MKController guided agent installation screen showing the three steps: download, copy code, and wait for connection

Nhấp Download Agent trong MKController.
Chạy trình cài đặt đã tải xuống trên máy tính của quý vị.
Sao chép mã ghép nối hiển thị trên nền tảng.
Dán mã đó vào ứng dụng máy tính.
Chờ nền tảng xác nhận kết nối — không cần cấu hình thủ công.

MKController desktop agent asking for the security code to bind the local agent to the MKController account

Sau khi nhập mã, kết nối được thiết lập tự động. Không cần quy tắc phát hiện, không cần lệnh terminal, không cần ngoại lệ tường lửa.

MKController desktop agent running and signed in, showing the logged-in user on the local computer

Tại sao hệ điều hành hiển thị cảnh báo chứng chỉ?

Chứng chỉ của MKController hiện đang trong quá trình phê duyệt. Trong giai đoạn này, Windows, macOS và Linux có thể hiển thị thông báo bảo mật khi quý vị chạy trình cài đặt. Đây là hành vi bình thường đối với phần mềm mới phát hành đang chờ phê duyệt chứng chỉ — không có nghĩa là agent không an toàn.

Windows: Nếu hệ thống hiển thị cảnh báo ứng dụng được bảo vệ, hãy nhấp More info và cho phép cài đặt. Môi trường doanh nghiệp có thể cần quản trị viên IT phê duyệt một lần.

macOS: Nếu macOS chặn trình cài đặt, hãy vào System Settings → Privacy & Security, cuộn xuống và phê duyệt ứng dụng bị chặn. Sau đó chạy lại trình cài đặt.

Linux: Đảm bảo tệp đã tải xuống có quyền thực thi. Trong môi trường bị hạn chế, quản trị viên của quý vị có thể cần phê duyệt nguồn gói.

Cách xác nhận Agent đang trực tuyến?

Khi agent được cài đặt và đang chạy, MKController hiển thị trạng thái Bật màu xanh lá ở góc dưới bên trái của nền tảng.

MKController dashboard with agent status shown as On in green, confirming the desktop helper is connected

Tại thời điểm này, Adoption Assistant có thể quét mạng và liệt kê các thiết bị có thể phát hiện.

Cách quét và tiếp nhận thiết bị?

Khi agent trực tuyến, MKController quét mạng nội bộ và liệt kê các thiết bị tương thích với nút Adopt bên cạnh từng thiết bị.

MKController Adoption Assistant scanning the network and listing discovered devices with Ignore and Adopt buttons

Một vài lưu ý thực tế:

Quá trình quét tiếp cận các thiết bị trên mạng mà máy tính của agent đang chạy.
Các thiết bị phải có thể truy cập được trên đoạn mạng đó.
Vẫn cần kết nối internet vì quy trình tiếp nhận được điều phối bởi nền tảng MKController.

Sau khi tiếp nhận, thiết bị có thể được chuyển đến bất kỳ mạng nào có kết nối internet và vẫn có thể quản lý qua MKController.

Điều gì xảy ra khi Agent ngoại tuyến?

Nếu trợ lý máy tính ngừng chạy hoặc mất kết nối internet, MKController hiển thị trạng thái ngoại tuyến và cung cấp lộ trình khôi phục.

MKController platform showing the agent as offline with a button to open agent setup

Desktop Agent Disconnected screen with Test Agent and Configure Agent Again options

Các bước khôi phục:

Mở lại ứng dụng máy tính nếu đã đóng.
Xác minh máy tính có kết nối internet.
Sử dụng Test Agent hoặc Configure Agent Again nếu được nhắc.
Quay lại MKController và chờ chỉ báo trạng thái chuyển sang màu xanh lá.

Cần hỗ trợ về cài đặt? Liên hệ đội ngũ của chúng tôi qua WhatsApp — chúng tôi sẵn sàng hướng dẫn quý vị qua bất kỳ vấn đề cụ thể nào theo hệ điều hành.