andros/maza-ad-blocking
1
0
Fork 0
mirror of https://github.com/tanrax/maza-ad-blocking.git synced 2024-11-25 00:25:41 +01:00
Code Issues Packages Projects Releases Wiki Activity
Local ad blocker. Like Pi-hole but local and using your operating system.
32 Commits 1 Branch 0 Tags 3 MiB
Shell 87.7%
Dockerfile 12.3%
8c21e514af
Go to file
Andros Fenollosa 8c21e514af
Update README.md
2020-02-05 23:18:52 +01:00
media Rename files 2020-01-03 18:02:31 +01:00
LICENSE Initial commit 2020-01-03 07:41:49 +01:00
maza Update maza 2020-01-06 13:18:13 +01:00
README.md Update README.md 2020-02-05 23:18:52 +01:00

README.md

Maza ad blocking

Simple and efficient local ad blocking throughout the network.

maza logo
  • You don't have to install any browser extensions or applications, you just use the tools of your operating system.
  • You update the list of DNS to be blocked with a single stroke.
  • Opensource.
  • Just bash.

🏃‍Run

📡 Update database

maza update

🔨 Start

sudo maza start

🛠 Stop

maza stop

⚖️ Status

maza status

⚙️ Install

👀 Requirements

  • bash 4.0 or higher
  • curl

Then you do this.

curl -o maza https://raw.githubusercontent.com/tanrax/maza-ad-blocking/master/maza && chmod +x maza && sudo mv maza /usr/local/bin

DNSMASQ

Unfortunately the hosts file does not support sub-domains (wildcards), which is necessary to correctly filter all DNS. You will need to install locally a server for that purpose, Maza supports the Dnsmasq format. Here's an example for OSX.

1 Install

brew install dnsmasq

2 Configure

Edit the file.

/usr/local/etc/dnsmasq.conf

Add the following lines.

conf-file=(your user path)/.maza/dnsmasq.conf

Start DNSMASQ.

sudo brew services stop dnsmasq
sudo brew services start dnsmasq

3 Tell your OS to use your DNS server

Delete the list of OSX DNS servers and add the 3 addresses. The first one will be your local server, and the other 2 belong to OpenDNS, which you can use any other.

127.0.0.1
208.67.222.222
208.67.220.220

Refresh your DNS cache

sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder

Extra: dnsmasq is in charge of solving all DNS

Add in confiigure file: /usr/local/etc/dnsmasq.conf

no-resolv
server=208.67.222.222
server=208.67.220.220

Extra: dnsmasq have test domains

If you want all your .localhost domains, for example, point to localhost add in confiigure file: /usr/local/etc/dnsmasq.conf

address=/.localhost/127.0.0.1

⚠️ CAUTION

  • Only compatible with Linux and OSX operating systems.
  • Remember to make a backup copy of /etc/hosts in case of unforeseen circumstances, neither the project nor its author will be responsible for any possible repercussions derived from not carrying out this action.