👋 Привет, сетевой друг!

Сегодня поговорим об инструменте netbox-nmap-scan

🟣netbox‑nmap‑scan пробегает по активным префиксам в вашем NetBox, выполняет nmap-проходы и автоматически добавляет/обновляет записи об активных IP (и помечает их тегом autoscan). Топ, если хочется, чтобы база в NetBox отражала реальное состояние сети без ручного ручейка CSV-файлов.

🟣А как он вообще работает: Скрипт читает префиксы из NetBox API → генерирует цели → запускает nmap для каждого префикса → парсит результаты → синхронизирует IP-адреса в NetBox (создаёт, обновляет, проставляет метку времени последнего скана при наличии поля).

🟣Быстрый старт (локально): Клонируете репо и ставите зависимости:

git clone https://github.com/LoH-lu/netbox-nmap-scan.git
cd netbox-nmap-scan
python -m pip install -r requirements.txt

🟣Потом настраиваете ENV / konfig (NetBox URL + API token) и запускаете скан одного префикса:

python main.py --prefix 10.0.0.0/24

Или полная синхронизация всех активных префиксов из NetBox:

python main.py

🟣Через Docker: В репозитории есть Dockerfile — удобно запускать в контейнере на CI или отдельном хосте:

docker build -t netbox-nmap-scan .
docker run --env NETBOX_URL=... --env NETBOX_TOKEN=... netbox-nmap-scan

🟣Полезные фичи и настройки:
• Тег autoscan — пометка адресов, добавленных скриптом.
• Тег Disable Automatic Scanning — если добавите его к префиксу, скрипт его пропустит.
• Опция DNS-резолва (включаемая/выключаемая) — экономит время при больших сетях.
• Поддержка кастомного поля «last_scan» для каждой IP записи — удобно для отчётности.

Серверная Админа | #Инструмент