Generate domain sinkhole (blacklist) files for DNSCrypt & pdnsd DNS servers
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Pekka Helenius 549bbba1e6
Code: add license statement
5 years ago
data Code: add license statement 5 years ago
images Re-upload the sample image 5 years ago
LICENSE Initial commit 5 years ago
README.md README: Formatting 5 years ago

README.md

DNS sinkhole

Generate domain sinkhole (blacklist) files for DNSCrypt and pdnsd DNS servers. Comparable to Pi-Hole, but uses more simple structure without too much overhead. Generated blacklist files can be added to existing DNS server installations.


Usage

Add blacklists and whitelists as you wish into the python script. Once done, run the script with Python 3. The script generates necessary files for you to adapt to your DNS servers.


Developer's notice

Benefits:

Useful for blocking ads, tracking & telemetry on:

  • single device with a DNS server

  • on a full network segment if a centralized DNS server is used (multiple devices)

  • applies to IoT devices (+ SmartTVs etc.) if traffic is routed via a centralized DNS server applying this sinkhole/blacklist policy

NOTE (Tor users): These lists do not work with SOCKS5/HTTP Tor connections, as DNS resolution is done on the Tor exit nodes, not by your DNS server(s).

Tested on

Arch Linux (x86_64):           DNSCrypt server, pdnsd server
Android (mobile phone, ARMv7): DNSCrypt server

About used list formats

pdnsd

Although pdnsd offers neg feature, it is not very reliable with large DNS blocklists. However, custom rr (Resource Record) entries have been tested with a list of over 240 000 blacklisted domains, and it works as expected.

DNSCrypt

Although DNSCrypt offers blacklist feature, it is not very reliable with large DNS blocklists. However, cloaking list has been tested with a list of over 240 000 blacklisted domains, and it works as expected.


License

This repository uses MIT license. See LICENSE file for details.