{"id":23181145,"url":"https://github.com/chennqqi/simpledns","last_synced_at":"2026-05-07T00:38:58.289Z","repository":{"id":57556470,"uuid":"177116782","full_name":"chennqqi/simpledns","owner":"chennqqi","description":"simple dns server match zone by client ip","archived":false,"fork":false,"pushed_at":"2020-11-29T09:53:34.000Z","size":297,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-10T11:15:01.812Z","etag":null,"topics":["consul","dns","docker","forward","go","golang","k8s","match-ip","ping","proxy","upstream","zone"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chennqqi.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":"2019-03-22T10:03:37.000Z","updated_at":"2024-08-04T15:00:41.000Z","dependencies_parsed_at":"2022-09-14T12:31:28.845Z","dependency_job_id":null,"html_url":"https://github.com/chennqqi/simpledns","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/chennqqi%2Fsimpledns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chennqqi%2Fsimpledns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chennqqi%2Fsimpledns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chennqqi%2Fsimpledns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chennqqi","download_url":"https://codeload.github.com/chennqqi/simpledns/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247280268,"owners_count":20912967,"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":["consul","dns","docker","forward","go","golang","k8s","match-ip","ping","proxy","upstream","zone"],"created_at":"2024-12-18T08:14:41.926Z","updated_at":"2026-05-07T00:38:58.230Z","avatar_url":"https://github.com/chennqqi.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/chennqqi/simpledns.svg?branch=master)](https://travis-ci.org/chennqqi/simpledns) [![GoDoc](https://godoc.org/github.com/chennqqi/simpledns?status.svg)](https://godoc.org/github.com/chennqqi/simpledns)  [![LICENSE](https://img.shields.io/github/license/chennqqi/simpledns.svg?style=flat-square)](https://github.com/chennqqi/simpledns/blob/master/LICENSE) [![Go Report Card](https://goreportcard.com/badge/github.com/chennqqi/simpledns/go)](https://goreportcard.com/report/github.com/chennqqi/simpledns)\n\n# simple dns server\n\n\ta simple dns server \n\t\n![](https://raw.githubusercontent.com/chennqqi/simpledns/master/screen.gif)\n\n## feature\n\n* consul based configure file\n* standard zone file support\n* dynamic load zone files\n* client-ip(CIDR) based zone query\n* outter dns server proxy with auto switch\n* dns proxy with localcache, with this feature will enable proxy consul dns service to public\n* multiple resolve with ping check\n\n## build from source\n\t\nrequired go version \u003e= 1.10\n\n\tgo get -u -v github.com/chennqqi/simpledns\n \n## configure example\n\nsee [conf dir](https://github.com/chennqqi/simpledns/tree/master/conf)\n\t\n# usage\n\n\t./simpledns -conf [configure uri]\n\n## docker\n\nbuild:\n\t./builddocker.sh\n\t\nor pull:\n\tdocker pull sort/simpledns\n\n## known issue\n\n* consul service not support udp check\n\n## with consul as backend\n\nadd a forward upstream in forwards section, see [example](https://github.com/chennqqi/simpledns/tree/master/conf/simpledns.yml)\n\n          - name: consul.\n\t        cache_expire: 5m\n\t        upstreams:\n\t        - 'udp://127.0.0.1:8600'\n\n## with k8s/coredns as backend\n\n         - name: cluster.local.\n\t        cache_expire: 5m\n\t        upstreams:\n\t        - 'udp://xx.xx.xx.xx:53'\n\n## ping check\n\n\t\tservers: \n\t\t- name: example.com.\n\t\t  v_zones:\n\t\t  - match_clients: [ \"127.0.0.1/24\" ]\n\t\t    file: 'conf/zones/t.example.com'\n            checker: 'ping 10s' # every 10s check once\n\n\tnote: if after ping check, this was no one valid ipaddr. it will ignore check result, return all result.\n\t\n\n## TODO:\n\n* control api, support ddns\n* tcp dns service\n* multiplex tcp check and tcp dns service\n* add geo based zone query\n* performance test\n\n## License\n\nApache 2.0 license. See the [LICENSE](https://github.com/chennqqi/simpledns/blob/master/LICENSE) file for details.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchennqqi%2Fsimpledns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchennqqi%2Fsimpledns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchennqqi%2Fsimpledns/lists"}