mirror of
https://github.com/tanrax/maza-ad-blocking.git
synced 2024-12-22 18:05:34 +01:00
Local ad blocker. Like Pi-hole but local and using your operating system.
media | ||
LICENSE | ||
maza | ||
README.md |
Maza ad blocking
Simple and efficient local ad blocking throughout the network.
- 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
sudo 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.
address=/.localhost/127.0.0.1
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
⚠️ 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.