{"id":29251763,"url":"https://github.com/macrat/roundns","last_synced_at":"2025-07-04T01:08:19.555Z","repository":{"id":54546661,"uuid":"323059617","full_name":"macrat/roundns","owner":"macrat","description":"Simplest DNS server for health-checking and load-balancing.","archived":false,"fork":false,"pushed_at":"2021-02-11T12:59:40.000Z","size":95,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2023-03-04T02:13:31.556Z","etag":null,"topics":[],"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/macrat.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":"2020-12-20T11:49:54.000Z","updated_at":"2022-02-16T02:29:57.000Z","dependencies_parsed_at":"2022-08-13T19:20:20.510Z","dependency_job_id":null,"html_url":"https://github.com/macrat/roundns","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/macrat/roundns","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrat%2Froundns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrat%2Froundns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrat%2Froundns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrat%2Froundns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/macrat","download_url":"https://codeload.github.com/macrat/roundns/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macrat%2Froundns/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263427316,"owners_count":23464845,"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":[],"created_at":"2025-07-04T01:08:18.052Z","updated_at":"2025-07-04T01:08:19.526Z","avatar_url":"https://github.com/macrat.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"RoundNS\n=======\n\nSimplest DNS server for health-checking and load-balancing.\n\n\n## How to use\n\n### 1. Make config file\n\n``` yaml\n#address: :53\n\n#log:\n#  level: warn\n\n#metrics:\n#  namespace: roundns\n#  address: :8553\n\n#ttl: 5m  # default TTL\n\nservices:\n  - fqdn: a.test.local.\n    type: A\n    ttl: 300\n    strategy: round-robin\n    health:\n      command:\n        - \"/bin/sh\"\n        - \"-c\"\n        - \"curl -fs http://$HOST\"\n      interval: 1m\n    hosts:\n      - 127.0.0.1\n      - 127.0.0.2\n\n  - fqdn: b.test.local.\n    type: A\n    ttl: 5m\n    health:\n      command: curl -fs http://$HOST  # It's shorthand of [\"sh\", \"-c\", \"curl -fs http://$HOST\"]\n      interval: 1h\n    hosts:\n      - 127.0.1.1\n      - 127.0.1.2\n\n  - fqdn: c.test.local.\n    type: A\n    health: curl -fs http://$HOST  # It's shorthand more\n    hosts:\n      - 127.0.1.1\n      - 127.0.1.2\n\n  # load balancing without health checking\n  - fqdn: cname.test.local.\n    type: CNAME\n    hosts:\n      - a.test.local.\n      - b.test.local.\n```\n\n\n### 2. Run server\n\n``` shell\n$ roundns -config ./config.yml\n```\n\nNow server is running on 0.0.0.0:53/udp, and you can get metrics on http://127.0.0.1:8553/metrics\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacrat%2Froundns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacrat%2Froundns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacrat%2Froundns/lists"}