adam

gohperhole

Like Pi Hole but for gophers.

Go to file

Adam Veldhousen abb4c3cd29 test		4 years ago
deployment	test	4 years ago
.gitignore	initial commit	4 years ago
Dockerfile	add flags for bind addresses	4 years ago
LICENSE	readme, license	4 years ago
README.md	added a bunch of crap	4 years ago
blocklists.go	add flags for bind addresses	4 years ago
blocklists_test.go	fix tests added http module	4 years ago
config.go	added a bunch of crap	4 years ago
config.json	added a bunch of crap	4 years ago
dns.go	some refactoring	4 years ago
go.mod	readme, license	4 years ago
go.sum	initial commit	4 years ago
http.go	added a bunch of crap	4 years ago
main.go	added a bunch of crap	4 years ago
makefile	some refactoring	4 years ago

README.md

Gopherhole

Go built DNS server for blocking ads. Like Pi-hole but for hackers.

Works with Pi-hole block lists.

Find more Pi-Hole compatible block lists here: https://firebog.net/

Has support for custom DNS records and block lists.
Supports custom upstream DNS servers for recursively resolving domains.
Supports reloading block lists via HTTP API.
Setting to use hosts file as upstream
Generate example config command.
Supports adding block lists and records via HTTP API.
Prometheus metrics support.
HTTP JSON API metrics.
DNS over HTTPS.

How to use

go get git.vdhsn.com/adam/gopherhole

run like so:

gopherhole -config ./config.json -bind-http 127.0.0.1 -bind-dns 127.0.0.1 -block-forward-ip 127.0.0.1

example config.json file below:

{
    "upstream": [ "1.1.1.1", "8.8.8.8" ],
    "records": {
        "mynas.internal": { "Type": "A", "Record": "192.168.0.99" },
        "eyeofsauron.com": { "Type": "CNAME", "Record": "www.google.com" }
    },
    "blocklists": [
        "https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts",
        "https://s3.amazonaws.com/lists.disconnect.me/simple_ad.txt",
        "https://s3.amazonaws.com/lists.disconnect.me/simple_tracking.txt"
    ]
}

License

GPL-V3