Skip to content

NoahFeldt/DNS-Sinky

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

DNS-Sinky

A simple DNS sinkhole implemented in Rust. It works like a simpler version of pi-hole or AdGuardHome.

Features

DNS-Sinky has the following features:

  • Blocking of DNS requests whose domain names are contained in blacklists.

  • Configuration of blacklists in config.json file.

  • Downloading and local storage of DNS blacklists.

  • Logging DNS request activity to terminal.

Installation

You can build the project yourself using the Rust compiler:

cargo build --release

Alternatively you can download a pre-compiled version under releases.

Usage

If you have the Rust compiler installed you can simply build and run with:

cargo run --release

If you downloaded the pre-compiled files, simply run the dns_sinky.exe file.

Configuration

The DNS sinkhole can be configured by changing the values in the config.json file.

  • You can change the urls of the DNS blacklists by changing the urls field. The default blacklists are from firebog.net where the ticked lists are used.

  • You can automatically update the lists on startup by activating the update_on_startup value. The default setting is false.

  • You can change the upstream DNS server with the upstream_dns value. The default address is 1.1.1.1 by Cloudflare.