Nerva
_{Nerva: 高速サービスフィンガープリンティングCLI}

機能 • インストール • クイックスタート • 使用方法 • プロトコル • ライブラリ • ユースケース • トラブルシューティング

Goで書かれた高性能サービスフィンガープリンティング。 TCP、UDP、SCTPトランスポートにわたる170以上のネットワークプロトコルを識別し、豊富なメタデータを抽出します。

Nervaは、開いているネットワークポートで実行されているサービスを迅速に検出・識別します。Naabuのようなポートスキャナと併用して検出されたサービスのフィンガープリントを取得したり、セキュリティパイプラインに統合して自動偵察を行ったりできます。

機能

• 170以上のプロトコルプラグイン — データベース、リモートアクセス、Webサービス、メッセージング、産業用、通信プロトコル
• 76のHTTPフィンガープリンタ — ファイアウォール、データベース、AI/LLMサーバーなど、Webテクノロジーを検出
• セキュリティ設定ミスの検出 — 認証されていないAPIや平文プロトコルなど、一般的なセキュリティ問題を特定 (--misconfigs)
• マルチトランスポート対応 — TCP (デフォルト)、UDP (--udp)、SCTP (--sctp、Linuxのみ)
• プロキシ対応 — 設定可能なDNS解決により、SOCKS5またはHTTPプロキシを介してスキャントラフィックを透過的にルーティング
• 豊富なメタデータ — 各サービスからバージョン、設定、セキュリティ関連の詳細を抽出
• 高速モード — 迅速な偵察のためにデフォルトポートのみをスキャン (--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":{...}}

ポートスキャナからのパイプ:```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は、設定可能なDNS解決を備えたSOCKS5およびHTTPプロキシを介したスキャントラフィックのルーティングをサポートしています。

**サポートされているプロキシスキーム:**

- `socks5://` - ローカルDNS解決を使用するSOCKS5プロキシ
- `socks5h://` - プロキシ側DNS解決を（常に）使用するSOCKS5プロキシ
- `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の制限事項: SOCKS5経由のUDPはサポートが限定的です。すべての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

対応プロトコル

TCP、UDP、SCTPにわたる170以上のサービス検出プラグイン:

HTTPフィンガープリントモジュール (66)

カテゴリ別に整理されたWebサービスの技術検出:

ファイアウォール & ネットワークセキュリティ (12)

AI/LLM & 機械学習 (6)

データベース & データストア (12)

DevOps & インフラストラクチャ (14)

Webサーバー & フレームワーク (10)

エンタープライズ & ビジネス (8)

ホーム & IoT (2)

その他 (2)

データベース (20)

リモートアクセス (6)

Web & 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セキュリティスキャン

デプロイパイプラインに統合し、想定されたサービスのみが公開されていることを検証します。

バグバウンティ偵察

スコープ対象全体のサービスを迅速に列挙し、興味深いエンドポイントを見つけます。

テレコムネットワーク分析

SCTPトランスポート（Linux）を使用してLTE/5Gネットワーク内のDiameterノードをフィンガープリントします：```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