Skip to content

The DNS proxy I didn't want to write, but that I had to write since everything else just sucks.

License

Notifications You must be signed in to change notification settings

depau/shitty-dns-proxy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Shitty DNS proxy

The DNS proxy I didn't want to write, but that I had to write since everything else just sucks.

Adapted from the following projects:

Use DOCKER_BUILDKIT=1 docker build . to build the image, or docker-compose without special requirements.

What it does

It listens for plain old DNS requests and it forwards them to a DNS-over-HTTP(S) server of your choice.

It sets the X-Forwarded-For header to the IP address of the client that sent the request. This is useful to forward the request to Adguard Home and be able to see which client made the request.

It also replies to requests to hosts found in specified /etc/hosts-like files.

Hosts file format

The hosts file format is the same as the one used by /etc/hosts, with some extra features:

  • Comments are allowed, and they start with a # character.
  • All whitespace is ignored.
  • You can define CNAME-like entries by using a domain name as the target of an entry, prefixed by a @ character.

Example:

# This is a comment
123.45.67.89    example.com       # This is also a comment
@example.com    example.org       # This also resolves to 123.45.67.89
@google.com     google-alias.com  # This resolves to whatever google.com resolves to

License

"Just do whatever you want with it, I didn't want to write this in the first place", MIT license.

About

The DNS proxy I didn't want to write, but that I had to write since everything else just sucks.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published