Agent telepítés (systemd / Docker) | Súgó és útmutatók ePulz.io

A LAN-ügynök egy kis Python-folyamat, amely a belső hálózatban lévő Linux-eszközén fut, és olyan szolgáltatásokat ellenőriz, amelyek az internetről nem érhetők el (belső DNS, intranet, ERP, NAS, nyomtatók). Kifelé HTTPS-en keresztül kommunikál, így a hálózat felé semmilyen nyitott portra nincs szüksége.

Röviden: Hozzon létre egy ügynököt az irányítópulton, másolja ki a tokent, és futtasson egyetlen telepítési parancsot a célgépen. Az egész folyamat 2-3 percet vesz igénybe.

Mire lesz szüksége

Bármilyen Linux root hozzáféréssel (Debian, Ubuntu, Raspberry Pi OS, Fedora, Alma/Rocky, Arch, openSUSE, Alpine)
x86_64, aarch64 (Raspberry Pi 4/5), armv7l (Raspberry Pi 3) vagy armv6l (RPi Zero) architektúra
Kimenő HTTPS-kapcsolat az epulz.io felé (443-as port)
Python 3.8 vagy újabb (ha hiányzik, a telepítő a csomagkezelőből telepíti)

Az ügynök körülbelül 20 MB RAM-ot és nyugalmi állapotban kevesebb mint 1 % CPU-t használ. Működik LXC konténerben, virtuális gépen (Proxmox, VMware) vagy Docker konténerben is. A systemd mellett az OpenRC-t (Alpine) is támogatja.

Teljesen auditálható: az egész ügynök egyetlen Python-fájl (~600 sor, csak a standard könyvtár), a telepítő pedig nyilvános szkript. Futtatás előtt minden sort elolvashat: epulzio-agent.py és install-agent.sh.

1. Hozzon létre egy ügynököt és másolja ki a tokent

Nyissa meg az Irányítópult - LAN-ügynökök menüt.
Adjon meg egy érthető nevet (például "Budapest szerverszoba" vagy "RPi az üzletben"), majd kattintson az + Ügynök létrehozása gombra.
Az irányítópult megjeleníti az ügynök tokenjét (epulzio_...) és a kész, másolható telepítési parancsokat.

A token csak egyszer jelenik meg. Másolja ki azonnal. Ne ossza meg nyilvánosan és ne tegye közzé a GitHubon. Ha elveszíti vagy kiszivárog, vonja vissza az ügynököt az irányítópulton (Revoke), és hozzon létre egy újat.

2. Futtassa a telepítési parancsot

A célgépen a terminálban (a tokent cserélje a sajátjára):

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

Óvatosabb módszer (első telepítéskor ajánljuk): először töltse le a szkriptet és olvassa el:

curl -fsSL https://epulz.io/install-agent.sh -o install-agent.sh
less install-agent.sh        # olvassa el, mit csinál (1 perc)
sudo bash install-agent.sh epulzio_AZ_ON_TOKENJE

A telepítő automatikusan:

Felismeri az architektúrát és a disztribúciót (apt / dnf / apk / pacman / zypper)
Ellenőrzi a Python 3.8+ és a ping eszköz meglétét, szükség esetén telepíti azokat
Teszteli a kapcsolatot az epulz.io felé
Letölti az ügynököt a /opt/epulzio-agent/ könyvtárba
Létrehozza az epulzio-agent szolgáltatást (systemd, Alpine alatt OpenRC) és elindítja
Bekapcsolja az automatikus indítást a rendszer újraindításakor

A teljes telepítés körülbelül 30 másodpercig tart.

3. Ellenőrizze, hogy az ügynök fut

A szolgáltatás állapota az eszközön:

sudo systemctl status epulzio-agent

Az active (running) állapotot kell látnia.

A LAN-ügynökök listája online állapottal az ePulz.io irányítópultján — Irányítópult - LAN-ügynökök: állapot, utolsó kapcsolat és az ügynök verziója

Az Irányítópult - LAN-ügynökök menüben 30 másodpercen belül megjelenik az állapot:

online - az utolsó életjel (heartbeat) kevesebb mint 2 perce érkezett
időbélyeg - az utolsó heartbeat 2-10 perce volt
offline - az utolsó heartbeat 10 percnél régebbi (a figyelmeztetés már 5 perc csend után megérkezik)

Docker változat

Ha nincs systemd (TrueNAS, Synology, Unraid, k3s), vagy konténert részesít előnyben, használja az irányítópulton található parancsot:

docker run -d --name epulzio-agent --restart unless-stopped \
  --network host \
  -e EPULZIO_AGENT_TOKEN=epulzio_AZ_ON_TOKENJE \
  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"

A --network host kapcsoló fontos - az ügynöknek látnia kell a LAN-hálózatát, nem csak a belső Docker bridge-et. A konténer minden újraindításakor letöltődik az ügynök aktuális verziója.

macOS és Windows

macOS esetén (10.15+, Intel és Apple Silicon):

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

Windows esetén (10+ / Server 2016+, PowerShell rendszergazdaként):

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

Hibaelhárítás

A telepítő "Missing agent token" hibát jelez

A parancsból hiányzik a token. Futtassa a tokennel a végén: ... | sudo bash -s epulzio_AZ_ON_TOKENJE.

A telepítő "must run as root" hibát jelez

Futtassa sudo használatával; a root csak a telepítéshez szükséges (systemd szolgáltatás, írás a /opt könyvtárba).

"Cannot reach epulz.io"

Az eszköznek nincs kimenő HTTPS-kapcsolata. Tesztelje kézzel a curl https://epulz.io/health paranccsal. Ha ez sikertelen, ellenőrizze a tűzfalat, a DNS-t és a NAT-ot.

"Python 3.8+ required"

Nagyon régi rendszer. Frissítse a disztribúciót, vagy telepítsen újabb Pythont (Debianon például apt install python3.9 a backports tárolóból).

"Neither systemd nor OpenRC detected"

Támogatott init rendszer nélküli rendszer. Használja a fenti Docker változatot.

Az ügynök 2 perc után is offline marad az irányítópulton

Nézze meg a naplókat: sudo journalctl -u epulzio-agent -n 50.
Leggyakoribb okok: helytelenül beillesztett token (ellenőrizze, hogy a teljes token átmásolódott-e, beleértve az epulzio_ előtagot), a tűzfalon blokkolt HTTPS, vagy helytelen rendszeridő (ellenőrizze a date paranccsal - az SSL-tanúsítvány ellenőrzéséhez pontos idő szükséges).

Az ügynök frissítése

Futtassa ugyanazt a telepítési parancsot újra ugyanazzal a tokennel. A telepítő felülírja a /opt/epulzio-agent/ könyvtárban lévő fájlokat és újraindítja a szolgáltatást, a token érvényes marad.

Eltávolítás

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

Az irányítópulton emellett jelölje meg az ügynököt Revoked állapotúként, hogy érvénytelenítse a tokenjét.

Következő lépés

Az első LAN-monitor létrehozása (ping, TCP, HTTP).

Első LAN-monitor