### 来自源```sh
git clone https://github.com/praetorian-inc/nerva.git
cd nerva
go build ./cmd/nerva
./nerva -h

## 快速开始

对单个目标进行指纹识别：```sh
nerva -t example.com:22
# ssh://example.com:22

来自端口扫描器的管道：```sh
naabu -host example.com -silent | nerva
# http://example.com:80
# ssh://example.com:22
# https://example.com:443

### 标志

| 标志 | 缩写 | 描述 | 默认值 |
|------|------|------|--------|
| `--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` | 全局每秒最大扫描数（0=无限制） | 0 |

### 示例

**多个目标：**```sh
nerva -t example.com:22,example.com:80,example.com:443

**UDP扫描**（可能需要root权限）：```sh
sudo nerva -t example.com:53 -U
# dns://example.com:53

**快速模式**（仅默认端口）：```sh
nerva -l large-target-list.txt --fast --json

### 安全配置错误检测

当使用 `--misconfigs` 选项启用时，Nerva 可以识别常见的安全配置错误：```sh
nerva -t example.com:2375 --misconfigs --json

### 代理支持

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

**UDP 通过代理:**```sh
# UDP scanning through SOCKS5 proxy (limited support)
nerva -t target.com:161 --proxy socks5://127.0.0.1:1080 --udp

**优雅关机**（Ctrl+C 返回部分结果）：```sh
nerva -l huge-target-list.txt -W 50 -v
# Press Ctrl+C to stop — collected results are still printed

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

// 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/HEAD/examples/service-fingerprinting-example.go) 获取完整的工作示例。

## 用例

### 渗透测试

快速识别侦察期间发现的服务，以识别潜在攻击向量。

### 资产发现流水线

结合 Naabu 或 Masscan 进行大规模资产盘点：```sh
naabu -host 10.0.0.0/24 -silent | nerva --json | jq '.protocol'

## 架构```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]

### 超时错误

**原因**：默认2秒超时对于慢速服务来说太短。

**解决方法**：增加超时时间：```sh
nerva -t example.com:80 -w 5000  # 5 seconds

### SCTP 无法工作

**原因**：SCTP仅支持Linux系统。

**解决方案**：在Linux系统或容器中运行：```sh
docker run --rm nerva -t telecom:3868 -S