{"id":29270214,"url":"https://github.com/kolyunya/afdns","last_synced_at":"2025-07-04T22:11:22.677Z","repository":{"id":70769845,"uuid":"42367487","full_name":"Kolyunya/afdns","owner":"Kolyunya","description":"Ad free DNS server. A docker container with a DNS server configured to block advertisement hosts.","archived":false,"fork":false,"pushed_at":"2020-09-30T09:28:14.000Z","size":37,"stargazers_count":28,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-25T17:02:07.732Z","etag":null,"topics":["blacklist","custom-blacklist","dns","dns-server","docker"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/kolyunya/afdns/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kolyunya.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-09-12T18:07:37.000Z","updated_at":"2025-02-20T15:59:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"a4348d53-f34c-4cbd-aee1-ff066aaa98d5","html_url":"https://github.com/Kolyunya/afdns","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/Kolyunya/afdns","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kolyunya%2Fafdns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kolyunya%2Fafdns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kolyunya%2Fafdns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kolyunya%2Fafdns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kolyunya","download_url":"https://codeload.github.com/Kolyunya/afdns/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kolyunya%2Fafdns/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263626326,"owners_count":23490624,"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":["blacklist","custom-blacklist","dns","dns-server","docker"],"created_at":"2025-07-04T22:11:20.061Z","updated_at":"2025-07-04T22:11:22.666Z","avatar_url":"https://github.com/Kolyunya.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ad free DNS server\n\n## Description\nA docker [container](https://hub.docker.com/r/kolyunya/afdns/) with a DNS server configured to block advertisement hosts.\n\n## Installation\nJust start the container and you are good to go. Absolutely no configuration is required.\n\nIf you have `docker-compose`:\n```sh\ndocker-compose up --detach\n```\n\nIf you only have `docker`:\n```sh\ndocker run \\\n    --name afdns \\\n    --publish 53:53/tcp \\\n    --publish 53:53/udp \\\n    --mount type=volume,source=afdns_data,target=/etc/bind \\\n    --restart always \\\n    --tty \\\n    --detach \\\n    kolyunya/afdns\n```\n\n## Automatic blacklist source selection\nYou can select the source to get automatic blacklist from. After running any of the following commands the automatic blacklist will be updated and the corresponding source will be set as default. The following updates via cron job will use that source.\n\n* `docker exec afdns afdns-update-ahf` - update automatic blacklist from [amalgamated hosts file](https://github.com/StevenBlack/hosts).\n* `docker exec afdns afdns-update-hph` - update automatic blacklist from [hpHosts](http://hosts-file.net/).\n\n## Custom blacklist management\nThe server also has a manual blacklist. The following commands let you manage it.\n* `docker exec afdns afdns-host-add ad.example.com` -  add `ad.example.com` to the manual blacklist.\n* `docker exec afdns afdns-host-remove ad.example.com` - remove `ad.example.com` from the manual blacklist.\n\n## Default configuration details\n* DNS server utilized in this container is `BIND 9`.\n* Automatic blacklist is retrieved from [amalgamated hosts file](https://github.com/StevenBlack/hosts) once a day.\n* All non-advertisement request are forwarded to `8.8.8.8` and `8.8.4.4`.\n* Response rate limit is set to `8` per second (to mitigate DNS amplification attack).\n\n## Ad free VPN\nThis DNS server is incorporated in the [ad free VPN server](https://github.com/Kolyunya/afvpn).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkolyunya%2Fafdns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkolyunya%2Fafdns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkolyunya%2Fafdns/lists"}