NetAlertX — Фреймворк сетевой видимости и управления активами

📷 Нажмите для просмотра скриншотов

Посетите https://netalertx.com/ для просмотра ещё большего количества gif и скриншотов 📷.

NetAlertX — это платформа сетевой видимости и управления активами для домашних лабораторий, ИТ-команд, MSP и распределенных сред. Она обеспечивает централизованную сетевую видимость и непрерывное обнаружение активов на удаленных площадках, VLAN, филиалах и сегментированных сетях через единый интерфейс.

NetAlertX предоставляет вам источник достоверной информации о подключенных устройствах в реальном времени, помогает выявить теневой ИТ и несанкционированное оборудование, поддерживает инициативы по обеспечению соответствия требованиям и автоматизирует операционные рабочие процессы в распределенных средах клиентов.

Используйте NetAlertX для обнаружения теневого ИТ, несанкционированного оборудования, дрейфа IPAM и других изменений, важных для сервисных команд. Благодаря синхронизации нескольких площадок, отчетности, рабочим процессам и веб-хукам он помогает MSP опережать проблемы без издержек полноценного NMS или SIEM.

Содержание

• Быстрый старт
• Возможности
• Документация
• Безопасность и конфиденциальность
• Часто задаваемые вопросы
• Советы по устранению неполадок
• Всё остальное

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

[!WARNING] ⚠️ Важно: docker-compose недавно изменился. Внимательно прочитайте Руководство по миграции для получения подробных инструкций.

Запустите NetAlertX за секунды с Docker:

docker run -d \
  --network=host \
  --restart unless-stopped \
  -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

Примечание: Ваша директория /local_data_dir должна содержать папки config и db.

Чтобы развернуть контейнеризированный экземпляр непосредственно из исходного репозитория, выполните следующую последовательность BASH:

git clone https://github.com/netalertx/NetAlertX.git
cd NetAlertX
docker compose up --force-recreate --build
# Для настройки: отредактируйте docker-compose.yaml и снова выполните последнюю команду

Нужна помощь с настройкой? Ознакомьтесь с руководством по использованию или полной документацией.

Для пользователей Home Assistant: Нажмите здесь, чтобы добавить NetAlertX

Для других методов установки ознакомьтесь с документацией по установке

|| Руководство по Docker || Релизы || Документация || Плагины || Веб-сайт

Возможности

Обнаружение и аналитика активов

Непрерывный мониторинг для обнаружения несанкционированных активов, изменений состояния подключения и дрейфа управления IP-адресами (IPAM). Методы обнаружения и сканирования включают: arp-scan, Pi-hole — импорт БД, Pi-hole — импорт DHCP-лизингов, Импорт общих DHCP-лизингов, Импорт контроллера UNIFI, Импорт SNMP-маршрутизаторов. Полный список доступных плагинов см. в документации Плагины.

Шлюзы уведомлений

Отправляйте уведомления в более чем 80+ сервисов, включая Telegram через Apprise, или используйте собственные издатели Pushsafer, Pushover или NTFY.

Интеграции и плагины

Передавайте данные и изменения устройств в Home Assistant, читайте конечные точки API или используйте Веб-хуки для настройки собственных потоков автоматизации. Вы также можете создать собственные сканеры с помощью Системы плагинов всего за 15 минут.

Рабочие процессы

Модуль рабочих процессов автоматизирует ИТ-управление, обеспечивая соблюдение политик категоризации и очистки устройств. Нужно ли назначить вновь обнаруженные устройства конкретному сетевому узлу, автоматически сгруппировать устройства от определённого поставщика, разархивировать устройство при обнаружении в сети или автоматически удалить устройства — этот модуль предоставляет гибкость для настройки автоматизации под ваши нужды.

MSP и мониторинг нескольких площадок

NetAlertX обеспечивает централизованный мониторинг удаленных площадок и изолированных сред с помощью Синхронизируемых узлов для VLAN и филиалов, предоставляя единую видимость активов в нескольких сетях. Он поддерживает NOC-панели мониторинга, экспорт метрик Prometheus, автоматизацию рабочих процессов для управления устройствами и распределенное обнаружение с централизованным оповещением для масштабируемых сетевых операций.

Документация

Ознакомьтесь со всей документацией здесь или перейдите к конкретному варианту установки ниже.

Поддерживаемые браузеры: Chrome, Firefox

• [Установка] Docker
• [Установка] Home Assistant
• [Установка] Чистая установка
• [Установка] Приложение Unraid
• [Настройка] Использование и конфигурация
• [Разработка] Документация API
• [Разработка] Пользовательские плагины

Безопасность и конфиденциальность

NetAlertX сканирует вашу локальную сеть и может хранить метаданные о подключенных устройствах. По умолчанию все данные хранятся локально. Никакая информация не отправляется внешним службам, если вы явно не настроите уведомления или интеграции.

Соответствие требованиям и усиление защиты:

• Запускайте за обратным прокси с аутентификацией
• Используйте брандмауэры для ограничения доступа к веб-интерфейсу
• Регулярно обновляйтесь до последней версии для установки исправлений безопасности
• Управление доступом на основе ролей (RBAC) через обратный прокси: интегрируйтесь с существующим SSO/Identity провайдером для безопасного доступа к панели управления.

Подробнее см. в Рекомендациях по безопасности.

Разработано для MSP, NOC и распределенных сетей

NetAlertX поддерживает централизованный мониторинг через VLAN, филиалы, среды клиентов, изолированные сети и удаленные площадки.

С помощью Синхронизируемых узлов распределенные сборщики безопасно отправляют данные об инвентаризации устройств и сетевой видимости обратно в центральный узел, обеспечивая единый мониторинг, оповещение и отслеживание активов во всех местоположениях.

Это предоставляет MSP и NOC единую операционную панораму множества независимых сетей без необходимости прямого доступа или централизованной сканирующей инфраструктуры.

Типичные развертывания включают панели мониторинга MSP, NOC-панели, мониторинг инвентаризации на нескольких площадках и обнаружение удаленных офисов.

Часто задаваемые вопросы

В: Как мне отслеживать VLAN или удаленные подсети? О: Убедитесь, что контейнер имеет надлежащий сетевой доступ (например, используйте --network host на Linux). Также проверьте, что ваш метод сканирования правильно настроен в интерфейсе.

В: Какое развертывание рекомендуется для высокой доступности? О: Мы рекомендуем развертывание через Docker с постоянными монтированиями томов для целостности базы данных и запуск за обратным прокси для безопасного доступа.

В: Будет ли это отправлять какие-либо данные в интернет? О: Нет. Все сканирования и данные остаются локальными, если вы не настроите облачные уведомления.

В: Могу ли я использовать это без Docker? О: Вы можете установить приложение непосредственно на собственное оборудование, следуя руководству по чистой установке.

В: Где хранятся данные? О: В папках /data/config и /data/db. Регулярно делайте резервные копии этих папок.

Советы по устранению неполадок

• Некоторые сканеры (например, ARP) могут не обнаруживать устройства в других подсетях. См. Руководство по удаленным сетям для обходных путей.
• Сети только с Wi-Fi могут потребовать альтернативных сканеров для точного обнаружения.
• Для больших сетей может потребоваться ограничение уведомлений для предотвращения спама.
• В некоторых системах могут потребоваться повышенные разрешения (например, CAP_NET_RAW) для низкоуровневого сканирования.

Проверьте Issues на GitHub для получения последних отчетов об ошибках и решений, а также обратитесь к официальной документации.

Всё остальное

📧 Узнавайте о новинках

Узнавайте о новых релизах, новых функциях, которые вы можете использовать, и о критических изменениях.

🔀 Альтернативные приложения

• Fing — Приложение-сканер сети для безопасности вашего интернета (Коммерческое, Мобильное приложение, Проприетарное оборудование)
• NetBox — Золотой стандарт для Network Source of Truth (NSoT) и IPAM.
• Zabbix или Nagios — Основное внимание уделяется мониторингу инфраструктуры.
• Domotz — Коммерческая платформа сетевого мониторинга и удаленного управления, предназначенная для MSP, ИТ-команд и многосайтовых сред.
• NetAlertX — Упрощенный, ориентированный на обнаружение выбор для аналитики активов в реальном времени и оповещений без шума.

💙 Пожертвования

Спасибо всем, кто ценит этот инструмент и делает пожертвования.

Нажмите, чтобы узнать другие способы пожертвований

---

• Bitcoin: 1N8tupjeCK12qRVU2XrV17WvKK7LCawyZM
• Ethereum: 0x6e2749Cb42F4411bc98501406BdcD82244e3f9C7

📧 Пишите мне на [email protected] если хотите связаться или если мне следует добавить другие платформы для спонсорства.

🏗 Участники

Этот проект был бы невозможен без потрясающей работы сообщества, с особой благодарностью:

pucherot/Pi.Alert (оригинальный создатель PiAlert), leiweibau: Темный режим (и многое другое), Macleykun (Помощь с очисткой Dockerfile), vladaurosh за помощь с ребазингом на Alpine, Final-Hawk (Помощь с NTFY, стилизацией и другими исправлениями), TeroRERO (Испанские переводы), Data-Monkey (Разделение файла python.py и другое), cvc90 (Испанский перевод и различные работы с UI) и другие. Ознакомьтесь со всеми замечательными участниками.

🌍 Переводы

С гордостью используем Weblate. Помогите и предложите языки в онлайн-портале Weblate.

Лицензия

GPL 3.0 | Узнать больше здесь | Источник анимированного GIF (Анимация загрузки) | Источник шрифтов для самостоятельного хостинга

Все названия продуктов, логотипы и бренды являются собственностью соответствующих владельцев. Все названия компаний, продуктов и услуг, используемые на этом веб-сайте, предназначены только для целей идентификации. Использование этих названий, логотипов и брендов не подразумевает одобрения.