table of contents
| SUBFINDER(8) | System Administration Utilities | SUBFINDER(8) |
NAME¶
subfinder - manual page for subfinder 2.9.0
DESCRIPTION¶
Subfinder is a subdomain discovery tool that discovers subdomains for websites by using passive online sources.
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 rather than both recursive and non-recursive sources
- -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)
RATE-LIMIT:¶
- -rl, -rate-limit int
- maximum number of http requests to send per second (global)
- -rls, -rate-limits value
- maximum number of http requests to send per second for providers in key=value format (-rls hackertarget=10/m) (default ["github=30/m", "fullhunt=60/m", "pugrecon=10/s", "robtex=18446744073709551615/ms", "securitytrails=1/s", "shodan=1/s", "virustotal=4/m", "hackertarget=2/s", "waybackarchive=15/m", "whoisxmlapi=50/s", "securitytrails=2/s", "sitedossier=8/m", "netlas=1/s", "github=83/m", "hudsonrock=5/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(ines) 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 "/home/abuild/.config/subfinder/config.yaml")
- -pc, -provider-config string
- provider config file (default "/home/abuild/.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
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
- -stats
- report source statistics
OPTIMIZATION:¶
- -timeout int
- seconds to wait before timing out (default 30)
- -max-time int
- minutes to wait for enumeration results (default 10)
| October 2025 | subfinder 2.9.0 |