{"id":15127609,"url":"https://github.com/fffaraz/microdns","last_synced_at":"2025-09-14T22:28:10.791Z","repository":{"id":57611118,"uuid":"60721917","full_name":"fffaraz/microdns","owner":"fffaraz","description":"A tiny dockerized DNS server in Go that (almost) always returns the same IP for any query sent to it.","archived":false,"fork":false,"pushed_at":"2024-05-29T06:13:59.000Z","size":35,"stargazers_count":65,"open_issues_count":0,"forks_count":15,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-06T15:47:38.156Z","etag":null,"topics":["dns","dns-server","docker","go","golang"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/fffaraz/microdns/","language":"Go","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/fffaraz.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":"2016-06-08T18:46:23.000Z","updated_at":"2024-11-18T04:48:38.000Z","dependencies_parsed_at":"2024-06-18T22:48:57.750Z","dependency_job_id":"0b64d1f8-d785-4411-aa67-a5d16d573ca6","html_url":"https://github.com/fffaraz/microdns","commit_stats":{"total_commits":66,"total_committers":1,"mean_commits":66.0,"dds":0.0,"last_synced_commit":"5f561ecbd3bde2f4e6c7f9886014ccdbf19276e1"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/fffaraz/microdns","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fffaraz%2Fmicrodns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fffaraz%2Fmicrodns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fffaraz%2Fmicrodns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fffaraz%2Fmicrodns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fffaraz","download_url":"https://codeload.github.com/fffaraz/microdns/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fffaraz%2Fmicrodns/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":275179486,"owners_count":25419063,"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","status":"online","status_checked_at":"2025-09-14T02:00:10.474Z","response_time":75,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["dns","dns-server","docker","go","golang"],"created_at":"2024-09-26T02:05:02.263Z","updated_at":"2025-09-14T22:28:10.727Z","avatar_url":"https://github.com/fffaraz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MicroDNS\nA tiny dockerized DNS server in Go that (almost) always returns the same IP for any query sent to it.\n\n[![](http://dockeri.co/image/fffaraz/microdns)](https://hub.docker.com/r/fffaraz/microdns/)\n[![](https://images.microbadger.com/badges/image/fffaraz/microdns.svg)](https://microbadger.com/images/fffaraz/microdns)\n\n## Quick Start (TL;DR)\n\n```\ndocker run -it --rm -p 53:53 -p 53:53/udp fffaraz/microdns:latest -log \\\n-ipv4 $(dig +short myip.opendns.com @resolver1.opendns.com) \\\n-ipv6 $(dig +short myip.opendns.com @2620:0:ccc::2 aaaa)\n```\n\n## Arguments \u0026 Options\n\n```\n\t-ipv4\t\tDefault IPv4 to return (default: 127.0.0.1)\n\t-ipv6\t\tDefault IPv6 to return (default: ::1)\n\t-ttl\t\tTime to live value (default: 86400)\n\t-log\t\tLog requests to stdout (default: false)\n\t-conf\t\tConfig file (default: /home/dns.conf)\n```\n\n## Config file format\n\n```\ndomain1.com.     127.0.0.1 ::1\ndomain2.com.     127.0.0.1 ::1\nwww.domain1.com. 127.0.0.1 ::1\nftp.domain2.com. 127.0.0.1 ::1\n```\n\n## How to Run\n\n```\ndocker run -d --restart=always -p 53:53 -p 53:53/udp --name microdns \\\n-v /home/microdns:/home \\\nfffaraz/microdns:latest \\\n-ipv4 127.0.0.1 \\\n-ipv6 ::1 \\\n-ttl 86400 \\\n-log \\\n-conf /home/dns.conf\n```\n\n## Request Stats\n\n```\nIP Adresses: cat log.out | cut -f2 | sort | uniq -cd | sort -nr\nDomains:     cat log.out | cut -f3 | sort | uniq -cd | sort -nr\n```\n\n## Metadata API\n\n```\ncurl http://169.254.169.254/metadata/v1/interfaces/public/0/ipv4/address\ncurl http://169.254.169.254/metadata/v1/interfaces/public/0/ipv6/address\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffffaraz%2Fmicrodns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffffaraz%2Fmicrodns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffffaraz%2Fmicrodns/lists"}