{"id":15396600,"url":"https://github.com/hupe1980/fakedns","last_synced_at":"2025-04-04T16:41:52.065Z","repository":{"id":45080023,"uuid":"441632475","full_name":"hupe1980/fakedns","owner":"hupe1980","description":"Tiny DNS proxy for Penetration Testers and Malware Analysts","archived":false,"fork":false,"pushed_at":"2022-01-10T11:57:04.000Z","size":59,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-10T02:14:38.591Z","etag":null,"topics":["blue-team","dns","dns-server","fakedns","proxy","rebind","red-team","resolver","round-robin"],"latest_commit_sha":null,"homepage":"","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/hupe1980.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}},"created_at":"2021-12-25T08:01:43.000Z","updated_at":"2024-10-16T16:00:42.000Z","dependencies_parsed_at":"2022-08-26T09:41:25.807Z","dependency_job_id":null,"html_url":"https://github.com/hupe1980/fakedns","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hupe1980%2Ffakedns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hupe1980%2Ffakedns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hupe1980%2Ffakedns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hupe1980%2Ffakedns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hupe1980","download_url":"https://codeload.github.com/hupe1980/fakedns/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247214213,"owners_count":20902745,"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":["blue-team","dns","dns-server","fakedns","proxy","rebind","red-team","resolver","round-robin"],"created_at":"2024-10-01T15:34:21.603Z","updated_at":"2025-04-04T16:41:52.047Z","avatar_url":"https://github.com/hupe1980.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fakedns\n\u003e Tiny DNS proxy for Penetration Testers and Malware Analysts\n\n## Features\n- Regular Expression based DNS server\n- IPV4 \u0026 IPV6\n- DNS Rebinding\n- DNS Round-Robin\n- Upstream DNS Resolver\n\n## Installing\nYou can install the pre-compiled binary in several different ways\n\n### homebrew tap:\n```bash\nbrew tap hupe1980/fakedns\nbrew install fakedns\n```\n\n### snapcraft:\n[![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)](https://snapcraft.io/fakedns)\n```bash\nsudo snap install fakedns\n```\n\n### scoop:\n```bash\nscoop bucket add fakedns https://github.com/hupe1980/fakedns-bucket.git\nscoop install fakedns\n```\n\n### deb/rpm/apk:\n\nDownload the .deb, .rpm or .apk from the [releases page](https://github.com/hupe1980/fakedns/releases) and install them with the appropriate tools.\n\n### manually:\nDownload the pre-compiled binaries from the [releases page](https://github.com/hupe1980/fakedns/releases) and copy to the desired location.\n\n## Building from source\nInstall a [Go 1.17 compiler](https://golang.org/dl) and run the following command in the checked-out repository:\n```\nmake build\n```\n\n(Add the appropriate .exe extension on Windows systems, of course.)\n\n## Docker Support\n```bash\ngit clone https://github.com/hupe1980/fakedns\ncd fakedns\nmake docker-build\n\n# Run fakedns for example.org on port 4444\ndocker run -it --rm -p 4444:53/udp fakedns example.org -v --ipv4 127.0.0.1\n\n# Use dig to test fakedns\ndig example.org @localhost -p 4444\n```\n## How to use\n```console\nUsage:\n  fakedns [domains] [flags]\n\nExamples:\n- IPV4: fakedns example.org --ipv4 127.0.0.1\n- Wildcards: fakedns example.* --ipv4 127.0.0.1\n- RoundRobin: fakedns example.org --ipv4 127.0.0.1,10.10.10.10\n- Rebind: fakedns example.org --ipv4 127.0.0.1 --rebind-v4 10.10.10.10\n- Upstream: fakedns example.org --ipv4 127.0.0.1 --upstream 8.8.8.8\n\nFlags:\n  -a, --addr string            fakeDNS address (default \"0.0.0.0:53\")\n  -h, --help                   help for fakedns\n      --ipv4 strings           IPV4 address to return\n      --ipv6 strings           IPV6 address to return\n      --mx string              host name of mail exchange server\n  -n, --net string             fakeDNS network protocol (default \"udp\")\n      --rebind-threshold int   rebind threshold (default 1)\n      --rebind-v4 string       IPV4 rebind address\n      --rebind-v6 string       IPV6 rebind address\n      --text strings           TXT text value\n      --ttl uint32             time to live (default 60)\n      --upstream string        upstream dns server\n  -v, --verbose                print detailed logging messages\n      --version                version for fakedns\n```\n\n## License\n[MIT](LICENCE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhupe1980%2Ffakedns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhupe1980%2Ffakedns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhupe1980%2Ffakedns/lists"}