Skip to content
This repository has been archived by the owner on Mar 17, 2021. It is now read-only.

Latest commit

 

History

History
48 lines (38 loc) · 1.35 KB

readme.md

File metadata and controls

48 lines (38 loc) · 1.35 KB
Raw

adburner

Simple DNS based ad blocker with DNS over HTTPS support.

Dependencies GitHub

Running

  • Install Docker
  • 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.

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

2. With docker-compose

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

services:
  adburner:
    image: "subash/adburner-dns"
    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/dns-query
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