Skip to content

Latest commit

 

History

History
34 lines (29 loc) · 1.37 KB

README.md

File metadata and controls

34 lines (29 loc) · 1.37 KB
Raw

labDNS

DNS Server that returns records based on lookups in configured storage.

This tool provides an intercepting DNS server that allows to override DNS query results for a defined zone. The results are looked up in the configured storage (currently supporting dict, Redis and Consul). It is possible to specify custom functions to create lookup keys and to process the results.

Usage

For the usage please refer to labDNS --help. Note that config option expects json input that is used to init storages. usage: labDNS [-h] [--storage STORAGE] [--config CONFIG] [--zone ZONE] [--ttl TTL] [--log LOG] [--port PORT] [--address ADDRESS] [--keymaker KEYMAKER] [--processor PROCESSOR] [--upstream UPSTREAM] [--bypass BYPASS [BYPASS ...]]

Database lookup based DNS resolver

optional arguments:
  -h, --help            show this help message and exit
  --storage STORAGE, -s STORAGE
  --config CONFIG, -c CONFIG
  --zone ZONE, -z ZONE
  --ttl TTL, -t TTL
  --log LOG, -l LOG
  --port PORT, -p PORT
  --address ADDRESS, -a ADDRESS
  --keymaker KEYMAKER, -k KEYMAKER
  --processor PROCESSOR
  --upstream UPSTREAM, -u UPSTREAM
  --bypass BYPASS [BYPASS ...], -b BYPASS [BYPASS ...]

Example

labDNS --zone "*.foo.bar.com" --port 53 -s labDNS.storages.RedisStorage --keymaker labDNS.keymakers.client_ip --processor labDNS.processors.resolve --upstream 8.8.8.8