Skip to content

Commit

Permalink
Added additional installation instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
aghorler committed Dec 7, 2017
1 parent b7a52d3 commit 08d0171
Showing 1 changed file with 20 additions and 4 deletions.
24 changes: 20 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,36 @@
## Lightweight DNSMasq Blocklist

This is an **intentionally small** list of advertising and analytic domains for blocking in custom router firmware - such as DD-WRT, LEDE, and Tomato. The list is in DNSMasq configuration format.
This is an **intentionally small** list of advertising and analytic domains for blocking in custom router firmware - such as DD-WRT, LEDE, and Tomato. The list is in dnsmasq configuration format.

The intention of this list is to block common advertising and analytics domains without overwhelming consumer routers with lists containing 5000+ ultra-specific domains.

### Installation

** DNSMasq **
**dnsmasq (General Linux)**

Copy the contents of **[list.txt](https://raw.githubusercontent.com/aghorler/lightweight-dnsmasq-blocklist/master/list.txt)** into `/etc/dnsmasq.conf`.

** DD-WRT **
**LEDE**

Create `/etc/dnsmasq.conf`, and copy the contents of **[list.txt](https://raw.githubusercontent.com/aghorler/lightweight-dnsmasq-blocklist/master/list.txt)** into the file.

Or use wget.

`wget https://raw.githubusercontent.com/aghorler/lightweight-dnsmasq-blocklist/master/list.txt -O /etc/dnsmasq.conf`

Ensure dnsmasq is enabled, and client devices are using **only** the IP address of the router for DNS.

A firewall rule (`Network > Firewal` in the GUI) can be used to force the router be used for DNS.

`iptables -t nat -A PREROUTING -i br-lan -p udp --dport 53 -j DNAT --to 192.168.1.1`

`iptables -t nat -A PREROUTING -i br-lan -p tcp --dport 53 -j DNAT --to 192.168.1.1`

**DD-WRT**

Copy the contents of **[list.txt](https://raw.githubusercontent.com/aghorler/lightweight-dnsmasq-blocklist/master/list.txt)** into `Additional DNSMasq Options` under `Services > Services > DNSMasq` in the DD-WRT Control Panel. Instructions vary for other firmware.

Ensure DNSMasq is enabled, and client devices are using **only** the IP address of the router for DNS.
Ensure dnsmasq is enabled, and client devices are using **only** the IP address of the router for DNS.

---

Expand Down

0 comments on commit 08d0171

Please sign in to comment.