httpx CLI Playbook
Official docs:
Canonical syntax:
httpx [flags]
High-signal flags:
-u, -target <url> single target
-l, -list <file> target list
-nf, -no-fallback probe both HTTP and HTTPS
-nfs, -no-fallback-scheme do not auto-switch schemes
-sc status code
-title page title
-server, -web-server server header
-td, -tech-detect technology detection
-fr, -follow-redirects follow redirects
-mc <codes> / -fc <codes> match or filter status codes
-path <path_or_file> probe specific paths
-p, -ports <ports> probe custom ports
-proxy, -http-proxy <url> proxy target requests
-tlsi, -tls-impersonate experimental TLS impersonation
-j, -json JSONL output
-sr, -store-response store request/response artifacts
-srd, -store-response-dir <dir> custom directory for stored artifacts
-silent compact output
-rl <n> requests/second cap
-t <n> threads
-timeout <seconds> request timeout
-retries <n> retry attempts
-o <file> output file
Agent-safe baseline for automation:
httpx -l hosts.txt -sc -title -server -td -fr -timeout 10 -retries 1 -rl 50 -t 25 -silent -j -o httpx.jsonl
Common patterns:
- Quick live+fingerprint check:
httpx -l hosts.txt -sc -title -server -td -silent -o httpx.txt
- Probe known admin paths:
httpx -l hosts.txt -path /,/login,/admin -sc -title -silent -j -o httpx_paths.jsonl
- Probe both schemes explicitly:
httpx -l hosts.txt -nf -sc -title -silent
- Vhost detection pass:
httpx -l hosts.txt -vhost -sc -title -silent -j -o httpx_vhost.jsonl
- Proxy-instrumented probing:
httpx -l hosts.txt -sc -title -proxy http://127.0.0.1:48080 -silent -j -o httpx_proxy.jsonl
- Response-storage pass for downstream content parsing:
httpx -l hosts.txt -fr -sr -srd recon/httpx_store -sc -title -server -cl -ct -location -probe -silent
Critical correctness rules:
- For machine parsing, prefer
-j -o <file>.
- Keep
-rl and -t explicit for reproducible throughput.
- Use
-nf when you need dual-scheme probing from host-only input.
- When using
-path or -ports, keep scope tight to avoid accidental scan inflation.
- Use
-sr -srd <dir> when later steps need raw response artifacts (JS/route extraction, grepping, replay).
Usage rules:
- Use
-silent for pipeline-friendly output.
- Use
-mc/-fc when downstream steps depend on specific response classes.
- Prefer
-proxy flag over global proxy env vars when only httpx traffic should be proxied.
- Do not use
-h/--help for routine runs unless absolutely necessary.
Failure recovery:
- If too many timeouts occur, reduce
-rl/-t and/or increase -timeout.
- If output is noisy, add
-fc filters or -fd duplicate filtering.
- If HTTPS-only probing misses HTTP services, rerun with
-nf (and avoid -nfs).
If uncertain, query web_search with:
site:docs.projectdiscovery.io httpx <flag> usage
1---2name: strix-httpx3description: Strix httpx 探测命令手册,覆盖探针参数、输出格式与自动化安全用法;触发名:strix-httpx4---56# httpx CLI Playbook78Official docs:9- https://docs.projectdiscovery.io/opensource/httpx/usage10- https://docs.projectdiscovery.io/opensource/httpx/running11- https://github.com/projectdiscovery/httpx1213Canonical syntax:14`httpx [flags]`1516High-signal flags:17- `-u, -target <url>` single target18- `-l, -list <file>` target list19- `-nf, -no-fallback` probe both HTTP and HTTPS20- `-nfs, -no-fallback-scheme` do not auto-switch schemes21- `-sc` status code22- `-title` page title23- `-server, -web-server` server header24- `-td, -tech-detect` technology detection25- `-fr, -follow-redirects` follow redirects26- `-mc <codes>` / `-fc <codes>` match or filter status codes27- `-path <path_or_file>` probe specific paths28- `-p, -ports <ports>` probe custom ports29- `-proxy, -http-proxy <url>` proxy target requests30- `-tlsi, -tls-impersonate` experimental TLS impersonation31- `-j, -json` JSONL output32- `-sr, -store-response` store request/response artifacts33- `-srd, -store-response-dir <dir>` custom directory for stored artifacts34- `-silent` compact output35- `-rl <n>` requests/second cap36- `-t <n>` threads37- `-timeout <seconds>` request timeout38- `-retries <n>` retry attempts39- `-o <file>` output file4041Agent-safe baseline for automation:42`httpx -l hosts.txt -sc -title -server -td -fr -timeout 10 -retries 1 -rl 50 -t 25 -silent -j -o httpx.jsonl`4344Common patterns:45- Quick live+fingerprint check:46 `httpx -l hosts.txt -sc -title -server -td -silent -o httpx.txt`47- Probe known admin paths:48 `httpx -l hosts.txt -path /,/login,/admin -sc -title -silent -j -o httpx_paths.jsonl`49- Probe both schemes explicitly:50 `httpx -l hosts.txt -nf -sc -title -silent`51- Vhost detection pass:52 `httpx -l hosts.txt -vhost -sc -title -silent -j -o httpx_vhost.jsonl`53- Proxy-instrumented probing:54 `httpx -l hosts.txt -sc -title -proxy http://127.0.0.1:48080 -silent -j -o httpx_proxy.jsonl`55- Response-storage pass for downstream content parsing:56 `httpx -l hosts.txt -fr -sr -srd recon/httpx_store -sc -title -server -cl -ct -location -probe -silent`5758Critical correctness rules:59- For machine parsing, prefer `-j -o <file>`.60- Keep `-rl` and `-t` explicit for reproducible throughput.61- Use `-nf` when you need dual-scheme probing from host-only input.62- When using `-path` or `-ports`, keep scope tight to avoid accidental scan inflation.63- Use `-sr -srd <dir>` when later steps need raw response artifacts (JS/route extraction, grepping, replay).6465Usage rules:66- Use `-silent` for pipeline-friendly output.67- Use `-mc/-fc` when downstream steps depend on specific response classes.68- Prefer `-proxy` flag over global proxy env vars when only httpx traffic should be proxied.69- Do not use `-h`/`--help` for routine runs unless absolutely necessary.7071Failure recovery:72- If too many timeouts occur, reduce `-rl/-t` and/or increase `-timeout`.73- If output is noisy, add `-fc` filters or `-fd` duplicate filtering.74- If HTTPS-only probing misses HTTP services, rerun with `-nf` (and avoid `-nfs`).7576If uncertain, query web_search with:77`site:docs.projectdiscovery.io httpx <flag> usage`