Tiny replacement for piHole DNS filter
 
 
Go to file
bloved 945709f24e - config:
- more sanity checks
  - added localresponder: if set use specified DNS server for local domains
  - ipaliases is now used in DNS responses (works same as /etc/hosts file)
- ForwardQuery(): accept param to avoid cache
2021-01-13 23:38:33 +01:00
vendor first commit 2020-10-08 22:14:07 +02:00
.gitignore first commit 2020-10-08 22:14:07 +02:00
00.database.go - WIP: 2021-01-12 00:04:34 +01:00
00.memory.go first commit 2020-10-08 22:14:07 +02:00
01.conf.go - config: 2021-01-13 23:38:33 +01:00
01.dnscheck.go first commit 2020-10-08 22:14:07 +02:00
01.killfile.go - killfile stats: incremented only when adding a new domain in BL 2021-01-12 13:35:36 +01:00
01.stats.go first commit 2020-10-08 22:14:07 +02:00
02.cache.go first commit 2020-10-08 22:14:07 +02:00
Dockerfile.amd64 first commit 2020-10-08 22:14:07 +02:00
Dockerfile.arm32v7 first commit 2020-10-08 22:14:07 +02:00
Dockerfile.arm64v8 first commit 2020-10-08 22:14:07 +02:00
LICENSE first commit 2020-10-08 22:14:07 +02:00
README.md first commit 2020-10-08 22:14:07 +02:00
adlist_hosts.go - config: 2021-01-13 23:38:33 +01:00
adlist_single.go - config: 2021-01-13 23:38:33 +01:00
config.json - config: 2021-01-13 23:38:33 +01:00
dns-upstream.txt first commit 2020-10-08 22:14:07 +02:00
dns_client.go - config: 2021-01-13 23:38:33 +01:00
dns_handler.go - config: 2021-01-13 23:38:33 +01:00
go.mod first commit 2020-10-08 22:14:07 +02:00
go.sum first commit 2020-10-08 22:14:07 +02:00
hostfile.go - config: 2021-01-13 23:38:33 +01:00
main.go - config: 2021-01-13 23:38:33 +01:00
urls-domains.txt first commit 2020-10-08 22:14:07 +02:00
urls-hosts.txt first commit 2020-10-08 22:14:07 +02:00
urls-local.txt first commit 2020-10-08 22:14:07 +02:00

README.md

zabov

Tiny replacement for piHole DNS filter

Still Work in progress, usable.

Idea is to produce a very simple, no-web-interface , IP DNS blocker.

INSTALL

Zabov requires golang 1.13 or later.

git clone https://git.keinpfusch.net/Loweel/zabov.git
cd zabov
go get
go build -mod=vendor

Then, edit config.json: please notice config.json must be in the same folder of the executable you run.

Just a few words about "singlefilters" and "doublefilters":

Data must be downloaded from URLs of blacklist mantainers.They may come in different formats.

There are two kinds of blacklists:

One is the format zabov calls "singlefilter", where we find a single column , full of domains:

domain1.com
domain2.com
domain3.com

The second is the format zabov calls "doublefilter" (a file in "/etc/hosts" format, to be precise), where there is an IP, usually localhost or 0.0.0.0 and then the domain:

127.0.0.1 domain1.com
127.0.0.1 domain2.com
127.0.0.1 domain3.com

This is why configuration file has two separated items.

The config file should look like:

{
    "zabov": {  
        "port":"53", 
        "proto":"udp", 
        "ipaddr":"127.0.0.1",
        "upstream":"./dns-upstream.txt",
        "cachettl": "4",
        "killfilettl": "12",
        "singlefilters":"./urls-hosts.txt" ,
        "doublefilters":"./urls-domains.txt", 
        "blackholeip":"127.0.0.1",
        "hostsfile":"./urls-local.txt"
    }

}



Where:

  • port is the port number. Usually is 53, you can change for docker, if you like
  • proto is the protocol. Choices are "udp", "tcp", "tcp/udp"
  • ipaddr is the port to listen to. Maybe empty, (which will result in listening to 0.0.0.0) to avoid issues with docker.
  • upstream: file containing all DNS we want to query : each line in format IP:PORT
  • cachettl: amount of time the cache is kept (in hours)
  • killfilettl: refresh time for killfiles
  • singlefilters: name of the file for blacklists following the "singlefilter" schema.(one URL per line)
  • doublefilters: name of the file, for blacklists following the "doublefilter" schema.(one URL per line)
  • blackholeip: IP address to return when the IP is banned. This is because you may want to avoid MX issues, mail loops on localhost, or you have a web server running on localhost
  • hostsfile: path where you keep your local blacklistfile : this is in the format "singlefilter", meaning one domain per line, unlike hosts file.

DOCKER

Multistage Dockerfiles are provided for AMD64, ARMv7, ARM64V8

TODO:

  • caching
  • monitoring port