dns-blackhole 0.12

Features

• Not bound to a specific DNS server, generates a file format of your choice

• Supports 3 different list format

  • Host file

  • Easylist

  • Disconnect

• Lets you whitelist/blacklist domains

• YAML configuration file

Installation

The script requires PyYAML and requests modules.

pip install [--upgrade] dns-blackhole

zone_data: 'local-zone: "{domain}" always_nxdomain'

zone_data: '{domain}='

zone_data: 'server=/{domain}/'

zone_data: '127.0.0.1 {domain}'

Configuration

As the configuration file is in YAML, you can use YAML anchors

dns-blackhole:
  general:
    cache: /var/cache/dns-blackhole
    log: /var/log/dns-blackhole/dns-blackhole.log
    whitelist: /etc/dns-blackhole/whitelist
    blacklist: /etc/dns-blackhole/blacklist
    blackhole_lists:
      hosts:
        - http://someonewhocares.org/hosts/hosts
        - https://hosts-file.net/download/hosts.txt
        - http://winhelp2002.mvps.org/hosts.txt
        - http://www.malwaredomainlist.com/hostslist/hosts.txt
        - https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts;showintro=0
      easylist: &bh_easy
        - https://easylist.to/easylist/easylist.txt
        - https://raw.githubusercontent.com/paulgb/BarbBlock/master/BarbBlock.txt
      disconnect: &bh_disconnect
        url: https://services.disconnect.me/disconnect-plaintext.json
        categories: # Advertising, Analytics, Disconnect, Social
          - Advertising
          - Analytics
  config:
    zone_file: /etc/unbound/blackhole.zone
    # {domain} will be replaced by the blackholed domain, do not change it here
    zone_data: 'local-zone: "{domain}" always_nxdomain'
    blackhole_lists:
      hosts:
        - http://winhelp2002.mvps.org/hosts.txt
      easylist: *bh_easy
      disconnect: *bh_disconnect

In this example you would keep easylist and disconnect lists, but would remove all host file lists except mvps.

FAQ

TODO

• Cache is not implemented yet

• Log is not implemented yet