Nerva
_{Nerva: быстрый CLI для фингерпринтинга сервисов}

Возможности • Установка • Быстрый старт • Использование • Протоколы • Библиотека • Сценарии использования • Устранение неполадок

Высокопроизводительный фингерпринтинг сервисов, написанный на Go. Определяйте 170+ сетевых протоколов через транспорты TCP, UDP и SCTP с извлечением подробных метаданных.

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

Возможности

• 170+ плагинов протоколов — базы данных, удалённый доступ, веб-сервисы, обмен сообщениями, промышленные и телекоммуникационные протоколы
• 76 HTTP-фингерпринтеров — обнаружение веб-технологий, включая межсетевые экраны, базы данных, серверы AI/LLM и многое другое
• Обнаружение ошибок конфигурации безопасности — выявление распространённых проблем безопасности, таких как неаутентифицированные API и протоколы с передачей данных в открытом виде (--misconfigs)
• Поддержка нескольких транспортов — TCP (по умолчанию), UDP (--udp) и SCTP (--sctp, только Linux)
• Поддержка прокси — прозрачная маршрутизация трафика сканирования через SOCKS5 или HTTP-прокси с настраиваемым разрешением DNS
• Подробные метаданные — извлечение версий, конфигураций и сведений, значимых для безопасности, из каждого сервиса
• Быстрый режим — сканирование только портов по умолчанию для оперативной разведки (--fast)
• Гибкий вывод — форматы JSON, CSV или удобочитаемый для человека
• Удобство для конвейеров — передача данных из Naabu, Nmap или любого инструмента, выводящего host:port
• Библиотека Go — импорт непосредственно в ваши приложения на Go

Установка

Релизы

Скачайте готовый бинарный файл со страницы Releases.

Из GitHub```sh

go install github.com/praetorian-inc/nerva/cmd/nerva@latest

### Из исходного кода```sh
git clone https://github.com/praetorian-inc/nerva.git
cd nerva
go build ./cmd/nerva
./nerva -h

Docker```sh

git clone https://github.com/praetorian-inc/nerva.git cd nerva docker build -t nerva . docker run --rm nerva -h docker run --rm nerva -t example.com:80 --json

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

Определение отпечатка одного целевого узла:```sh
nerva -t example.com:22
# ssh://example.com:22

Получить подробные метаданные JSON:```sh nerva -t example.com:22 --json

{"host":"example.com","ip":"93.184.216.34","port":22,"protocol":"ssh","transport":"tcp","metadata":{...}}

Pipe из сканера портов:```sh
naabu -host example.com -silent | nerva
# http://example.com:80
# ssh://example.com:22
# https://example.com:443

Полный справочник — каждая подкоманда, псевдоним и флаг, включая скрытые от --help — генерируется в docs/CLI.md.

Использование```

nerva [flags]

TARGET SPECIFICATION: Requires host:port or ip:port format. Assumes ports are open.

EXAMPLES: nerva -t example.com:80 nerva -t example.com:80,example.com:443 nerva -l targets.txt nerva --json -t example.com:80 cat targets.txt | nerva

### Примеры

**Несколько целей:**```sh
nerva -t example.com:22,example.com:80,example.com:443

Из файла:```sh nerva -l targets.txt --json -o results.json

**Сканирование UDP** (может потребоваться root):```sh
sudo nerva -t example.com:53 -U
# dns://example.com:53

Сканирование SCTP (только Linux):```sh nerva -t telecom-server:3868 -S

diameter://telecom-server:3868

**Быстрый режим** (только порты по умолчанию):```sh
nerva -l large-target-list.txt --fast --json

Прокси-маршрутизация с удалённым разрешением DNS:```sh nerva -t target.internal:80 --proxy socks5://127.0.0.1:1080 --dns-order p

### Обнаружение ошибок конфигурации безопасности

Nerva может выявлять распространённые ошибки конфигурации безопасности при включении флага `--misconfigs`:```sh
nerva -t example.com:2375 --misconfigs --json

Обнаруженные ошибки конфигурации:

