Instalacja agenta (systemd / Docker)

4 min czytania · Agenci LAN (sieć wewnętrzna)

W skrócie: Instalacja LAN agenta trwa trzy minuty. Albo jako usługa systemd (Linux + root), albo jako kontener Docker (Synology, Unraid, k3s). Agent potrzebuje wyłącznie wychodzącego HTTPS na epulz.io.

1. Utwórz agenta w dashboardzie

Otwórz Dashboard → LAN agenci.
Wpisz rozsądną nazwę (np. „Firma X - serwerownia", „Pi w sklepie Warszawa").
Naciśnij Utwórz agenta.
Pojawi się token w formacie plzag_… - skopiuj go natychmiast. Wyświetla się tylko raz; jeśli go zamkniesz bez skopiowania, będziesz musiał utworzyć nowego agenta.

2a. Wariant A - usługa systemd (Linux)

Dla Raspberry Pi, mini PC, serwera wirtualnego lub dowolnej maszyny Linux z dostępem root:

sudo bash <(curl -s https://epulz.io/install-agent.sh) plzag_TWOJ_TOKEN

Skrypt:

Zainstaluje Python 3 i binarkę ping (jeśli ich brakuje).
Pobierze agent.py do /opt/epulzio-agent.
Zapisze token do /opt/epulzio-agent/agent.env z uprawnieniami 0600.
Zarejestruje i uruchomi usługę systemd epulzio-agent.service.

Logi po instalacji: journalctl -u epulzio-agent -f

2b. Wariant B - Docker

Dla Synology / Unraid / k3s / TrueNAS / dowolnego Docker host:

[Docker image v príprave]

--network host jest kluczowe: agent potrzebuje dostępu do sieci lokalnej hosta, a nie tylko do wewnętrznej sieci Docker.

Gdzie najlepiej uruchomić agenta: Maszyna, która jest zawsze włączona i ma dobre połączenie sieciowe z urządzeniami, które chcesz monitorować. Klasyczne wybory: Raspberry Pi w sieci, mini PC w racku, host hypervisor, NAS. Jeden agent obsłuży setki monitorów.

3. Sprawdź w dashboardzie

W LAN agenci obok agenta wyświetli się status:

● online - agent wysyła heartbeat (kontakt młodszy niż 2 minuty)
znacznik czasu - kontakt w ostatnich 10 minutach
offline od … - kontakt starszy niż 10 minut (otrzymasz e-mail po 5 min)

Aktualizacja agenta

Dla wariantu systemd:

sudo curl -sfL https://epulz.io/static/agent/epulzio-agent.py -o /opt/epulzio-agent/agent.py
sudo systemctl restart epulzio-agent

Dla Docker: # Docker image v príprave - použite systemd inštaláciu nižšie


  Kolejny krok:
  Utworzenie pierwszego monitora LAN (ping, TCP, HTTP).
  Pierwszy monitor LAN →