search

Alon-L / dns-adblocker

Block ads on the entire network by configuring a machine running this application as the DNS server
1 stars 0 forks source link

readme

DNS AdBlocker

Block ads on the entire network by configuring a machine running this application as the DNS server.

The application bridges DNS packets to the real DNS server, but first filters them by looking at a huge list of ad providers' domains.

Running

Run the program with root privileges (required for opening the socket):

sudo mix run

Configure the machine to be the default network's DNS server.

Configuration

Create a config/runtime.exs file with the following content:

import Config
config :dns_adblocker, :remote_dns_ip, "<REMOTE_DNS_IP>"
config :dns_adblocker, :remote_dns_port, <REMOTE_DNS_PORT>

Replace <REMOTE_DNS_IP> and <REMOTE_DNS_PORT> with the IP and port of the actual DNS server. The IP should be formatted as X.X.X.X and the port should be an integer.