Пример вывода с ошибками конфигурации:```json { "host": "example.com", "port": 2375, "protocol": "docker", "anonymous_access": true, "security_findings": [ { "id": "docker-unauth-api", "severity": "critical", "description": "Docker API accessible without authentication", "evidence": "Successfully queried /version endpoint without credentials" } ] }

### Поддержка прокси

Nerva поддерживает маршрутизацию трафика сканирования через SOCKS5 и HTTP-прокси с настраиваемым разрешением DNS.

**Поддерживаемые схемы прокси:**

- `socks5://` - SOCKS5-прокси с локальным разрешением DNS
- `socks5h://` - SOCKS5-прокси с разрешением DNS на стороне прокси (всегда)
- `http://` - HTTP CONNECT-прокси
- `https://` - HTTPS CONNECT-прокси

**Аутентификация прокси:**```sh
# Inline authentication (URL format)
nerva -t example.com:80 --proxy socks5://username:[email protected]:1080

# Separate authentication flag
nerva -t example.com:80 --proxy socks5://127.0.0.1:1080 --proxy-auth username:password

Стратегии разрешения DNS (--dns-order):

Примечание: схема socks5h:// автоматически принудительно использует DNS на стороне прокси (эквивалентно --dns-order p)

Пример сканирования через Tor:```sh

Scan .onion services through Tor (SOCKS5 proxy on port 9050)

nerva -t http://example.onion:80 --proxy socks5h://127.0.0.1:9050

**UDP через прокси:**```sh
# UDP scanning through SOCKS5 proxy (limited support)
nerva -t target.com:161 --proxy socks5://127.0.0.1:1080 --udp

⚠️ Ограничения UDP: Поддержка UDP через SOCKS5 ограничена. Не все SOCKS5-серверы поддерживают UDP-ассоциацию. Возможен локальный UDP-фолбэк.

Параллельное сканирование с ограничением скорости:```sh nerva -l large-target-list.txt -W 100 -H 5 -R 50 -v

**Корректное завершение** (Ctrl+C возвращает частичные результаты):```sh
nerva -l huge-target-list.txt -W 50 -v
# Press Ctrl+C to stop — collected results are still printed

Поддерживаемые протоколы

Более 170 плагинов определения сервисов для TCP, UDP и SCTP:

Модули фингерпринтинга HTTP (66)

Определение технологий для веб-сервисов, организованное по категориям:

Межсетевые экраны и сетевая безопасность (12)

ИИ/LLM и машинное обучение (6)

Базы данных и хранилища данных (12)

DevOps и инфраструктура (14)

Веб-серверы и фреймворки (10)

Корпоративные и бизнес-решения (8)

Домашние и IoT-устройства (2)

Прочее (2)

Базы данных (20)

Удалённый доступ (6)

Веб и API (2)

Обмен сообщениями и очереди (10)

Файловые и каталоговые службы (7)

Сетевые службы (11)

Промышленные системы управления (18)

Телекоммуникации и VoIP (17)

VPN и безопасность (11)

Удалённый доступ и управление (10)

Инструменты разработчика (8)

Использование библиотеки

Импортируйте Nerva в ваши приложения на Go:```go package main

import ( "context" "fmt" "log" "net/netip" "time"

"github.com/praetorian-inc/nerva/pkg/plugins"
"github.com/praetorian-inc/nerva/pkg/scan"

)

func main() { // Configure scan config := scan.Config{ DefaultTimeout: 2 * time.Second, FastMode: false, UDP: false, Proxy: "socks5://127.0.0.1:1080", // optional ProxyAuth: "username:password", // optional DNSOrder: "p", // resolver strategy }

// Create target
ip, _ := netip.ParseAddr("93.184.216.34")
target := plugins.Target{
    Address: netip.AddrPortFrom(ip, 22),
    Host:    "example.com",
}

// Run scan
results, err := scan.ScanTargets(context.Background(), []plugins.Target{target}, config)
if err != nil {
    log.Fatal(err)
}

// Process results
for _, result := range results {
    fmt.Printf("%s:%d - %s (%s)\n",
        result.Host, result.Port,
        result.Protocol, result.Transport)
}

}

