Встановлення агента (systemd / Docker)

4 хв читання · LAN агенти (внутр. мережа)

Стисло: Встановлення LAN агента триває три хвилини. Або як служба systemd (Linux + root), або як Docker контейнер (Synology, Unraid, k3s). Agent потребує лише вихідний HTTPS на epulz.io.

1. Створіть агента в дашборді

Відкрийте Dashboard → LAN агенти.
Введіть розумну назву (напр. "Фірма X - серверна", "Pi у магазині Братислава").
Натисніть Створити агента.
Відобразиться token у форматі plzag_… - скопіюйте його негайно. Відображається лише один раз; якщо закриєте без копіювання, доведеться створити нового агента.

2a. Варіант A - служба systemd (Linux)

Для Raspberry Pi, mini PC, віртуального сервера або будь-якої Linux машини з root доступом:

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

Скрипт:

Встановить Python 3 та бінарник ping (якщо відсутні).
Завантажить agent.py до /opt/epulzio-agent.
Запише token до /opt/epulzio-agent/agent.env з permissions 0600.
Зареєструє і запустить службу systemd epulzio-agent.service.

Логи після встановлення: journalctl -u epulzio-agent -f

2b. Варіант B - Docker

Для Synology / Unraid / k3s / TrueNAS / будь-якого Docker host:

[Docker image v príprave]

--network host є ключовим: agent потребує доступу до локальної мережі хоста, а не лише до внутрішньої мережі Docker.

Де найкраще запустити агента: Машина, яка завжди увімкнена і має гарне мережеве підключення до пристроїв, які бажаєте моніторити. Класичні варіанти: Raspberry Pi в мережі, mini PC у rack, hypervisor host, NAS. Один agent впорається із сотнями моніторів.

3. Перевірте в дашборді

У LAN агенти поруч з агентом відобразиться статус:

● online - agent надсилає heartbeat (контакт молодший за 2 хвилини)
часова мітка - контакт в останні 10 хвилин
offline від … - контакт старший за 10 хвилин (отримаєте email після 5 хв)

Оновлення агента

Для варіанта systemd:

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

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


  Наступний крок:
  Створення першого LAN монітора (ping, TCP, HTTP).
  Перший LAN монітор →