Установка агента (systemd / Docker)

4 мин чтения · LAN агенты (внутр. сеть)

Кратко: Установка LAN-агента занимает три минуты. Либо как systemd-служба (Linux + root), либо как Docker-контейнер (Synology, Unraid, k3s). Агенту нужен только исходящий HTTPS на epulz.io.

1. Создайте агента в dashboard

Откройте 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 ключевой: агенту нужен доступ к локальной сети хоста, не только к Docker внутренней сети.

Где лучше всего запустить агента: Машина, которая всегда включена и имеет хорошее сетевое подключение к устройствам, которые хотите мониторить. Классический выбор: Raspberry Pi в сети, mini PC в стойке, hypervisor host, NAS. Один агент справится с сотнями мониторов.

3. Проверка в dashboard

В LAN-агенты рядом с агентом отображается status:

● online - агент отправляет 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-монитор →