slowdns

command module
v0.0.0-...-20b3c12 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Mar 3, 2023 License: GPL-3.0 Imports: 16 Imported by: 0

README

SlowDNS, a deliberately slow DNS proxy

SlowDNS proxies DNS over UDP, with two configurable block levels.

  1. Hard: Domains resolve to 0.0.0.0, a la pi-hole.
  2. Soft: After a 30 second delay, the domains resolve normally.

Hard blocking is useful to block trackers, ads, and other bloat.

Soft blocking is useful to retrain learned browsing habits for instant gratification.

Build, run

The server can be built and run with

go install github.com/NevermoreSSH/slowdns
export PORT=53 DNSSERVERS=8.8.8.8
slowdns

Alternatively, you can use the provided Dockerfile and Makefile:

make docker-run
# In another tab...
dig example.com @localhost

See conf/ for example configuration for Kubernetes.

Disclaimers

I built this as a means to an end. It is not high quality and you should not depend on it.

  • Not RFC compliant. My reference was Wireshark packet dumps.
  • Potentially not your-home-network compliant.
  • Reddit, Hacker News, and Instagram are hardcoded to soft block.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
pkg
dns

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL