
dnscontrol v5.0.2
DNS的基础设施即代码!
DNSControl
DNSControl 是面向 DNS 的基础设施即代码(Infrastructure as Code)工具。 它包含一个功能完备的配置语言(兼容 JavaScript), 以及可与 AWS Route 53、Cloudflare、Gandi 等 DNS 提供商 API 通信的“插件”。它可以将相同的 DNS 记录发送到多个提供商。 它可在任何 Go 可运行的平台上运行(Linux、macOS、Windows)。提供商模型 是可扩展的,因此可以添加更多提供商。
示例
dnsconfig.js:
D("example.com", REGISTRAR("ndc_main"), SERVICE("r53_main"),
A("@", "1.2.3.4"),
CNAME("www","@"),
MX("@",5,"mail.myserver.com."),
A("test", "5.6.7.8")
)
运行 dnscontrol preview 会与各提供商(此处 name.com 作为注册商,route 53 作为 DNS 主机)通信,并确定需要进行哪些更改。
运行 dnscontrol push 会通过提供商执行这些更改,我的 DNS 记录将被正确更新。
运行 DNSControl 最简单的方法是使用 Docker 容器:
docker run --rm -it -v "$(pwd):/dns" ghcr.io/dnscontrol/dnscontrol preview
入门指南
最快的入门方式是使用 dnscontrol init。交互式向导会询问你的 DNS 提供商和注册商,验证你的凭据,并生成可用的 creds.json 和 dnsconfig.js,其中包含你区域中已存在的记录。
有关完整操作步骤,请参阅文档站点上的 入门指南 页面。
想要对 DNS 数据实现完整的“GitOps”控制?克隆 dns-config 起始仓库即可开始!
支持的提供商
DNSControl 支持 78 个 DNS 提供商和注册商:
¹也支持注册商功能 ²仅注册商
优势
- 比编辑 BIND 区域文件更不易出错。
- 比在网页门户上点击按钮更具可复现性。
- 可轻松在 DNS 提供商之间切换: DNSControl 语言与供应商无关。如果你用它来维护 DNS 区域记录,就可以轻松地在 DNS 提供商之间切换。事实上,DNSControl 会将你的 DNS 记录上传到多个提供商,这意味着你可以在切换到一个提供商的同时测试另一个。我们在三年内切换了 3 次提供商,从未丢失过一条 DNS 记录。
- 将 CI/CD 原则应用于 DNS! StackOverflow 在 Git 中维护他们的 DNSControl 配置,并使用我们的 CI 系统来推出变更。将 DNS 信息保存在 VCS 中意味着我们拥有完整的历史记录。使用 CI 使我们能够包含单元测试和系统测试。还记得你忘记在 MX 记录末尾加上“.”的时候吗?自从我们加入了一项测试以确保 Tom 不会犯那个错误……再次犯那个错误以来,我们就再也没有遇到过这个问题。
- 采用(GitOps)基于 PR 的更新。 允许开发者以 PR 的形式发送更新,你可以在批准之前进行审查。
- 变量节省时间! 将一个 IP 地址赋给一个常量,并在整个文件中使用该变量名。需要全局更改 IP 地址?只需更改变量并“重新编译”即可。
- 宏! 一次性定义你的 SPF 记录、MX 记录或其他重复数据,并在所有域中重复使用它们。
- 从单一事实来源控制 Cloudflare。 直接从你的 DNSControl 文件中启用/禁用 Cloudflare 代理(“橙色云”按钮)。
- 通过转换和其他功能保持相似域同步。 如果一个域应该是另一个域的过滤版本,这很容易设置。
- 它具有可扩展性! 所有 DNS 提供商都以插件形式编写。编写新插件非常容易。
安装
DNSControl 可以通过 macOS、Linux 和 Windows 的软件包安装,也可以从源代码安装。请参阅官方说明。
通过 GitHub Actions (GHA)
官方 GitHub Action 为:github.com/dnscontrol/dnscontrol-action
其他人也创建了一些,例如: