Instalacja agenta MKController na MikroTik
Podsumowanie Agent MKController to niewielka aplikacja desktopowa, która skanuje sieć lokalną, wykrywa urządzenia MikroTik i umożliwia ich adoptowanie w MKController jednym kliknięciem — bez ręcznego wykonywania skryptów przy wdrożeniach na miejscu. Ten przewodnik wyjaśnia, czym jest agent, jak go zainstalować w systemach Windows, macOS i Linux oraz jak postępować z ostrzeżeniem o certyfikacie pojawiającym się podczas instalacji.
Czym jest agent MKController?
Agent MKController to lekka aplikacja desktopowa łącząca sieć lokalną z platformą chmurową MKController. Działa na komputerze użytkownika, skanuje sieć LAN w poszukiwaniu zgodnych urządzeń MikroTik i prezentuje je w przepływie adopcji platformy z przyciskiem Adoptuj — bez konieczności ręcznego kopiowania i uruchamiania skryptów adopcji na każdym urządzeniu.
Dla zespołów znających UniFi Device Discovery Tool lub podobne narzędzia dostawców, przepływ pracy jest bezpośrednio porównywalny: lokalny proces obsługuje wykrywanie, a platforma chmurowa — zarządzanie.
Kluczowe rozróżnienie: wykrywanie i adopcja to odrębne działania. Agent lokalizuje kwalifikujące się urządzenia i przedstawia je użytkownikowi — nie adoptuje ani nie modyfikuje niczego automatycznie. Każda adopcja wymaga wyraźnego potwierdzenia.
Kiedy używać agenta, a kiedy metody ręcznej?
| Scenariusz | Zalecana metoda |
|---|---|
| Pierwsze wdrożenie w nowej lokalizacji z wieloma urządzeniami | Agent — wykrywa wszystkie zgodne urządzenia naraz |
| Zdalna adopcja urządzenia już podłączonego do sieci | Ręczny skrypt przez WebFig, Winbox lub SSH |
| Staging laboratoryjny przed wysyłką do klienta | Agent |
| Jedno urządzenie, technik ma już dostęp do CLI | Ręczny skrypt |
| Cykliczne wizyty serwisowe u klienta | Agent przyspiesza powtarzający się onboarding |
Gdzie agent pojawia się w MKController?
Na nowym koncie bez urządzeń MKController wyróżnia dwie ścieżki onboardingu: zainstaluj agenta lub skorzystaj z ręcznego skryptu.
Na kontach z już dodanymi urządzeniami menu Dodaj urządzenie zawiera opcję Asystenta adopcji.
Wskaźnik stanu w lewym dolnym rogu platformy informuje, czy agent jest Włączony (zielony), Oczekujący lub Wyłączony — dzięki czemu zawsze wiadomo, czy aplikacja desktopowa jest gotowa do skanowania.
Jak zainstalować i połączyć agenta?
Instalacja przebiega w trzech krokach: pobierz, sparuj, potwierdź.
- Kliknij Pobierz agenta w MKController.
- Uruchom pobrany instalator na swoim komputerze.
- Skopiuj kod parowania wyświetlony na platformie.
- Wklej ten kod do aplikacji desktopowej.
- Poczekaj na potwierdzenie połączenia przez platformę — żadna ręczna konfiguracja nie jest wymagana.
Po wprowadzeniu kodu połączenie jest nawiązywane automatycznie. Żadnych reguł wykrywania, poleceń terminala ani wyjątków zapory sieciowej.
Dlaczego system operacyjny wyświetla ostrzeżenie o certyfikacie?
Certyfikaty MKController są aktualnie w procesie zatwierdzania. W tym okresie systemy Windows, macOS i Linux mogą wyświetlać monit bezpieczeństwa podczas uruchamiania instalatora. Jest to oczekiwane zachowanie w przypadku nowo dystrybuowanego oprogramowania oczekującego na zatwierdzenie certyfikatu — nie świadczy o tym, że agent jest niebezpieczny.
Windows: Jeśli system wyświetli ostrzeżenie o chronionej aplikacji, kliknij Więcej informacji i zezwól na instalację. W środowiskach korporacyjnych może być wymagane jednorazowe zatwierdzenie przez administratora IT.
macOS: Jeśli macOS zablokuje instalator, przejdź do Ustawienia systemowe → Prywatność i bezpieczeństwo, przewiń w dół i zatwierdź zablokowaną aplikację. Następnie uruchom instalator ponownie.
Linux: Upewnij się, że pobrany plik ma uprawnienia do wykonania. W środowiskach o ograniczonym dostępie administrator może wymagać zatwierdzenia źródła pakietu.
Jak potwierdzić, że agent jest online?
Gdy agent jest zainstalowany i uruchomiony, MKController wyświetla jego status jako Włączony na zielono w lewym dolnym rogu platformy.
W tym momencie Asystent adopcji może przeskanować sieć i wyświetlić wykrywalne urządzenia.
Jak skanować i adoptować urządzenia?
Gdy agent jest online, MKController skanuje sieć lokalną i wyświetla zgodne urządzenia z przyciskiem Adoptuj obok każdego z nich.
Kilka praktycznych uwag:
- Skanowanie obejmuje urządzenia w sieci, w której działa komputer agenta.
- Urządzenia muszą być dostępne w tym segmencie sieci.
- Połączenie z Internetem jest nadal wymagane, ponieważ przepływ adopcji jest koordynowany przez platformę MKController.
Po adopcji urządzenia można fizycznie przenieść do dowolnej sieci z dostępem do Internetu i zarządzać nimi przez MKController.
Co się dzieje, gdy agent przechodzi w tryb offline?
Jeśli aplikacja desktopowa przestanie działać lub utraci dostęp do Internetu, MKController wyświetla jej status jako offline i udostępnia ścieżkę odzyskiwania.
Kroki odzyskiwania:
- Ponownie otwórz aplikację desktopową, jeśli była zamknięta.
- Sprawdź, czy komputer ma dostęp do Internetu.
- Użyj opcji Testuj agenta lub Skonfiguruj agenta ponownie, jeśli zostaniesz o to poproszony.
- Wróć do MKController i poczekaj, aż wskaźnik stanu zmieni kolor na zielony.
Potrzebujesz pomocy z instalacją? Skontaktuj się z naszym zespołem przez WhatsApp — możemy przeprowadzić Cię przez każdy problem specyficzny dla danego systemu operacyjnego.