Nerva
_{Nerva: 빠른 서비스 핑거프린팅 CLI}

기능 • 설치 • 빠른 시작 • 사용법 • 프로토콜 • 라이브러리 • 사용 사례 • 문제 해결

Go로 작성된 고성능 서비스 핑거프린팅. TCP, UDP, SCTP 전송을 통해 170개 이상의 네트워크 프로토콜을 식별하고 풍부한 메타데이터를 추출합니다.

Nerva는 열린 네트워크 포트에서 실행 중인 서비스를 신속하게 탐지하고 식별합니다. Naabu와 같은 포트 스캐너와 함께 사용하여 발견된 서비스를 핑거프린팅하거나, 보안 파이프라인에 통합하여 자동화된 정찰을 수행할 수 있습니다.

기능

• 170개 이상의 프로토콜 플러그인 — 데이터베이스, 원격 접속, 웹 서비스, 메시징, 산업용, 통신 프로토콜
• 76개의 HTTP 핑거프린터 — 방화벽, 데이터베이스, AI/LLM 서버 등을 포함한 웹 기술 탐지
• 보안 설정 오류 탐지 — 인증되지 않은 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)

카테고리별로 구성된 웹 서비스 기술 탐지:

방화벽 및 네트워크 보안 (12)

AI/LLM 및 머신러닝 (6)

데이터베이스 및 데이터 스토어 (12)

DevOps 및 인프라 (14)

웹 서버 및 프레임워크 (10)

엔터프라이즈 및 비즈니스 (8)

홈 및 IoT (2)

기타 (2)

데이터베이스 (20)

원격 접속 (6)

웹 및 API (2)

메시징 및 큐 (10)

파일 및 디렉터리 서비스 (7)

네트워크 서비스 (11)

산업 제어 시스템 (18)

통신 및 VoIP (17)

VPN 및 보안 (11)

원격 접속 및 관리 (10)

개발자 도구 (8)

라이브러리 사용법

Go 애플리케이션에 Nerva를 임포트하세요:```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/main/examples/service-fingerprinting-example.go) for a complete working example.

## 사용 사례

### 침투 테스트

정찰 중 발견된 서비스를 신속하게 핑거프린팅하여 잠재적인 공격 벡터를 식별합니다.

### 자산 검색 파이프라인

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

용어

• Service: 포트에서 실행되는 네트워크 서비스 (SSH, HTTP, PostgreSQL 등)
• Fingerprinting: 서비스 유형, 버전 및 구성을 감지하고 식별하는 것
• Plugin: 프로토콜별 감지 모듈
• Fast Mode: 각 프로토콜의 기본 포트만 스캔 (80/20 최적화)
• Transport: 네트워크 계층 프로토콜 (TCP, UDP 또는 SCTP)

지원

Nerva가 유용하다고 생각되시면, 스타를 눌러주시기 바랍니다:

기여

기여를 환영합니다! 가이드라인은 CONTRIBUTING.md를 참조하세요.

라이선스

Apache 2.0 — 자세한 내용은 LICENSE를 참조하세요.

감사의 글

Nerva는 원래 Praetorian의 2022년 인턴 클래스에 의해 개발된 fingerprintx의 유지 관리되는 포크입니다:

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