Skip to content
/ afdns Public

Ad free DNS server. A docker container with a DNS server configured to block advertisement hosts.

License

Notifications You must be signed in to change notification settings

Kolyunya/afdns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ad free DNS server

Description

A docker container with a DNS server configured to block advertisement hosts.

Installation

Just start the container and you are good to go. Absolutely no configuration is required.

If you have docker-compose:

docker-compose up --detach

If you only have docker:

docker run \
    --name afdns \
    --publish 53:53/tcp \
    --publish 53:53/udp \
    --mount type=volume,source=afdns_data,target=/etc/bind \
    --restart always \
    --tty \
    --detach \
    kolyunya/afdns

Automatic blacklist source selection

You can select the source to get automatic blacklist from. After running any of the following commands the automatic blacklist will be updated and the corresponding source will be set as default. The following updates via cron job will use that source.

  • docker exec afdns afdns-update-ahf - update automatic blacklist from amalgamated hosts file.
  • docker exec afdns afdns-update-hph - update automatic blacklist from hpHosts.

Custom blacklist management

The server also has a manual blacklist. The following commands let you manage it.

  • docker exec afdns afdns-host-add ad.example.com - add ad.example.com to the manual blacklist.
  • docker exec afdns afdns-host-remove ad.example.com - remove ad.example.com from the manual blacklist.

Default configuration details

  • DNS server utilized in this container is BIND 9.
  • Automatic blacklist is retrieved from amalgamated hosts file once a day.
  • All non-advertisement request are forwarded to 8.8.8.8 and 8.8.4.4.
  • Response rate limit is set to 8 per second (to mitigate DNS amplification attack).

Ad free VPN

This DNS server is incorporated in the ad free VPN server.

About

Ad free DNS server. A docker container with a DNS server configured to block advertisement hosts.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published