andros/maza-ad-blocking
1
0
Fork 0
mirror of https://github.com/tanrax/maza-ad-blocking.git synced 2024-09-20 00:17:21 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Andros Fenollosa 2020-08-23 19:07:44 +02:00 committed by GitHub
parent d7d5346408
commit 916e00c2f6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 80 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

87
README.md
View File

@ -82,15 +82,17 @@ sudo rm /usr/local/bin/maza && sudo rm -r ~/.maza
## DNSMASQ ## 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 macOS. 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.
### 1 Install ### MacOS
#### 1 Install
```bash ```bash
brew install dnsmasq brew install dnsmasq
``` ```
### 2 Configure #### 2 Configure
Edit the file. Edit the file.
@ -98,12 +100,18 @@ Edit the file.
/usr/local/etc/dnsmasq.conf /usr/local/etc/dnsmasq.conf
``` ```
Add the following lines. Add the following line at the end.
``` ```
conf-file=(your user path)/.maza/dnsmasq.conf conf-file=(your user path)/.maza/dnsmasq.conf
``` ```
Example
```
conf-file=/Users/myuser/.maza/dnsmasq.conf
```
Start DNSMASQ. Start DNSMASQ.
```bash ```bash
@ -111,7 +119,7 @@ sudo brew services stop dnsmasq
sudo brew services start dnsmasq sudo brew services start dnsmasq
``` ```
### 3 Tell your OS to use your DNS server #### 3 Tell your OS to use your DNS server
Delete the list of macOS 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. Delete the list of macOS 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.
@ -129,6 +137,71 @@ Refresh your DNS cache
sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder
``` ```
#### 4 Restart/Start Maza
```bash
sudo maza stop
sudo maza start
```
### Debian/Ubuntu with Gnome Shell
#### 1 Install
```bash
sudo apt update
sudo apt install dnsmasq
```
#### 2 Configure
Edit file in path.
```
/etc/dnsmasq.conf
```
Add the following line at the end.
```
conf-file=(your user path)/.maza/dnsmasq.conf
```
Example
```
conf-file=/home/myuser/.maza/dnsmasq.conf
```
Start DNSMASQ.
```bash
sudo systemctl stop dnsmasq
sudo systemctl start dnsmasq
sudo systemctl enable dnsmasq
```
#### 3 Tell your OS to use your DNS server
In Gnome Shell, open `Settings->Nework`. Click in the sprocket of your connection.
<img alt="network macos" src="media/network-gnome.png" width="500">
Add your local server (dnsmasq), and the other 2 belong to OpenDNS, which you can use any other.
```bash
127.0.0.1,208.67.222.222,208.67.220.220
```
<img alt="network macos" src="media/dns-gnome.png" width="500">
#### 4 Restart/Start Maza
```bash
sudo maza stop
sudo maza start
```
### Bonus: dnsmasq is in charge of solving all DNS ### Bonus: dnsmasq is in charge of solving all DNS
Add in configure file: `/usr/local/etc/dnsmasq.conf` Add in configure file: `/usr/local/etc/dnsmasq.conf`
@ -139,9 +212,9 @@ server=208.67.222.222
server=208.67.220.220 server=208.67.220.220
``` ```
### Bonus: dnsmasq have test domains ### Bonus: dnsmasq have `localhost` domains
If you want all your `.localhost` domains, for example, point to localhost add in configure file: `/usr/local/etc/dnsmasq.conf` If you want all your `.localhost` domains, for example, point to localhost add in configure file: `/usr/local/etc/dnsmasq.conf` or `/etc/dnsmasq.conf`.
``` ```
address=/.localhost/127.0.0.1 address=/.localhost/127.0.0.1