Что такое LAN agent и когда использовать

Кратко: LAN-агент - это небольшая программа, которую вы устанавливаете на любой компьютер во внутренней сети клиента. Через интернет он подключается к ePulz.io, запрашивает список адресов, которые должен проверять, локально проверяет их и отправляет результаты обратно. Благодаря этому вы можете мониторить даже устройства, до которых облачный мониторинг не дотягивается (NAS, камеры, внутренние серверы, локальные веб-приложения).

Когда нужен LAN-агент

Мониторинг NAS и домашних или корпоративных серверов - Synology, QNAP, собственная машина с хранилищем ZFS
IP-камеры, системы контроля доступа, сигнализация в магазине или офисе
Внутренние веб-приложения - Grafana, Jira, GitLab, Bookstack за firewall
Сетевая инфраструктура - роутер, коммутаторы, точки доступа (AP), VPN-шлюз
IoT-устройства и шлюзы - шлюзы Modbus и MQTT и подобное
MSP-сценарий - управление мониторингом для нескольких клиентов с единым развёртыванием

Как это работает

В dashboard вы создаёте агента и получаете token (уникальный ключ) epulzio_… - он показывается только один раз.
Команду установки вы запускаете на устройстве в сети клиента (Raspberry Pi, mini PC, NAS, компьютер с Docker).
Каждые 30 секунд агент запрашивает у ePulz.io новые задачи и выполняет локальные проверки.
Результаты он отправляет обратно через HTTPS - то же защищённое соединение, которое использует каждый браузер.
Когда состояние устройства меняется, ePulz.io запускает стандартное уведомление (e-mail, Telegram, webhook).

Важное замечание о безопасности: Вся коммуникация идёт только наружу из вашей сети (исходящий HTTPS на порт 443). Вам никогда не нужны проброс порта на роутере, статический публичный IP или VPN-туннель. С точки зрения IT-безопасности компании клиента это обычно так же приемлемо, как открыть Gmail.

Что агент отправляет (и чего никогда)

Агент отправляет ровно три вещи:

Heartbeat - версия агента, hostname и название операционной системы
Результаты проверок, которые вы сами настроили - статус up/down, время отклика в ms и возможное сообщение об ошибке
Больше ничего. Он никогда не сканирует сеть, не читает файлы, не собирает трафик или данные устройств. Каждый отдельный IP-адрес, к которому он обращается, задаёте вы сами в dashboard.

Ограниченный token: token агента позволяет только скачать собственный список проверок и отправить результаты. У него нет доступа к вашему аккаунту, биллингу или другим мониторам, и вы можете в любой момент отозвать его в dashboard (Revoke).
Работает без прав root: служба работает от имени непривилегированного системного пользователя с sandbox systemd (NoNewPrivileges, ProtectSystem=strict). Root нужен только во время установки.
Полностью открыт для аудита: весь агент - это один Python-файл (~600 строк, только стандартная библиотека) - перед запуском вы можете прочитать каждую строку.

Три типа LAN-проверок

Тип	Цель	Что обнаруживает
lan_ping	192.168.1.10	Устройство отвечает на ICMP (простой сетевой тест). Самая дешёвая проверка.
lan_tcp	10.0.0.50:5432	Конкретный порт открыт. Даже если устройство работает, сама служба (база данных, SSH и подобное) может быть недоступна.
lan_http	http://nas.local	HTTP- или HTTPS-приложение отвечает корректно (коды 2xx/3xx). Подходит для интерфейса NAS или внутреннего dashboard.

Список LAN-агентов в dashboard ePulz.io — Список LAN-агентов - статус, последний контакт и версия каждого агента

Что произойдёт, когда агент перестанет работать

ePulz.io каждую минуту проверяет, отправляют ли агенты сигнал жизни (heartbeat). Если агент не выходит на связь более 5 минут, вы получите и e-mail, и сообщение в Telegram: "LAN-агент X офлайн". Когда агент вернётся, вы получите подтверждение о возврате в онлайн. Благодаря этому у вас не возникнет ложного ощущения, что всё работает, только потому что агент перестал отправлять данные.

Начните

На следующем шаге мы покажем вам установку агента и создание первого LAN-монитора.

Следующий шаг:

Установка LAN-агента на устройство в сети клиента.

Установить агента ->