Skip to content

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

License

Notifications You must be signed in to change notification settings

soulteary/hosts-blackhole

Repository files navigation

Hosts Blackhole

Security Scan Release

License: Apache v2

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

Data sources Supported

Currently supported data sources:

ProjectFiles
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

About

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

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Packages

No packages published