projectdiscovery/dnsxdnsx es un kit de herramientas DNS rápido y multipropósito que permite ejecutar múltiples consultas DNS de tu elección con una lista de solucionadores proporcionados por el usuario.
<h1 align="center">
<img src="https://assets.kitploit.com/production/public/readmes/3923/abdf7c5ef50e7d740b96aad5a151b9ac75700de029a681a6b3dc6b51efe45b7d.png" alt="dnsx" width="200px">
<br>
</h1>
<h4 align="center">Un toolkit DNS rápido y multipropósito diseñado para ejecutar consultas DNS</h4>
<p align="center">
<a href="https://goreportcard.com/report/github.com/projectdiscovery/dnsx"><img src="https://goreportcard.com/badge/github.com/projectdiscovery/dnsx"></a>
<a href="https://github.com/projectdiscovery/dnsx/issues"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat"></a>
<a href="https://github.com/projectdiscovery/dnsx/releases"><img src="https://img.shields.io/github/release/projectdiscovery/dnsx"></a>
<a href="https://twitter.com/pdiscoveryio"><img src="https://img.shields.io/twitter/follow/pdiscoveryio.svg?logo=twitter"></a>
<a href="https://discord.gg/projectdiscovery"><img src="https://img.shields.io/discord/695645237418131507.svg?logo=discord"></a>
</p>
<p align="center">
<a href="#features">Características</a> •
<a href="#installation-instructions">Instalación</a> •
<a href="#usage">Uso</a> •
<a href="#running-dnsx">Ejecutando `dnsx`</a> •
<a href="#wildcard-filtering">Wildcard</a> •
<a href="#-notes">Notas</a> •
<a href="https://discord.gg/projectdiscovery">Únete a Discord</a>
</p>
---
`dnsx` es un toolkit DNS rápido y multipropósito diseñado para ejecutar diversas sondas a través de la librería [retryabledns](https://github.com/projectdiscovery/retryabledns). Soporta múltiples consultas DNS, resolvers proporcionados por el usuario, filtrado de wildcards DNS como [shuffledns](https://github.com/projectdiscovery/shuffledns), etc.
# Características
<h1 align="left">
<img src="https://assets.kitploit.com/production/public/readmes/3923/e0be49be16e94055f8ca00845ffa701135d23cba6aca284260e6208fa8c20026.png" alt="dnsx" width="700px"></a>
<br>
</h1>
- Utilidad simple y práctica para consultar registros DNS.
- Soporte de consultas **A, AAAA, CNAME, PTR, NS, MX, TXT, SRV, SOA**
- Soporte de **Resolución** / **Fuerza bruta** DNS
- Soporte de entrada de **resolver** personalizado
- Soporte de múltiples formatos de resolver **(TCP/UDP/DOH/DOT)**
- Soporte de **stdin** y **stdout**
- Soporte de manejo automático de **wildcards**
# Instrucciones de instalación
`dnsx` requiere **go1.21** para instalarse correctamente. Ejecuta el siguiente comando para instalar la última versión:
```sh
go install -v github.com/projectdiscovery/dnsx/cmd/dnsx@latest
```
# Uso
```sh
dnsx -h
```
Esto mostrará la ayuda de la herramienta. Aquí están todos los modificadores que soporta.
```console
INPUT:
-l, -list string list of sub(domains)/hosts to resolve (file or stdin)
-d, -domain string list of domain to bruteforce (file or comma separated or stdin)
-w, -wordlist string list of words to bruteforce (file or comma separated or stdin)
QUERY:
-a query A record (default)
-aaaa query AAAA record
-cname query CNAME record
-ns query NS record
-txt query TXT record
-srv query SRV record
-ptr query PTR record
-mx query MX record
-soa query SOA record
-any query ANY record
-axfr query AXFR
-caa query CAA record
-recon query all the dns records (a,aaaa,cname,ns,txt,srv,ptr,mx,soa,axfr,caa)
-e, -exclude-type value dns query type to exclude (a,aaaa,cname,ns,txt,srv,ptr,mx,soa,axfr,caa) (default none)
FILTER:
-re, -resp display dns response
-ro, -resp-only display dns response only
-rc, -rcode string filter result by dns status code (eg. -rcode noerror,servfail,refused)
PROBE:
-cdn display cdn name
-asn display host asn information
RATE-LIMIT:
-t, -threads int number of concurrent threads to use (default 100)
-rl, -rate-limit int number of dns request/second to make (disabled as default) (default -1)
UPDATE:
-up, -update update dnsx to latest version
-duc, -disable-update-check disable automatic dnsx update check
OUTPUT:
-o, -output string file to write output
-j, -json write output in JSONL(ines) format
-omit-raw, -or omit raw dns response from jsonl output
-ot, -output-template string custom output template (e.g. -ot '{{host}} {{a}}')
DEBUG:
-hc, -health-check run diagnostic check up
-silent display only results in the output
-v, -verbose display verbose output
-raw, -debug display raw dns response
-stats display stats of the running scan
-version display version of dnsx
-nc, -no-color disable color in output
OPTIMIZATION:
-retry int number of dns attempts to make (must be at least 1) (default 2)
-hf, -hostsfile use system host file
-trace perform dns tracing
-trace-max-recursion int Max recursion for dns trace (default 32767)
-resume resume existing scan
-stream stream mode (wordlist, wildcard, stats and stop/resume will be disabled)
-timeout value maximum time to wait for a DNS query to complete (default 3s)
CONFIGURATIONS:
-auth configure projectdiscovery cloud (pdcp) api key (default true)
-r, -resolver string list of resolvers to use (file or comma separated)
-wt, -wildcard-threshold int wildcard filter threshold (default 5)
-aw, -auto-wildcard automatically detect wildcard domains for filtering
-wd, -wildcard-domain string domain name for manual wildcard filtering (mutually exclusive with -auto-wildcard; other flags will be ignored - json output recommended)
```
## Ejecutando dnsx
### Resolución DNS
Filtra nombres de host activos de la lista de subdominios pasivos, obtenidos de diversas fuentes:
```console
subfinder -silent -d hackerone.com | dnsx -silent
a.ns.hackerone.com
www.hackerone.com
api.hackerone.com
docs.hackerone.com
mta-sts.managed.hackerone.com
mta-sts.hackerone.com
resources.hackerone.com
b.ns.hackerone.com
mta-sts.forwarding.hackerone.com
events.hackerone.com
support.hackerone.com
```
Imprime los registros **A** para la lista de subdominios dada:
```console
subfinder -silent -d hackerone.com | dnsx -silent -a -resp
www.hackerone.com [104.16.100.52]
www.hackerone.com [104.16.99.52]
hackerone.com [104.16.99.52]
hackerone.com [104.16.100.52]
api.hackerone.com [104.16.99.52]
api.hackerone.com [104.16.100.52]
mta-sts.forwarding.hackerone.com [185.199.108.153]
mta-sts.forwarding.hackerone.com [185.199.109.153]
mta-sts.forwarding.hackerone.com [185.199.110.153]
mta-sts.forwarding.hackerone.com [185.199.111.153]
a.ns.hackerone.com [162.159.0.31]
resources.hackerone.com [52.60.160.16]
resources.hackerone.com [3.98.63.202]
resources.hackerone.com [52.60.165.183]
resources.hackerone.com [read.uberflip.com]
mta-sts.hackerone.com [185.199.110.153]
mta-sts.hackerone.com [185.199.111.153]
mta-sts.hackerone.com [185.199.109.153]
mta-sts.hackerone.com [185.199.108.153]
gslink.hackerone.com [13.35.210.17]
gslink.hackerone.com [13.35.210.38]
gslink.hackerone.com [13.35.210.83]
gslink.hackerone.com [13.35.210.19]
b.ns.hackerone.com [162.159.1.31]
docs.hackerone.com [185.199.109.153]
docs.hackerone.com [185.199.110.153]
docs.hackerone.com [185.199.111.153]
docs.hackerone.com [185.199.108.153]
support.hackerone.com [104.16.51.111]
support.hackerone.com [104.16.53.111]
mta-sts.managed.hackerone.com [185.199.108.153]
mta-sts.managed.hackerone.com [185.199.109.153]
mta-sts.managed.hackerone.com [185.199.110.153]
mta-sts.managed.hackerone.com [185.199.111.153]
```
Extrae los registros **A** para la lista de subdominios dada:
```console
subfinder -silent -d hackerone.com | dnsx -silent -a -resp-only
104.16.99.52
104.16.100.52
162.159.1.31
104.16.99.52
104.16.100.52
185.199.110.153
185.199.111.153
185.199.108.153
185.199.109.153
104.16.99.52
104.16.100.52
104.16.51.111
104.16.53.111
185.199.108.153
185.199.111.153
185.199.110.153
185.199.111.153
```
Extrae los registros **CNAME** para la lista de subdominios dada:
```console
subfinder -silent -d hackerone.com | dnsx -silent -cname -resp
support.hackerone.com [hackerone.zendesk.com]
resources.hackerone.com [read.uberflip.com]
mta-sts.hackerone.com [hacker0x01.github.io]
mta-sts.forwarding.hackerone.com [hacker0x01.github.io]
events.hackerone.com [whitelabel.bigmarker.com]
```
Extrae los registros **ASN** para la lista de subdominios dada:
```console
subfinder -silent -d hackerone.com | dnsx -silent -asn
b.ns.hackerone.com [AS13335, CLOUDFLARENET, US]
a.ns.hackerone.com [AS13335, CLOUDFLARENET, US]
hackerone.com [AS13335, CLOUDFLARENET, US]
www.hackerone.com [AS13335, CLOUDFLARENET, US]
api.hackerone.com [AS13335, CLOUDFLARENET, US]
support.hackerone.com [AS13335, CLOUDFLARENET, US]
```
Sondea usando el [código de estado DNS](https://github.com/projectdiscovery/dnsx/wiki/RCODE-ID-VALUE-Mapping) en la lista de (sub)dominios dada:
```console
subfinder -silent -d hackerone.com | dnsx -silent -rcode noerror,servfail,refused
ns.hackerone.com [NOERROR]
a.ns.hackerone.com [NOERROR]
b.ns.hackerone.com [NOERROR]
support.hackerone.com [NOERROR]
resources.hackerone.com [NOERROR]
mta-sts.hackerone.com [NOERROR]
www.hackerone.com [NOERROR]
mta-sts.forwarding.hackerone.com [NOERROR]
docs.hackerone.com [NOERROR]
```
Extrae subdominios del rango de red dado usando la consulta `PTR`:
```console
echo 173.0.84.0/24 | dnsx -silent -resp-only -ptr
cors.api.paypal.com
trinityadminauth.paypal.com
cld-edge-origin-api.paypal.com
appmanagement.paypal.com
svcs.paypal.com
trinitypie-serv.paypal.com
ppn.paypal.com
pointofsale-new.paypal.com
pointofsale.paypal.com
slc-a-origin-pointofsale.paypal.com
fpdbs.paypal.com
```
Extrae subdominios del ASN dado usando la consulta `PTR`:
```console
echo AS17012 | dnsx -silent -resp-only -ptr
apiagw-a.paypal.com
notify.paypal.com
adnormserv-slc-a.paypal.com
a.sandbox.paypal.com
apps2.paypal-labs.com
pilot-payflowpro.paypal.com
www.paypallabs.com
paypal-portal.com
micropayments.paypal-labs.com
minicart.paypal-labs.com
```
---------
### Formato de salida personalizado
El flag `-output-template` (`-ot`) te permite personalizar el formato de salida usando una plantilla, en lugar del diseño predeterminado entre corchetes (por ejemplo, `example.com [A] [104.20.23.154]`). Especificas la plantilla directamente en la línea de comandos para controlar cómo se presentan los datos resueltos.
Las variables de la plantilla se corresponden con los mismos nombres de campo usados en la salida JSONL (`-json`), por lo que cualquiera de los siguientes puede referenciarse como `{{field}}`:
`host`, `a`, `aaaa`, `cname`, `ns`, `txt`, `mx`, `srv`, `ptr`, `soa`, `caa`, `ttl`, `resolver`, `status_code`, `cdn-name`, `cdn-type`, `asn`, `query-time`. Un alias de conveniencia `{{ip}}` contiene los registros combinados `A` y `AAAA`.
Los registros con múltiples valores (por ejemplo, varios registros `A`) se unen por comas dentro de un único campo.
```console
echo example.com | dnsx -silent -a -ot '{{host}} {{a}}'
example.com 104.20.23.154,172.66.147.243
```
```console
echo example.com | dnsx -silent -a -ot '{{ip}} - {{host}}'
104.20.23.154,172.66.147.243 - example.com
```
> [!NOTE]
> Si un campo especificado no existe o no contiene un valor, simplemente se omite de la salida. `-output-template` no puede combinarse con `-json` o `-raw`.
---------
### Fuerza bruta DNS
Fuerza bruta de subdominios para un dominio dado o lista de dominios usando los flags `d` y `w`:
```console
dnsx -silent -d facebook.com -w dns_worldlist.txt
blog.facebook.com
booking.facebook.com
api.facebook.com
analytics.facebook.com
beta.facebook.com
apollo.facebook.com
ads.facebook.com
box.facebook.com
alpha.facebook.com
apps.facebook.com
connect.facebook.com
c.facebook.com
careers.facebook.com
code.facebook.com
```
Fuerza bruta de un subdominio específico usando entrada de una o varias palabras clave, ya que el flag `d` o `w` soporta archivos o entradas de palabras clave separadas por comas:
```console
dnsx -silent -d domains.txt -w jira,grafana,jenkins
grafana.1688.com
grafana.8x8.vc
grafana.airmap.com
grafana.aerius.nl
jenkins.1688.com
jenkins.airbnb.app
jenkins.airmap.com
jenkins.ahn.nl
jenkins.achmea.nl
jira.amocrm.com
jira.amexgbt.com
jira.amitree.com
jira.arrival.com
jira.atlassian.net
jira.atlassian.com
```
Los valores se aceptan desde **stdin** para todos los tipos de entrada (`-list`, `-domain`, `-wordlist`). El flag `-list` usa `stdin` por defecto, pero lo mismo se puede lograr para otros tipos de entrada añadiendo un `-` (guion) como parámetro:
```console
cat domains.txt | dnsx -silent -w jira,grafana,jenkins -d -
grafana.1688.com
grafana.8x8.vc
grafana.airmap.com
grafana.aerius.nl
jenkins.1688.com
jenkins.airbnb.app
jenkins.airmap.com
jenkins.ahn.nl
jenkins.achmea.nl
jira.amocrm.com
jira.amexgbt.com
jira.amitree.com
jira.arrival.com
jira.atlassian.net
jira.atlassian.com
```
#### Fuerza bruta DNS con wordlist basada en marcadores de posición
```bash
$ cat tld.txt
com
by
de
be
al
bi
cg
dj
bs
```
```console
dnsx -d google.FUZZ -w tld.txt -resp
_ __ __
__| | _ __ ___ \ \/ /
/ _' || '_ \ / __| \ /
| (_| || | | |\__ \ / \
\__,_||_| |_||___//_/\_\ v1.1.2
projectdiscovery.io
google.de [142.250.194.99]
google.com [142.250.76.206]
google.be [172.217.27.163]
google.bs [142.251.42.35]
google.bi [216.58.196.67]
google.al [216.58.196.68]
google.by [142.250.195.4]
google.cg [142.250.183.131]
google.dj [142.250.192.3]
```
### Filtrado de wildcards
Una característica especial de `dnsx` es su capacidad de manejar **wildcards DNS de múltiples niveles**, y hacerlo con un número muy reducido de solicitudes DNS. A veces todos los subdominios se resuelven, lo que genera mucha basura en la salida. La forma en que `dnsx` maneja esto es llevando un registro de cuántos subdominios apuntan a una IP y, si el recuento de subdominios aumenta más allá de cierto umbral, comprobará iterativamente los wildcards en todos los niveles de los hosts para esa IP.
```console
dnsx -l subdomain_list.txt -wd airbnb.com -o output.txt
```
Para detectar y filtrar wildcards DNS automáticamente en múltiples dominios en una sola ejecución mientras se preserva el modo de salida seleccionado:
```console
dnsx -l subdomain_list.txt -auto-wildcard -o output.txt
```
`-auto-wildcard` y `-wd` / `-wildcard-domain` son mutuamente excluyentes. Usa `-wd` cuando quieras el flujo existente de filtrado manual de wildcards de un solo dominio; usa `-auto-wildcard` cuando quieras que dnsx detecte raíces wildcard automáticamente en entradas de dominios mixtos.
---
### Dnsx como librería
Es posible usar la librería directamente en tus programas de golang. Los siguientes fragmentos de código son un ejemplo de uso en programas de golang. Consulta [aquí](https://pkg.go.dev/github.com/projectdiscovery/[email protected]/libs/dnsx) para la configuración detallada del paquete y su uso.
```go
package main
import (
"fmt"
"github.com/projectdiscovery/dnsx/libs/dnsx"
)
func main() {
// Create DNS Resolver with default options
dnsClient, err := dnsx.New(dnsx.DefaultOptions)
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
// DNS A question and returns corresponding IPs
result, err := dnsClient.Lookup("hackerone.com")
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
for idx, msg := range result {
fmt.Printf("%d: %s\n", idx+1, msg)
}
// Query
rawResp, err := dnsClient.QueryOne("hackerone.com")
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
fmt.Printf("rawResp: %v\n", rawResp)
jsonStr, err := rawResp.JSON()
if err != nil {
fmt.Printf("err: %v\n", err)
return
}
fmt.Println(jsonStr)
return
}
```
# 📋 Notas
- Por defecto, `dnsx` comprueba el registro **A**.
- Por defecto `dnsx` usa los [resolvers](https://github.com/projectdiscovery/dnsx/blob/43af78839e237ea8cbafe571df1ab0d6cbe7f445/libs/dnsx/dnsx.go#L31) de Google, Cloudflare, Quad9.
- La lista de resolvers personalizados se puede cargar usando el flag `r`.
- `-auto-wildcard` detecta automáticamente dominios wildcard en múltiples raíces registrables en una sola ejecución.
- El nombre de dominio (`-wd`) solo es necesario para el filtrado manual de wildcards y no puede usarse junto con `-auto-wildcard`.
- Al usar el filtrado manual de wildcards con `-wd`, se ignoran otros flags de registros DNS y se recomienda la salida JSON.
- La resolución DNS (`l`) y la fuerza bruta DNS (`w`) no pueden usarse juntas.
- Los operadores de VPN tienden a filtrar el tráfico alto de DNS/UDP, por lo tanto la herramienta podría experimentar pérdida de paquetes (por ejemplo, [Mullvad VPN](https://github.com/projectdiscovery/dnsx/issues/221)). Consulta [esta posible solución](https://github.com/projectdiscovery/dnsx/blob/dev/MULLVAD.md).
`dnsx` está hecho con 🖤 por el equipo de [projectdiscovery](https://projectdiscovery.io).