{"id":13758814,"url":"https://github.com/serverwentdown/alias","last_synced_at":"2025-04-12T02:20:18.840Z","repository":{"id":144201336,"uuid":"100831391","full_name":"serverwentdown/alias","owner":"serverwentdown","description":"CoreDNS plugin for replacing CNAME records on zone apex","archived":false,"fork":false,"pushed_at":"2024-05-05T05:05:46.000Z","size":525,"stargazers_count":19,"open_issues_count":3,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-05-05T06:21:31.101Z","etag":null,"topics":["aname","coredns","coredns-plugin","golang"],"latest_commit_sha":null,"homepage":"https://coredns.io/explugins/alias/","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/serverwentdown.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":"2017-08-20T01:36:36.000Z","updated_at":"2024-06-21T14:21:04.504Z","dependencies_parsed_at":null,"dependency_job_id":"f9740e88-8dbd-42de-812f-ce7f951e2619","html_url":"https://github.com/serverwentdown/alias","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverwentdown%2Falias","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverwentdown%2Falias/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverwentdown%2Falias/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/serverwentdown%2Falias/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/serverwentdown","download_url":"https://codeload.github.com/serverwentdown/alias/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248505921,"owners_count":21115354,"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":["aname","coredns","coredns-plugin","golang"],"created_at":"2024-08-03T13:00:37.671Z","updated_at":"2025-04-12T02:20:18.814Z","avatar_url":"https://github.com/serverwentdown.png","language":"Go","funding_links":[],"categories":["External Plguins"],"sub_categories":[],"readme":"\n# alias\n\nThe *alias* plugin eliminates CNAME records from zone apex by making the subsequent resolved records look like they belong to the zone apex. This behaves similarily to [CloudFlare's Zone Flattening](https://support.cloudflare.com/hc/en-us/articles/200169056-CNAME-Flattening-RFC-compliant-support-for-CNAME-at-the-root).\n\nThis plugin works only with plugins that produce A or AAAA records alongside the CNAME record. Examples include `auto` and `file`. However, you might need to adjust the order of this plugin to use it with other plugins. \n\n\u003e Preferrably, this should not be used in favour of the RFC drafts for the new [ANAME](https://tools.ietf.org/html/draft-ietf-dnsop-aname-00) records, but the DNS library used by CoreDNS does not support ANAME records yet. \n\nRelease builds can be found [here](https://github.com/serverwentdown/alias/releases)\n\n## Syntax\n\n```\nalias\n```\n\n## Examples\n\n```\nexample.com {\n\tfile db.example.com\n\talias\n}\n# This is used to resolve CNAME records by the `file` plugin. Modify accordingly\n. {\n\tforward . 1.1.1.1 1.0.0.1\n}\n```\n\nThis will transform responses like this:\n\n```\n;; ANSWER SECTION:\nexample.com.\t\t3600\tIN\tCNAME\ttwo.example.org.\ntwo.example.org.\t3600\tIN\tCNAME\tone.example.net.\none.example.net.\t3600\tIN\tA\t127.0.0.1\n```\n\ninto\n\n```\n;; ANSWER SECTION:\nexample.com.\t\t3600\tIN\tA\t127.0.0.1\n```\n\nSee [`example/`](example/) for a more extensive example. \n\n## Installation\n\nAs per [CoreDNS docs](https://coredns.io/2017/07/25/compile-time-enabling-or-disabling-plugins/), there are two ways.\n\n### Build with compile-time configuration file\n\n```\n$ git clone https://github.com/coredns/coredns\n$ cd coredns\n$ vim plugin.cfg\n# Add the line alias:github.com/serverwentdown/alias before the file middleware\n$ go generate\n$ go build\n$ ./coredns -plugins | grep alias\n```\n\n### Build with external golang source code\n\n```\n$ git clone https://github.com/serverwentdown/alias\n$ cd alias/coredns\n$ go build\n$ ./coredns -plugins | grep alias\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserverwentdown%2Falias","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fserverwentdown%2Falias","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fserverwentdown%2Falias/lists"}