Updated Jul 14, 2026

Network

Curate a trusted public resolver pool

Keep only IPv4 resolvers that match baseline answers.

Agent

overview

What dnsvalidator-patch does

Slot dnsvalidator-patch ahead of massdns, shuffledns, or puredns so every resolve stage consumes a vetted resolver list rather than a raw public dump.

When a brute force returns hosts that do not exist, rebuild the pool. Candidates arrive via -tL or -t; drop known-bad addresses with -eL or -e before verification.

Each candidate is checked against baselines for a known host and a name that should NXDOMAIN. Only servers whose positive answer and NXDOMAIN both match land in the FILE and FOLDER outputs.

source github.com/vortexau/dnsvalidator

use cases

Where dnsvalidator-patch fits

Curate resolvers for mass resolution

Validate a public DNS pool against baselines and emit only the accurate servers so massdns or puredns brute-forces from a list you trust.

Refresh the resolver pool on a schedule

Run the node on a schedule so the validated list keeps pace with public resolvers going offline or turning unreliable.

Keep known-bad servers out

Feed an exclusions list with -eL, or drop single addresses with -e, so resolvers you already distrust never re-enter the set.

Clear false positives from a poisoned resolver

When a brute force returns hosts that do not exist, rebuild the pool from validated servers to strip out the resolver that was injecting answers.

reference

dnsvalidator-patch inputs and flags

10 inputs
NameTypeFlagDescription
targets-listFILE-tLList of DNS servers, or a URL to a list, to verify.
targetSTRING-tA single DNS server to verify.
exclusions-listFILE-eLList of targets to exclude from verification.
root-domain-compareSTRING-rRoot domain to compare against; use a non-geolocated one.
resolver-querySTRING-qResolver query to use (default dnsvalidator).
threadsSTRING-threadsMaximum concurrent threads (default 5).
timeoutSTRING-timeoutTimeout in seconds per thread (default 600).
silentBOOLEAN--silentShow only successfully resolved servers, redacting banners.

Showing key inputs. dnsvalidator-patch exposes 10 inputs in total.

Full flag reference (10 inputs)
NameTypeFlagDescription
silentBOOLEAN--silentIf set then only successfully resolved servers will be displayed and banners and other information will be redacted.
targetSTRING-tSpecify a target DNS server to verify.
threadsSTRING-threadsSpecify the maximum number of threads to run at any one time (default 5).
timeoutSTRING-timeoutSpecify a timeout value in seconds for any single thread (default 600).
no-colorBOOLEAN--no-colorIf set then any foreground or background colours will be stripped out.
exclusionSTRING-eSpecify a target exclusion.
targets-listFILE-tLSpecify a list of targets or a URL to a list of targets.
resolver-querySTRING-qSpecify a resolver query to use (default dnsvalidator).
exclusions-listFILE-eLSpecify a list of targets or a URL to a list of targets to exclude.
root-domain-compareSTRING-rSpecify a root domain to compare to. Must be non-geolocated or most resolvers will fail.

example

Run dnsvalidator-patch

dnsvalidator-patch · command
# verify public resolvers against baselines, keep only the accurate onesdnsvalidator -tL resolvers.txt -eL exclude.txt -threads 20
sample output
[14:22:07] [INFO] [baseline] resolving baseline[14:22:07] [INFO] [198.51.100.10] Checking...[14:22:07] [ACCEPTED] [198.51.100.10] provided valid response[14:22:08] [ACCEPTED] [198.51.100.23] provided valid response[14:22:08] [REJECTED] [203.0.113.44] invalid response received[14:22:09] [ACCEPTED] [198.51.100.61] provided valid response[14:22:09] [REJECTED] [203.0.113.90] invalid response received[14:22:15] [INFO] Finished. Discovered 3 servers

guidance

Choosing dnsvalidator-patch

Use dnsvalidator-patch when you need a validated resolver list and prefer the maintained build for in-workflow runs. It curates resolvers; it does not resolve subdomains. Run it before massdns, shuffledns, or puredns. For the upstream build, use dnsvalidator.

dnsvalidator

Upstream build. This patched version targets reliable execution inside Trickest workflows.

shuffledns

Resolves and brute-forces subdomains. dnsvalidator-patch supplies the trusted resolver list it consumes.

puredns

Resolver with wildcard filtering. dnsvalidator-patch only validates the resolver pool.

faq

dnsvalidator-patch questions

Same behavior and same flags as upstream vortexau/dnsvalidator, packaged as a maintained build for Trickest nodes. If you need the original, the dnsvalidator tool is also on the platform.

Run dnsvalidator-patch yourself

A raw resolver list feeds dnsvalidator-patch, which keeps only accurate servers and hands the clean list to massdns for trustworthy resolution as output.

Facts on this page come from the live Trickest tool library.