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のみ）
• プロキシ対応 — 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":{...}}

ポートスキャナーからのパイプ:```sh
naabu -host example.com -silent | nerva
# http://example.com:80
# ssh://example.com:22
# https://example.com:443

使用方法```

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

### フラグ

| Flag | Short | Description | Default |
|------|-------|-------------|---------|
| `--targets` | `-t` | ターゲット、またはカンマ区切りのターゲットリスト | — |
| `--list` | `-l` | ターゲットを含む入力ファイル | — |
| `--output` | `-o` | 出力ファイルパス | stdout |
| `--json` | | JSON形式で出力 | false |
| `--csv` | | CSV形式で出力 | false |
| `--misconfigs` | | セキュリティ設定ミス検出を有効化 | false |
| `--proxy` | | プロキシURL（例：socks5://127.0.0.1:1080） | — |
| `--proxy-auth` | | SOCKS5プロキシ認証（例：username:password） | — |
| `--dns-order` | | DNS解決順序: `p`, `l`, `lp`, `pl` | `lp` |
| `--fast` | `-f` | 高速モード（デフォルトポートのみ） | false |
| `--capabilities` | `-c` | 利用可能な機能を表示して終了 | false |
| `--udp` | `-U` | UDPプラグインを実行 | false |
| `--sctp` | `-S` | SCTPプラグインを実行（Linuxのみ） | false |
| `--timeout` | `-w` | タイムアウト（ミリ秒） | 2000 |
| `--verbose` | `-v` | 詳細出力をstderrへ | false |
| `--workers` | `-W` | 同時スキャンワーカー数 | 50 |
| `--max-host-conn` | `-H` | ホストIPあたりの最大同時接続数（0=無制限） | 0 |
| `--rate-limit` | `-R` | グローバルな1秒あたりの最大スキャン数（0=無制限） | 0 |

### 例

**複数ターゲット:**```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

サポートされているプロトコル

170以上のサービス検出プラグイン (TCP、UDP、SCTP対応)：

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)
}

}

See [examples/service-fingerprinting-example.go](https://github.com/praetorian-inc/nerva/blob/HEAD/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 vs 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