返回更新列表
新发布Sep 3, 2026

dnscontrol v5.0.2

DNS的基础设施即代码!

分享

DNSControl

DNSControl/dnscontrol/build OpenSSF Scorecard Google Group PkgGoDev

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 提供商和注册商:

AdGuard HomeAkamai Edge DNSAlibaba Cloud DNSAmazon Route 53¹AutoDNS¹
AXFR + DDNSAzure DNSAzure Private DNSBunny DNSCentralNic Reseller¹
CloudflareClouDNS¹CloudPressConstellixCSC Global¹
deSECDigitalOceanDNS Made EasyDNS over HTTPS²dnscale
DNSimple¹DomainnameshopDynadot²Dynueasyname²
ExoscaleFortiGateG-Core LabsGandi v5¹Gidinet¹
GigahostGoogle Cloud DNSHetzner DNShosting.de¹Huawei Cloud DNS
Hurricane Electric DNSInfobloxInfomaniakInternet.bs²INWX¹
IONOSISC BINDJoker.comLinodeLoopia¹
LuaDNSMikroTik RouterOSMisaka.iomittwald mStudioMythic Beasts
Name.com¹Namecheap¹NetbirdnetcupNetlify
NetnodNexDNSNS1OpenproviderOpenSRS²
OpenWrtOracle Cloud InfrastructureOVHcloud¹PacketframePorkbun¹
PowerDNSRealtime Register¹RWTH AachenSakura CloudScaleway
SoftLayerSpaceship¹Tencent Cloud DNS¹TransIPUniFi
VercelVultrWebSupport

¹也支持注册商功能 ²仅注册商

优势

  • 比编辑 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

其他人也创建了一些,例如:

分类