netalertx/NetAlertX

Что это?

Ключевые возможности

• 01Непрерывное обнаружение устройств с помощью arp-scan, а также импорта данных из Pi-hole, DHCP lease, UniFi и маршрутизаторов с поддержкой SNMP
• 02Отслеживание новых устройств, изменений состояния подключения и расхождений IPAM
• 03Уведомления через Apprise (более 80 сервисов), Pushover, Pushsafer и NTFY
• 04Автоматическая категоризация и группировка устройств, возврат в активный список и удаление устройств с помощью рабочих процессов
• 05API, webhooks, интеграция с Home Assistant и экспорт метрик Prometheus

Сценарии использования

• Обнаружение неавторизованных устройств и устройств теневого IT в домашней или офисной сети
• Отслеживание изменений IP-адресов и ведение актуального реестра устройств
• Мониторинг нескольких сетей клиентов или филиалов с единой центральной панели
• Отправка уведомлений на телефон или в чат при подключении новых устройств к сети

Быстрый старт

1. 1

   Запустите NetAlertX с помощью Docker

   docker run -d --network=host --restart unless-stopped --cap-add=NET_RAW --cap-add=NET_ADMIN --cap-add=NET_BIND_SERVICE -v /local_data_dir:/data -v /etc/localtime:/etc/localtime:ro --tmpfs /tmp:uid=20211,gid=20211,mode=1700 -e PORT=20211 -e APP_CONF_OVERRIDE='{"GRAPHQL_PORT":"20214"}' ghcr.io/netalertx/netalertx:latest
2. 2

   Или клонируйте репозиторий с исходным кодом

   git clone https://github.com/netalertx/NetAlertX.git
3. 3

   Перейдите в каталог проекта и соберите его с помощью Docker Compose

   cd NetAlertX && docker compose up --force-recreate --build

Что важно знать

• !Для сканирования сети в Linux контейнеру нужны повышенные привилегии и доступ к сети хоста.
• !Некоторые сканеры, например ARP, могут не обнаруживать устройства в других подсетях.
• !В сетях, использующих только Wi-Fi, для точного обнаружения могут потребоваться другие сканеры.
• !При обновлении со старых версий необходимо следовать руководству по миграции.

В подборках

Темы

Частые вопросы

Что такое NetAlertX?

Self-hosted инструмент для контроля сети: постоянно обнаруживает устройства, отслеживает изменения и отправляет уведомления. NetAlertX — self-hosted платформа для отслеживания устройств, подключённых к одной или нескольким сетям. Она постоянно сканирует сети, находит новые и вновь появившиеся устройства, отслеживает изменения состояния подключения и расхождения в управлении IP-адресами (IPAM), а также ведёт единый реестр активов. Для обнаружения используются arp-scan, импорт данных из Pi-hole и DHCP lease, импорт из контроллера UniFi и маршрутизаторов с поддержкой SNMP. Система плагинов позволяет создавать собственные сканеры.

NetAlertX можно использовать бесплатно? Какая у него лицензия?

NetAlertX распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.

NetAlertX всё ещё поддерживается?

Активно поддерживается. Последний коммит в NetAlertX — 1 нояб. 2026 г..

Для чего можно использовать NetAlertX?

Обнаружение неавторизованных устройств и устройств теневого IT в домашней или офисной сети Отслеживание изменений IP-адресов и ведение актуального реестра устройств Мониторинг нескольких сетей клиентов или филиалов с единой центральной панели Отправка уведомлений на телефон или в чат при подключении новых устройств к сети

Как установить NetAlertX?

Запустите NetAlertX с помощью Docker: docker run -d --network=host --restart unless-stopped --cap-add=NET_RAW --cap-add=NET_ADMIN --cap-add=NET_BIND_SERVICE -v /local_data_dir:/data -v /etc/localtime:/etc/localtime:ro --tmpfs /tmp:uid=20211,gid=20211,mode=1700 -e PORT=20211 -e APP_CONF_OVERRIDE='{"GRAPHQL_PORT":"20214"}' ghcr.io/netalertx/netalertx:latest Или клонируйте репозиторий с исходным кодом: git clone https://github.com/netalertx/NetAlertX.git Перейдите в каталог проекта и соберите его с помощью Docker Compose: cd NetAlertX && docker compose up --force-recreate --build

Где скачать NetAlertX?

Исходный код и инструкции по установке — на GitHub: https://github.com/netalertx/NetAlertX