https://github.com/st3v3nmw/beacon-dns

A DNS resolver with customizable & schedulable filtering for malware, trackers, ads, and other unwanted content
https://github.com/st3v3nmw/beacon-dns

ad-blocker adblock beacon-dns dns dns-cache dns-resolver dns-server golang parental-control self-hosted

Last synced: about 1 year ago
JSON representation

A DNS resolver with customizable & schedulable filtering for malware, trackers, ads, and other unwanted content

• Host: GitHub
• URL: https://github.com/st3v3nmw/beacon-dns
• Owner: st3v3nmw
• License: mit
• Created: 2024-08-18T11:30:11.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2025-02-02T16:18:10.000Z (over 1 year ago)
• Last Synced: 2025-03-30T01:51:50.213Z (about 1 year ago)
• Topics: ad-blocker, adblock, beacon-dns, dns, dns-cache, dns-resolver, dns-server, golang, parental-control, self-hosted
• Language: Go
• Homepage: https://www.stephenmwangi.com/beacon-dns/
• Size: 528 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


    

    
Beacon DNS

    
Runs on a single vCPU, a small hill of RAM, and pure determination.



A DNS resolver with customizable & schedulable filtering for malware, trackers, ads, and other unwanted content.

## Features

- **Blocking**

    - Supports blocking of ads, malware, adult content, dating & social media sites, video streaming platforms, and [other content](https://github.com/st3v3nmw/beacon-dns/blob/main/internal/config/sources.go)

    - Blocking can be done network-wide or per device group

    - Blocking can also be scheduled so that certain content is only blocked at certain times

- **Caching**

    - Supports caching of DNS records for up to the record's TTL which speeds up DNS lookups

    - Supports serving stale DNS records while the record is refreshed in the background

- **Prefetching**

    - "Learns" your query patterns to prefetch subsequent queries before the device makes them

- **Client Lookup**

    - Supports looking up of the client's hostname

- **Statistics**

    - Allows you view statistics per device over a given period of time

- **API**

    - Allows you to get statistics

    - Allows you to watch queries live as they're being made

    - Allows you to get the current config

## Getting Started

Go to [this page](https://www.stephenmwangi.com/beacon-dns/installation) to install and configure Beacon DNS.

## Credits

### Logo

Logo created by Freepik - Flaticon

## Support