Rápida herramienta de enumeración pasiva de subdominios.
<h1 align="center">
<img src="https://assets.kitploit.com/production/public/readmes/223/b0359788df92645643107e4c50e83163f65b16c7bd52c4f601d40b48c031abf8.png" alt="subfinder" width="200px">
<br>
</h1>
<h4 align="center">Herramienta rápida de enumeración pasiva de subdominios.</h4>
<p align="center">
<a href="https://goreportcard.com/report/github.com/projectdiscovery/subfinder/v2"><img src="https://goreportcard.com/badge/github.com/projectdiscovery/subfinder"></a>
<a href="https://github.com/projectdiscovery/subfinder/issues"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat"></a>
<a href="https://github.com/projectdiscovery/subfinder/releases"><img src="https://img.shields.io/github/release/projectdiscovery/subfinder"></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">Instalación</a> •
<a href="#running-subfinder">Uso</a> •
<a href="#post-installation-instructions">Configuración de API</a> •
<a href="#subfinder-go-library">Biblioteca</a> •
<a href="https://discord.gg/projectdiscovery">Únete a Discord</a>
</p>
---
`subfinder` es una herramienta de descubrimiento de subdominios que devuelve subdominios válidos para sitios web, utilizando fuentes pasivas en línea. Tiene una arquitectura simple y modular, y está optimizada para la velocidad. `subfinder` está diseñada para
hacer una sola cosa: enumeración pasiva de subdominios, y lo hace muy bien.
La hemos creado para cumplir con todas las licencias y restricciones de uso de las fuentes pasivas utilizadas. El modelo pasivo garantiza la velocidad y el sigilo que pueden aprovechar tanto los pentesters como los
cazadores de bug bounty.
# Características
<h1 align="left">
<img src="https://assets.kitploit.com/production/public/readmes/223/a0f890bf4aa54702b0440c3b73f9f0479df493700e290f419ae2b6a4c6286609.png" alt="subfinder" width="700px"></a>
<br>
</h1>
- Módulos rápidos y potentes de resolución y eliminación de comodines
- Fuentes pasivas **seleccionadas** para maximizar los resultados
- Múltiples formatos de salida compatibles (JSON, archivo, stdout)
- Optimizada para la velocidad y **ligera** en recursos
- Compatibilidad con **STDIN/OUT** que permite una fácil integración en flujos de trabajo
# Uso
```sh
subfinder -h
```
Esto mostrará la ayuda de la herramienta. Aquí están todos los modificadores que admite.
```yaml
Usage:
./subfinder [flags]
Flags:
INPUT:
-d, -domain string[] domains to find subdomains for
-dL, -list string file containing list of domains for subdomain discovery
SOURCE:
-s, -sources string[] specific sources to use for discovery (-s crtsh,github). Use -ls to display all available sources.
-recursive use only sources that can handle subdomains recursively (e.g. subdomain.domain.tld vs domain.tld)
-all use all sources for enumeration (slow)
-es, -exclude-sources string[] sources to exclude from enumeration (-es alienvault,zoomeyeapi)
FILTER:
-m, -match string[] subdomain or list of subdomain to match (file or comma separated)
-f, -filter string[] subdomain or list of subdomain to filter (file or comma separated)
-match-regex string[] regex or list of regex to match on output subdomain (cli, file)
-filter-regex string[] regex or list of regex to filter on output subdomain (cli, file)
RATE-LIMIT:
-rl, -rate-limit int maximum number of http requests to send per second
-rls value maximum number of http requests to send per second for providers in key=value format (-rls "hackertarget=10/s,shodan=15/s")
-t int number of concurrent goroutines for resolving (-active only) (default 10)
UPDATE:
-up, -update update subfinder to latest version
-duc, -disable-update-check disable automatic subfinder update check
OUTPUT:
-o, -output string file to write output to
-oJ, -json write output in JSONL format
-oD, -output-dir string directory to write output (-dL only)
-cs, -collect-sources include all sources in the output (-json only)
-oI, -ip include host IP in output (-active only)
CONFIGURATION:
-config string flag config file (default "$CONFIG/subfinder/config.yaml")
-pc, -provider-config string provider config file (default "$CONFIG/subfinder/provider-config.yaml")
-r string[] comma separated list of resolvers to use
-rL, -rlist string file containing list of resolvers to use
-nW, -active display active subdomains only
-proxy string http proxy to use with subfinder
-ei, -exclude-ip exclude IPs from the list of domains
-mr, -max-results int limit the number of results per source (0 = unlimited; honored by paginating sources)
DEBUG:
-silent show only subdomains in output
-version show version of subfinder
-v show verbose output
-nc, -no-color disable color in output
-ls, -list-sources list all available sources (-oJ for JSON)
OPTIMIZATION:
-timeout int seconds to wait before timing out (default 30)
-max-time int minutes to wait for enumeration results (default 10)
-rsr, -response-size-read int max response body size to read in bytes from passive sources (0 = unlimited)
```
## Variables de entorno
Subfinder admite variables de entorno para especificar rutas personalizadas para los archivos de configuración:
- `SUBFINDER_CONFIG` - Ruta al archivo config.yaml (anula el valor predeterminado `$CONFIG/subfinder/config.yaml`)
- `SUBFINDER_PROVIDER_CONFIG` - Ruta al archivo provider-config.yaml (anula el valor predeterminado `$CONFIG/subfinder/provider-config.yaml`)
# Instalación
`subfinder` requiere **go1.26.10** para instalarse correctamente. Ejecute el siguiente comando para instalar la última versión:
```sh
go install -v github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest
```
Obtén más información sobre otras formas de instalar subfinder aquí: https://docs.projectdiscovery.io/tools/subfinder/install.
## Instrucciones posteriores a la instalación
`subfinder` se puede usar justo después de la instalación, sin embargo, muchas fuentes requieren claves API para funcionar. Obtén más información aquí: https://docs.projectdiscovery.io/tools/subfinder/install#post-install-configuration.
## Ejecutar Subfinder
Obtén información sobre cómo ejecutar Subfinder aquí: https://docs.projectdiscovery.io/tools/subfinder/running.
### Filtrar resultados con expresiones regulares
`-match-regex` y `-filter-regex` aceptan expresiones regulares de Go, repetidas o desde un archivo (una por línea), y se combinan con `-match` y `-filter`:
```sh
subfinder -d example.com -match-regex '^(api|web)[0-9]{1,3}\.' -filter-regex '(^|\.)dev\.'
```
## Biblioteca Go de Subfinder
Subfinder también se puede utilizar como biblioteca y hay disponibles ejemplos mínimos del uso del SDK de subfinder [aquí](https://github.com/projectdiscovery/subfinder/blob/dev/examples/main.go)
</td>
</tr>
</table>
### Recursos
- [¡¡¡Recon conmigo!!!](https://dhiyaneshgeek.github.io/bug/bounty/2020/02/06/recon-with-me/)
# Licencia
`subfinder` está hecho con 🖤 por el equipo de [projectdiscovery](https://projectdiscovery.io). Las contribuciones de la comunidad han hecho del proyecto lo que es. Consulte
el archivo **[THANKS.md](https://github.com/projectdiscovery/subfinder/blob/main/THANKS.md)** para más detalles.
Lea el aviso legal de uso en [DISCLAIMER.md](https://github.com/projectdiscovery/subfinder/blob/main/DISCLAIMER.md) y [contáctenos](mailto:[email protected]) para cualquier eliminación de API.