См. [examples/service-fingerprinting-example.go](https://github.com/praetorian-inc/nerva/blob/main/examples/service-fingerprinting-example.go) для полного рабочего примера.

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

### Тестирование на проникновение

Быстрое определение сервисов, обнаруженных в ходе разведки, для выявления потенциальных векторов атак.

### Конвейеры обнаружения активов

Объедините с Naabu или Masscan для крупномасштабной инвентаризации активов:```sh
naabu -host 10.0.0.0/24 -silent | nerva --json | jq '.protocol'

Сканирование безопасности CI/CD

Интегрируйте в конвейеры развёртывания, чтобы убедиться, что открыты только ожидаемые сервисы.

Разведка для Bug Bounty

Быстро перечисляйте сервисы по целевым областям, чтобы находить интересные конечные точки.

Анализ телекоммуникационных сетей

Определяйте узлы Diameter в сетях LTE/5G с использованием транспорта SCTP (Linux):```sh nerva -t mme.telecom.local:3868 -S --json

## Архитектура```mermaid
graph LR
    A[host:port input] --> B[Target Parser]
    B --> C[Scan Engine]
    C --> D{Transport}
    D -->|TCP| E[TCP Plugins]
    D -->|UDP| F[UDP Plugins]
    D -->|SCTP| G[SCTP Plugins]
    E --> H[Service Detection]
    F --> H
    G --> H
    H --> I[Metadata Extraction]
    I --> J[JSON/CSV/Text Output]

Почему Nerva?

против Nmap

• Более разумные настройки по умолчанию: Nerva сначала проверяет наиболее вероятный протокол на основе номера порта
• Структурированный вывод: Встроенная поддержка JSON/CSV для удобного парсинга и интеграции в пайплайны
• Сфокусированность: Только фингерпринтинг сервисов — используйте вместе со специализированными сканерами портов для обнаружения

против zgrab2

• Автоопределение: Не нужно заранее указывать протокол
• Проще в использовании: nerva -t host:port против echo host | zgrab2 http -p port

Устранение неполадок

Нет вывода

Причина: Порт закрыт или не обнаружено поддерживаемого сервиса.

Решение: Убедитесь, что порт открыт:```sh nc -zv example.com 80

### Ошибки тайм-аута

**Причина**: Стандартный тайм-аут в 2 секунды слишком мал для медленных сервисов.

**Решение**: Увеличьте тайм-аут:```sh
nerva -t example.com:80 -w 5000  # 5 seconds

UDP-сервисы не обнаружены

Причина: UDP-сканирование отключено по умолчанию.

Решение: Включите с помощью флага -U (может потребоваться root):```sh sudo nerva -t example.com:53 -U

### SCTP не работает

**Причина**: SCTP поддерживается только в Linux.

**Решение**: Запустите в системе Linux или контейнере:```sh
docker run --rm nerva -t telecom:3868 -S

Терминология

• Сервис: Сетевой сервис, работающий на порту (SSH, HTTP, PostgreSQL и т. д.)
• Фингерпринтинг: Обнаружение и идентификация типа сервиса, версии и конфигурации
• Плагин: Модуль обнаружения, специфичный для протокола
• Быстрый режим: Сканирование только порта по умолчанию для каждого протокола (оптимизация 80/20)
• Транспорт: Протокол сетевого уровня (TCP, UDP или SCTP)

Поддержка

Если вы находите Nerva полезным, пожалуйста, рассмотрите возможность поставить звезду:

Участие в разработке

Мы приветствуем вклад! См. CONTRIBUTING.md для получения рекомендаций.

Лицензия

Apache 2.0 — подробности см. в LICENSE.

Благодарности

Nerva — это поддерживаемый форк fingerprintx, изначально разработанный группой стажёров Praetorian 2022 года:

• Soham Roy
• Jue Huang
• Henry Jung
• Tristan Wiesepape
• Joseph Henry
• Noah Tutt
• Nathan Sportsman