{"id":23539527,"url":"https://github.com/st3v3nmw/beacon-dns","last_synced_at":"2025-04-23T17:28:52.200Z","repository":{"id":267358615,"uuid":"844097742","full_name":"st3v3nmw/beacon-dns","owner":"st3v3nmw","description":"A DNS resolver with customizable \u0026 schedulable filtering for malware, trackers, ads, and other unwanted content","archived":false,"fork":false,"pushed_at":"2025-02-02T16:18:10.000Z","size":541,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-30T01:51:50.213Z","etag":null,"topics":["ad-blocker","adblock","beacon-dns","dns","dns-cache","dns-resolver","dns-server","golang","parental-control","self-hosted"],"latest_commit_sha":null,"homepage":"https://www.stephenmwangi.com/beacon-dns/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/st3v3nmw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-08-18T11:30:11.000Z","updated_at":"2025-02-06T07:19:11.000Z","dependencies_parsed_at":"2024-12-09T22:29:42.038Z","dependency_job_id":"dc7dd65f-0f25-407c-ba5c-8662603ae9b5","html_url":"https://github.com/st3v3nmw/beacon-dns","commit_stats":null,"previous_names":["st3v3nmw/beacon-dns"],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/st3v3nmw%2Fbeacon-dns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/st3v3nmw%2Fbeacon-dns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/st3v3nmw%2Fbeacon-dns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/st3v3nmw%2Fbeacon-dns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/st3v3nmw","download_url":"https://codeload.github.com/st3v3nmw/beacon-dns/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250479911,"owners_count":21437455,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ad-blocker","adblock","beacon-dns","dns","dns-cache","dns-resolver","dns-server","golang","parental-control","self-hosted"],"created_at":"2024-12-26T04:37:44.337Z","updated_at":"2025-04-23T17:28:52.193Z","avatar_url":"https://github.com/st3v3nmw.png","language":"Go","funding_links":["https://ko-fi.com/M4M44DEN6'"],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003cimg src=\"docs/media/logo.png\" width=\"100\" /\u003e\n    \u003ch1\u003eBeacon DNS\u003c/h1\u003e\n    \u003cp\u003e\u003ci\u003eRuns on a single vCPU, a small hill of RAM, and pure determination.\u003c/i\u003e\u003c/p\u003e\n\u003c/div\u003e\n\nA DNS resolver with customizable \u0026 schedulable filtering for malware, trackers, ads, and other unwanted content.\n\n## Features\n\n- **Blocking**\n    - Supports blocking of ads, malware, adult content, dating \u0026 social media sites, video streaming platforms, and [other content](https://github.com/st3v3nmw/beacon-dns/blob/main/internal/config/sources.go)\n    - Blocking can be done network-wide or per device group\n    - Blocking can also be scheduled so that certain content is only blocked at certain times\n- **Caching**\n    - Supports caching of DNS records for up to the record's TTL which speeds up DNS lookups\n    - Supports serving stale DNS records while the record is refreshed in the background\n- **Prefetching**\n    - \"Learns\" your query patterns to prefetch subsequent queries before the device makes them\n- **Client Lookup**\n    - Supports looking up of the client's hostname\n- **Statistics**\n    - Allows you view statistics per device over a given period of time\n- **API**\n    - Allows you to get statistics\n    - Allows you to watch queries live as they're being made\n    - Allows you to get the current config\n\n## Getting Started\n\nGo to [this page](https://www.stephenmwangi.com/beacon-dns/installation) to install and configure Beacon DNS.\n\n## Credits\n\n### Logo\n\n\u003ca href=\"https://www.flaticon.com/free-icons/lighthouse\" title=\"lighthouse icons\"\u003eLogo created by Freepik - Flaticon\u003c/a\u003e\n\n## Support\n\n\u003ca href='https://ko-fi.com/M4M44DEN6' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://cdn.ko-fi.com/cdn/kofi3.png?v=2' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fst3v3nmw%2Fbeacon-dns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fst3v3nmw%2Fbeacon-dns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fst3v3nmw%2Fbeacon-dns/lists"}