Scroll to navigation

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:

domains to find subdomains for
file containing list of domains for subdomain discovery

SOURCE:

specific sources to use for discovery (-s crtsh,github). Use -ls to display all available sources.
use only sources that can handle subdomains recursively rather than both recursive and non-recursive sources
use all sources for enumeration (slow)
sources to exclude from enumeration (-es alienvault,zoomeyeapi)

FILTER:

subdomain or list of subdomain to match (file or comma separated)
subdomain or list of subdomain to filter (file or comma separated)

RATE-LIMIT:

maximum number of http requests to send per second (global)
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"])
number of concurrent goroutines for resolving (-active only) (default 10)

UPDATE:

update subfinder to latest version
disable automatic subfinder update check

OUTPUT:

file to write output to
write output in JSONL(ines) format
directory to write output (-dL only)
include all sources in the output (-json only)
include host IP in output (-active only)

CONFIGURATION:

flag config file (default "/home/abuild/.config/subfinder/config.yaml")
provider config file (default "/home/abuild/.config/subfinder/provider-config.yaml")
comma separated list of resolvers to use
file containing list of resolvers to use
display active subdomains only
http proxy to use with subfinder
exclude IPs from the list of domains

DEBUG:

show only subdomains in output
show version of subfinder
show verbose output
disable color in output
list all available sources
report source statistics

OPTIMIZATION:

seconds to wait before timing out (default 30)
minutes to wait for enumeration results (default 10)
October 2025 subfinder 2.9.0