alextts627 / adburner-dns

DNS based ad blocker with DNS over HTTPS support.

adburner

Simple DNS based ad blocker with DNS over HTTPS support.

Running

adburner can be run on a Raspberry Pi or any other system with docker installed.

• Set up static IP and DNS on the device running the adburner server
• Change the DNS on your router to the IP address of the device running the adburner server

1. With docker

Set environment variables in .env file. Check below for available configurations.

For x86 servers

docker run -d \
  --env-file .env \
  -p 53:53/udp \
  subash/adburner-dns

For arm servers such as raspberry pi

docker run -d \
  --env-file .env \
  -p 53:53/udp \
  subash/adburner-dns:arm

2. With docker-compose

Set environment variables in .env file. Check below for available configurations.

For x86 servers

services:
  adburner:
    image: "subash/adburner-dns"
    restart: "always"
    env_file: ".env"
    ports:
      - "53:53/udp"

For arm servers such as Raspberry Pi

services:
  adburner:
    image: "subash/adburner-dns:arm"
    restart: "always"
    env_file: ".env"
    ports:
      - "53:53/udp"

Configuration

By default adburner uses both CloudFlare and Google DNS concurrently and picks whichever is faster.

DNS_OVER_HTTPS=true
HTTPS_REMOTE_ADDRESS=https://cloudflare-dns.com/dns-query,https://dns.google.com/experimental
UDP_REMOTE_ADDRESS=1.1.1.1,8.8.8.8
BLOCKED_HOSTS_URL=https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts

Notes:

1. DNS over HTTPS is only used to query upstream servers. adburner itself can only resolve udp queries.
2. Check https://github.com/StevenBlack/hosts for the list of blocked hosts