Hosts Blackhole

BEST hosts list processing helper for ad-blocking/blocker programs: AdGuard, AdAway, blocky, grimd...

Data sources Supported

Currently supported data sources:

Project	Files
StevenBlack/hosts	File
quidsup/notrack-blocklists	File1 / File2
AdAway/adaway.github.io	File1 / File2
AdguardTeam/AdGuardSDNSFilter	File

Hosts Count:

 - AdAway default blocklist  =        7038   
 - AdGuard DNS filter        =       45842   
 - StevenBlack/hosts         =      143542   
 - NoTrack Tracker Blocklist =       14698   
 - NoTrack Malware Blocklist =         305  

Docker

You can download images from dockerhub, get up and running quickly:

docker run --rm -it -p 8345:8345 \
    -v `pwd`/data:/data \
    -v `pwd`/cache:/cache \
    soulteary/hosts-blackhole

CLI && ENV

CLI parameters:

  --debug      enable debug mode
  --port int   web port (default 8345)

usage: ./hbh --port=8345 --debug=false

Env variables:

HBH_DEBUG=true
HBH_PORT=1024

usage: HBH_DEBUG=true HBH_PORT=1024 ./hbh

APIs && Pages

API:

• /data/hosts.txt Get data file which contains all domains.
• /ping Health check
• /purge Attempt to reanalyze the data file and generate a cache file

Pages:

• / Homepage
• /list View available data sources
• /data Data source index page
• /stats System stats

Screenshot