### Desde el código fuente```sh
git clone https://github.com/praetorian-inc/nerva.git
cd nerva
go build ./cmd/nerva
./nerva -h

## Inicio Rápido

Analizar un único objetivo:```sh
nerva -t example.com:22
# ssh://example.com:22

Tubería desde un escáner de puertos:```sh
naabu -host example.com -silent | nerva
# http://example.com:80
# ssh://example.com:22
# https://example.com:443

### Flags

| Flag | Short | Description | Default |
|------|-------|-------------|---------|
| `--targets` | `-t` | Objetivo o lista de objetivos separados por comas | — |
| `--list` | `-l` | Archivo de entrada que contiene objetivos | — |
| `--output` | `-o` | Ruta del archivo de salida | stdout |
| `--json` | | Salida en formato JSON | false |
| `--csv` | | Salida en formato CSV | false |
| `--misconfigs` | | Habilitar detección de configuraciones incorrectas de seguridad | false |
| `--proxy` | | URL del proxy (ej. socks5://127.0.0.1:1080) | — |
| `--proxy-auth` | | Autenticación del proxy SOCKS5 (ej. usuario:contraseña) | — |
| `--dns-order` | | Orden de resolución DNS: `p`, `l`, `lp`, `pl` | `lp` |
| `--fast` | `-f` | Modo rápido (solo puertos predeterminados) | false |
| `--capabilities` | `-c` | Listar capacidades disponibles y salir | false |
| `--udp` | `-U` | Ejecutar plugins UDP | false |
| `--sctp` | `-S` | Ejecutar plugins SCTP (solo Linux) | false |
| `--timeout` | `-w` | Tiempo de espera en milisegundos | 2000 |
| `--verbose` | `-v` | Salida detallada a stderr | false |
| `--workers` | `-W` | Trabajadores de escaneo concurrentes | 50 |
| `--max-host-conn` | `-H` | Máximo de conexiones concurrentes por IP de host (0=ilimitado) | 0 |
| `--rate-limit` | `-R` | Máximo de escaneos por segundo globalmente (0=ilimitado) | 0 |

### Examples

**Múltiples objetivos:**```sh
nerva -t example.com:22,example.com:80,example.com:443

**UDP scanning** (puede requerir root):```sh
sudo nerva -t example.com:53 -U
# dns://example.com:53

**Modo rápido** (solo puertos por defecto):```sh
nerva -l large-target-list.txt --fast --json

### Detección de Configuraciones Incorrectas de Seguridad

Nerva puede identificar configuraciones incorrectas de seguridad comunes cuando se habilita con `--misconfigs`:```sh
nerva -t example.com:2375 --misconfigs --json

### Soporte de Proxy

Nerva soporta el enrutamiento del tráfico de escaneo a través de proxies SOCKS5 y HTTP con resolución DNS configurable.

**Esquemas de proxy compatibles:**

- `socks5://` - proxy SOCKS5 con resolución DNS local
- `socks5h://` - proxy SOCKS5 con resolución DNS del lado del proxy (siempre)
- `http://` - proxy HTTP CONNECT
- `https://` - proxy HTTPS CONNECT

**Autenticación de proxy:**```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 a través de proxy:**```sh
# UDP scanning through SOCKS5 proxy (limited support)
nerva -t target.com:161 --proxy socks5://127.0.0.1:1080 --udp

**Apagado elegante** (Ctrl+C devuelve resultados parciales):```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)
}

See [examples/service-fingerprinting-example.go](https://github.com/praetorian-inc/nerva/blob/HEAD/examples/service-fingerprinting-example.go) for a complete working example.

## Casos de Uso

### Pruebas de Penetración

Fingerprint rápidamente servicios descubiertos durante el reconocimiento para identificar posibles vectores de ataque.

### Tuberías de Descubrimiento de Activos

Combine con Naabu o Masscan para un inventario de activos a gran escala:```sh
naabu -host 10.0.0.0/24 -silent | nerva --json | jq '.protocol'

## Arquitectura```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]

### Errores de tiempo de espera

**Causa**: El tiempo de espera predeterminado de 2 segundos es demasiado corto para servicios lentos.

**Solución**: Aumentar el tiempo de espera:

nerva -t example.com:80 -w 5000  # 5 seconds
```
### UDP services not detected

**Causa**: Escaneo UDP deshabilitado por defecto.

**Solución**: Habilítelo con la bandera `-U` (puede requerir root):```sh
sudo nerva -t example.com:53 -U
```
### SCTP no funciona

**Causa**: SCTP solo es compatible con Linux.

**Solución**: Ejecutar en un sistema o contenedor Linux:```sh
docker run --rm nerva -t telecom:3868 -S
```
## Terminología

- **Servicio**: Un servicio de red ejecutándose en un puerto (SSH, HTTP, PostgreSQL, etc.)
- **Huella digital**: Detectar e identificar el tipo de servicio, versión y configuración
- **Plugin**: Un módulo de detección específico del protocolo
- **Modo rápido**: Escanear solo el puerto predeterminado para cada protocolo (optimización 80/20)
- **Transporte**: Protocolo de capa de red (TCP, UDP o SCTP)

## Soporte

Si encuentras útil Nerva, considera darle una estrella:

[![GitHub stars](https://img.shields.io/github/stars/praetorian-inc/nerva?style=social)](https://github.com/praetorian-inc/nerva)

## Contribuciones

¡Agradecemos las contribuciones! Consulta [CONTRIBUTING.md](https://github.com/praetorian-inc/nerva/blob/HEAD/CONTRIBUTING.md) para las pautas.

## Licencia

Apache 2.0 — consulta [LICENSE](https://github.com/praetorian-inc/nerva/blob/HEAD/LICENSE) para más detalles.

## Agradecimientos

Nerva es un fork mantenido de [fingerprintx](https://github.com/praetorian-inc/fingerprintx), desarrollado originalmente por la clase de pasantes de Praetorian de 2022:

* [Soham Roy](https://github.com/praetorian-sohamroy)
* [Jue Huang](https://github.com/jue-huang)
* [Henry Jung](https://github.com/henryjung64)
* [Tristan Wiesepape](https://github.com/qwetboy10)
* [Joseph Henry](https://github.com/jwhenry28)
* [Noah Tutt](https://github.com/noahtutt)
* [Nathan Sportsman](https://github.com/nsportsman)