Обёртка на Python вокруг masscan и nmap для крупномасштабного обнаружения портов, обнаружения хостов, захвата баннеров и сканирования уязвимостей на основе NSE во внутренних или внешних сетях.
Этот скрипт является обёрткой для masscan и nmap. nmap отвечает за обнаружение хостов и (для небольших сканирований) обнаружение портов, получение баннеров сервисов и NSE-скрипты. Masscan используется для крупномасштабного обнаружения портов, где важна сырая скорость. Установите оба из вашего любимого менеджера пакетов или из исходников.
Требуется Python 3.8+ (requires-python в pyproject.toml; CI использует минимальную версию 3.8).
SpooNMAP можно запускать прямо из рабочей копии — шаг установки не требуется, см. раздел «Использование» ниже — или установить как отдельную команду с помощью uv:
uv tool install git+https://github.com/trustedsec/spoonmap
Это помещает исполняемый файл spoonmap в ваш PATH, так что вы можете вызывать его как
spoonmap из любого каталога вместо клонирования репозитория и запуска
./spoonmap.py. Пакета в PyPI нет — этот проект никогда не
публиковался на pypi.org, и команда выше устанавливает напрямую из
git-репозитория. Используйте полную форму git+https://..., приведённую выше, а не
просто uv tool install spoonmap; что бы это имя ни означало на PyPI, сейчас
или в будущем, это не данный проект.
Чтобы обновиться до последнего коммита:
uv tool upgrade spoonmap
Установка этим способом не делает SpooNMAP самодостаточным сканером:
masscan и nmap по-прежнему остаются отдельными системными инструментами, которые
необходимо устанавливать независимо (см. раздел «Зависимости» выше), точно так же, как при запуске из
рабочей копии — uv tool install упаковывает только собственный Python-код SpooNMAP и его
встроенные NSE-скрипты, но не внешние бинарники, которые он вызывает.
Единственное, что стоит понять перед установкой этим способом: Python-модуль установленного
spoonmap находится там, куда uv поместил своё управляемое окружение инструмента, — а не в
каталоге, где вы когда-либо стали бы искать конфигурационный файл или вывод сканирования. Это ровно тот сценарий, о котором
говорится в разделе «Где находятся файлы» ниже — прочитайте этот раздел, чтобы узнать, что разрешается относительно
вашего текущего каталога и почему; установка через uv tool install не
меняет правило, она лишь делает это правило значимым, поскольку не остаётся
каталога рабочей копии, к которому конфигурация или путь вывода могли бы откатиться по привычке.
Просто запустите скрипт, и он запросит у вас все необходимые параметры.
config.json, файлы целей/исключений и вывод сканирования разрешаются относительно
каталога, из которого вы запускаете команду — см. «Где находятся файлы» ниже, если
ваш вывод оказался не там, где вы ожидали, особенно если вы привыкли вызывать
SpooNMAP по пути извне его собственного каталога.
Если вы используете uv, вы можете запускать без отдельного виртуального окружения:
uv run spoonmap.py
Или вызовите напрямую, если скрипт является исполняемым:
# ./spoonmap.py
________ _____ _______ _________________
__ ___/______________________ | / /__ |/ /__ |__ __ \
_____ \___ __ \ __ \ __ \_ |/ /__ /|_/ /__ /| |_ /_/ /
____/ /__ /_/ / /_/ / /_/ / /| / _ / / / _ ___ | ____/
/____/ _ .___/\____/\____//_/ |_/ /_/ /_/ /_/ |_/_/
/_/
Service Categories (comma-separated numbers, default: All)
(1) Web [80, 443, 7001, 7002, 8000, 8080, 8081, 8443, 8888, 9090, 10443]
(2) Database [1433, U:1434, 1521, 3306, 5432, 6379, 9200, 27017]
(3) Remote Management [22, 23, 3389, 5900, 5901, 6129, 1723, 5985, 5986]
(4) Email [25, 110, 143, 465, 587, 993, 995]
(5) LDAP [389, 636]
(6) Network Infrastructure [53, 179, U:500, U:161, U:623, U:631, U:1194, 1194]
(7) File Transfer [21, 111]
(8) SMB [445, 135, 139, U:137]
(9) Specialized [1090, 3300, 4786, 6970, 2375, 4243, 9100, 8530, 8531]
(10) Containers & Debuggers [2377, 10250, 8001, 9229, 2345, 5005, 61616, 8009, 6000]
(11) Local LLM [11434, 1234, 7860, 5000, 5001, 1337, 3000, 8000, 8080]
(12) Search & Observability [9200, 9300, 5601]
(13) Full Port Scan [1-65535, TCP only — no UDP]
(c) Custom Port Scan [enter your own comma-separated ports]
(The Full Port Scan number increments automatically with the number of categories.)
**Full Port Scan is TCP only.** It sweeps TCP 1-65535 and runs no UDP discovery at
all, so every `U:` port listed in the categories above — SNMP (U:161), IKE (U:500),
IPMI (U:623), IPP (U:631), OpenVPN (U:1194), NetBIOS (U:137), SQL Browser (U:1434) —
is skipped, along with the NSE scripts and findings that depend on them. It is
*wider* than All on TCP and *narrower* on UDP. For both, run All and Full as two
passes, or use the Custom option with the UDP ports appended
(e.g. `1-65535,U:161,U:500,U:623`).
Which categories would you like to scan (e.g. 1,3 — default: All)?
Would you like to enumerate service banners for any identified services (default: Yes)?
Would you like to run NSE security scripts on identified services (default: No)?
Target Scan
(1) External
(2) Internal
Is this an internal or external scan (default: External)?
How fast would you like to scan (default: 20000 packets/second)?
Please enter the full path for the file containing target hosts (default: /opt/spoonmap/ranges.txt):
Would you like to exclude any hosts? (default: No)
Run host discovery before port scanning (default: Yes)?
Tune advanced settings (nmap threads, masscan batch size, nmap work-unit threshold)? (default: No)
Вы также можете создать файл config.json (на основе config.json.sample), чтобы пропустить все запросы:
{
"scan_categories": ["Web", "Database", "Remote Management"],
"banner_scan": "True",
"script_scan": "False",
"host_discovery": "True",
"target_scan": "Internal",
"max_rate": "2000",
"target_file": "ranges.txt",
"output_path": "./",
"exclusions_file": "exclusions.txt",
"nmap_threads": 5,
"masscan_batch_size": 5,
"nmap_threshold": 5000000
}