{"id":13758840,"url":"https://github.com/relekang/coredns-blocklist","last_synced_at":"2025-05-07T07:22:46.469Z","repository":{"id":37397993,"uuid":"312652696","full_name":"relekang/coredns-blocklist","owner":"relekang","description":"This is a coredns plugin to return NXDOMAIN response for any domain on preloaded lists. It can be useful to block malware domains or trackers.","archived":false,"fork":false,"pushed_at":"2024-05-31T08:00:37.000Z","size":315,"stargazers_count":32,"open_issues_count":2,"forks_count":8,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-06-04T17:09:26.956Z","etag":null,"topics":["adblocking","coredns","dns"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/relekang.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2020-11-13T18:21:46.000Z","updated_at":"2024-06-16T18:36:26.305Z","dependencies_parsed_at":"2023-12-29T10:29:40.981Z","dependency_job_id":"928ccba3-4739-40c8-b7da-8d456edfd249","html_url":"https://github.com/relekang/coredns-blocklist","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relekang%2Fcoredns-blocklist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relekang%2Fcoredns-blocklist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relekang%2Fcoredns-blocklist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/relekang%2Fcoredns-blocklist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/relekang","download_url":"https://codeload.github.com/relekang/coredns-blocklist/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252831542,"owners_count":21810830,"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":["adblocking","coredns","dns"],"created_at":"2024-08-03T13:00:38.127Z","updated_at":"2025-05-07T07:22:46.460Z","avatar_url":"https://github.com/relekang.png","language":"Go","funding_links":[],"categories":["External Plguins"],"sub_categories":[],"readme":"# coredns-blocklist\n\nThis is a [coredns][] plugin to return NXDOMAIN response for any domain\non preloaded lists. It can be useful to block malware domains or trackers.\n\n## Usage\n\nIt is possible to use this plugin with both files from disk and fetch\nfiles from http servers by passing an url. The file should contain one\ndomain on each line. There is an example file in the example folder.\n\n```\n. {\n  log\n  prometheus\n\n  # load from url\n  blocklist https://mirror1.malwaredomains.com/files/justdomains {\n    # if CoreDNS listens at 53, you need another DNS to bootstrap the download\n    bootstrap_dns 1.1.1.1:53\n  }\n\n  # load from file, if the path is not absolute it will be relative to the Corefile\n  blocklist blocklist.txt\n\n  forward . 1.1.1.1 1.0.0.1\n}\n```\n\n## Installation\n\nThere is multiple ways to add plugins in [coredns][], but no matter the\nway you choose **the order matters**. The order sets the precedense of\nthe plugins when resolving queries. This means the blocklist plugin\nshould be before any plugins that would resolve the domains correctly.\nFurthermore, the log plugin should be before this plugin to get proper\nlogging.\n\n### Using plugin.cfg file\n\nAdd the following to the plugin.cfg file in your clone of coredns and follow\nthe instructions from coredns.\n\n```\nblocklist:github.com/relekang/coredns-blocklist\n```\n\n### Using a go file to compile the bundle\n\nSee the [example/main.go](./example/main.go) for how to create a file that you\ncan compile to get coredns with this plugin. This file will work with the\ncoredns version defined in [go.mod](./go.mod).\n\nThe example is bundled up with releases of on the [release page][] of this\nrepository. There it can be downloaded prebuilt for a bunch of environments.\n\n[coredns]: https://coredns.io\n[release page]: https://github.com/relekang/coredns-blocklist/releases\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelekang%2Fcoredns-blocklist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frelekang%2Fcoredns-blocklist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frelekang%2Fcoredns-blocklist/lists"}