Inštalácia agenta (systemd / Docker)

LAN agent je malý Python proces, ktorý beží na vašom Linux zariadení vo vnútornej sieti a kontroluje služby, ku ktorým sa z internetu nedá dostať (interné DNS, intranet, ERP, NAS, tlačiarne). Komunikuje smerom von cez HTTPS, takže nepotrebuje žiadne otvorené porty smerom dovnútra siete.

V skratke: Vytvorte agenta v dashboarde, skopírujte si token a spustite jeden inštalačný príkaz na cieľovom zariadení. Celý proces zaberie 2 až 3 minúty.

Čo budete potrebovať

Akýkoľvek Linux s root prístupom (Debian, Ubuntu, Raspberry Pi OS, Fedora, Alma/Rocky, Arch, openSUSE, Alpine)
Architektúra x86_64, aarch64 (Raspberry Pi 4/5), armv7l (Raspberry Pi 3) alebo armv6l (RPi Zero)
Odchádzajúce HTTPS spojenie na epulz.io (port 443)
Python 3.8 alebo novší (ak chýba, inštalátor ho doinštaluje z balíčkového manažéra)

Agent zaberá približne 20 MB RAM a v pokojnom stave menej ako 1 % CPU. Funguje aj v LXC kontajneri, vo virtuálnom stroji (Proxmox, VMware) alebo v Docker kontajneri. Okrem systemd podporuje aj OpenRC (Alpine).

Plne auditovateľný: celý agent je jediný Python súbor (~600 riadkov, iba štandardná knižnica) a inštalátor je verejný skript. Pred spustením si môžete prečítať každý riadok: epulzio-agent.py a install-agent.sh.

1. Vytvorte agenta a skopírujte token

Otvorte Dashboard - LAN agenti.
Zadajte zrozumiteľný názov (napríklad "Serverovňa Bratislava" alebo "RPi v predajni") a kliknite na + Vytvoriť agenta.
Dashboard zobrazí token agenta (epulzio_...) a hotové inštalačné príkazy na skopírovanie.

Token sa zobrazí iba raz. Skopírujte si ho hneď. Neposielajte ho verejne ani ho nepublikujte na GitHube. Ak ho stratíte alebo unikne, agenta v dashboarde zrušte (Revoke) a vytvorte si nového.

2. Spustite inštalačný príkaz

Na cieľovom zariadení v termináli (token nahraďte svojím):

curl -fsSL https://epulz.io/install-agent.sh | sudo bash -s epulzio_VAS_TOKEN

Opatrnejší postup (odporúčame pri prvej inštalácii): skript si najprv stiahnite a prečítajte:

curl -fsSL https://epulz.io/install-agent.sh -o install-agent.sh
less install-agent.sh        # prečítajte si, čo robí (1 min)
sudo bash install-agent.sh epulzio_VAS_TOKEN

Inštalátor automaticky:

Rozpozná architektúru a distribúciu (apt / dnf / apk / pacman / zypper)
Overí prítomnosť Pythonu 3.8+ a nástroja ping, v prípade potreby ich doinštaluje
Otestuje spojenie na epulz.io
Stiahne agenta do /opt/epulzio-agent/
Vytvorí službu epulzio-agent (systemd, na Alpine OpenRC) a spustí ju
Zapne automatický štart pri reštarte systému

Celá inštalácia trvá približne 30 sekúnd.

3. Overte, že agent beží

Stav služby na zariadení:

sudo systemctl status epulzio-agent

Mali by ste vidieť active (running).

Zoznam LAN agentov so stavom online v dashboarde ePulz.io — Dashboard - LAN agenti: stav, posledný kontakt a verzia agenta

V Dashboard - LAN agenti sa do 30 sekúnd objaví stav:

online - posledný signál života (heartbeat) prišiel pred menej ako 2 minútami
časová značka - posledný heartbeat pred 2 až 10 minútami
offline - posledný heartbeat starší ako 10 minút (upozornenie príde už po 5 minútach ticha)

Varianta cez Docker

Ak nemáte systemd (TrueNAS, Synology, Unraid, k3s) alebo uprednostníte kontajner, použite príkaz z dashboardu:

docker run -d --name epulzio-agent --restart unless-stopped \
  --network host \
  -e EPULZIO_AGENT_TOKEN=epulzio_VAS_TOKEN \
  python:3.12-alpine sh -c "apk add -q --no-cache iputils && wget -qO /agent.py https://epulz.io/static/agent/epulzio-agent.py && python /agent.py"

Prepínač --network host je dôležitý - agent musí vidieť vašu LAN sieť, nie iba interný Docker bridge. Pri každom reštarte kontajnera sa stiahne aktuálna verzia agenta.

macOS a Windows

Pre macOS (10.15+, Intel aj Apple Silicon):

curl -fsSL https://epulz.io/install-agent-macos.sh -o install-agent-macos.sh
sudo bash install-agent-macos.sh epulzio_VAS_TOKEN

Pre Windows (10+ / Server 2016+, PowerShell ako správca):

Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process -Force
$env:EPULZIO_AGENT_TOKEN="epulzio_VAS_TOKEN"; iwr -useb https://epulz.io/install-agent.ps1 | iex

Riešenie problémov

Inštalátor hlási "Missing agent token"

Príkazu chýba token. Spustite ho s tokenom na konci: ... | sudo bash -s epulzio_VAS_TOKEN.

Inštalátor hlási "must run as root"

Spustite ho cez sudo, root je potrebný iba na inštaláciu (systemd služba, zápis do /opt).

"Cannot reach epulz.io"

Zariadenie nemá odchádzajúce HTTPS spojenie. Otestujte ručne curl https://epulz.io/health. Ak to zlyhá, skontrolujte firewall, DNS a NAT.

"Python 3.8+ required"

Veľmi starý systém. Aktualizujte distribúciu alebo doinštalujte novší Python (na Debiane napríklad apt install python3.9 z backports).

"Neither systemd nor OpenRC detected"

Systém bez podporovaného init systému. Použite Docker variantu vyššie.

Agent zostáva v dashboarde offline aj po 2 minútach

Pozrite logy: sudo journalctl -u epulzio-agent -n 50.
Najčastejšie príčiny: nesprávne vložený token (skontrolujte, že sa skopíroval celý vrátane prefixu epulzio_), HTTPS blokovaný na firewalle alebo nesprávny systémový čas (skontrolujte ho príkazom date - overenie SSL certifikátu vyžaduje správny čas).

Aktualizácia agenta

Spustite ten istý inštalačný príkaz znova s rovnakým tokenom. Inštalátor prepíše súbory v /opt/epulzio-agent/ a reštartuje službu, token zostáva platný.

Odinštalovanie

sudo systemctl stop epulzio-agent
sudo systemctl disable epulzio-agent
sudo rm -rf /opt/epulzio-agent /etc/systemd/system/epulzio-agent.service
sudo systemctl daemon-reload

V dashboarde agenta dodatočne označte ako Revoked, aby ste zneplatnili jeho token.

Ďalší krok

Vytvorenie prvého LAN monitora (ping, TCP, HTTP).

Prvý LAN monitor