mirror of
https://github.com/StackExchange/dnscontrol.git
synced 2025-01-10 17:38:13 +08:00
945ffb7e80
* feat: add Oracle provider * fix ALIAS and NS tests * return... else if -> return... if * fix assignment * remove extraneous blank lines Co-authored-by: Tom Limoncelli <tlimoncelli@stackoverflow.com>
156 lines
5.7 KiB
Markdown
156 lines
5.7 KiB
Markdown
# DNSControl
|
|
|
|
[](https://github.com/StackExchange/dnscontrol/actions?query=workflow%3Abuild+branch%3Amaster)
|
|
[](https://gitter.im/dnscontrol/Lobby)
|
|
[](https://groups.google.com/forum/#!forum/dnscontrol-discuss)
|
|
[](https://pkg.go.dev/github.com/StackExchange/dnscontrol)
|
|
|
|
[DNSControl](https://stackexchange.github.io/dnscontrol/) is a system
|
|
for maintaining DNS zones. It has two parts:
|
|
a domain specific language (DSL) for describing DNS zones plus
|
|
software that processes the DSL and pushes the resulting zones to
|
|
DNS providers such as Route53, Cloudflare, and Gandi. It can send
|
|
the same DNS records to multiple providers. It even generates
|
|
the most beautiful BIND zone files ever. It runs anywhere Go runs (Linux, macOS,
|
|
Windows). The provider model is extensible, so more providers can be added.
|
|
|
|
Currently supported DNS providers:
|
|
- AWS Route 53
|
|
- AXFR+DDNS
|
|
- Active Directory (Deprecated, see Microsoft DNS)
|
|
- Azure DNS
|
|
- BIND
|
|
- ClouDNS
|
|
- Cloudflare
|
|
- DNSOVERHTTPS
|
|
- DNSimple
|
|
- DigitalOcean
|
|
- Exoscale
|
|
- Gandi
|
|
- Google DNS
|
|
- Hetzner
|
|
- HEXONET
|
|
- Hurricane Electric DNS
|
|
- INWX
|
|
- Internet.bs
|
|
- Linode
|
|
- Microsoft Windows Server DNS Server
|
|
- NS1
|
|
- Name.com
|
|
- Namecheap
|
|
- Netcup
|
|
- OVH
|
|
- OctoDNS
|
|
- OpenSRS
|
|
- Oracle Cloud
|
|
- PowerDNS
|
|
- SoftLayer
|
|
- Vultr
|
|
- deSEC
|
|
|
|
At Stack Overflow, we use this system to manage hundreds of domains
|
|
and subdomains across multiple registrars and DNS providers.
|
|
|
|
You can think of it as a DNS compiler. The configuration files are
|
|
written in a DSL that looks a lot like JavaScript. It is compiled
|
|
to an intermediate representation (IR). Compiler back-ends use the
|
|
IR to update your DNS zones on services such as Route53, Cloudflare,
|
|
and Gandi, or systems such as BIND and Active Directory.
|
|
|
|
# An Example
|
|
|
|
`dnsconfig.js`:
|
|
|
|
```js
|
|
// define our registrar and providers
|
|
var namecom = NewRegistrar("name.com", "NAMEDOTCOM");
|
|
var r53 = NewDnsProvider("r53", "ROUTE53")
|
|
|
|
D("example.com", namecom, DnsProvider(r53),
|
|
A("@", "1.2.3.4"),
|
|
CNAME("www","@"),
|
|
MX("@",5,"mail.myserver.com."),
|
|
A("test", "5.6.7.8")
|
|
)
|
|
```
|
|
|
|
Running `dnscontrol preview` will talk to the providers (here name.com as registrar and route 53 as the dns host), and determine what changes need to be made.
|
|
|
|
Running `dnscontrol push` will make those changes with the provider and my dns records will be correctly updated.
|
|
|
|
See [Getting Started](https://stackexchange.github.io/dnscontrol/getting-started) page on documentation site.
|
|
|
|
# Benefits
|
|
|
|
* **Less error-prone** than editing a BIND zone file.
|
|
* **More reproducible** than clicking buttons on a web portal.
|
|
* **Easily switch between DNS providers:** The DNSControl language is
|
|
vendor-agnostic. If you use it to maintain your DNS zone records,
|
|
you can switch between DNS providers easily. In fact, DNSControl
|
|
will upload your DNS records to multiple providers, which means you
|
|
can test one while switching to another. We've switched providers 3
|
|
times in three years and we've never lost a DNS record.
|
|
* **Adopt CI/CD principles to DNS!** At StackOverflow we maintain our
|
|
DNSControl configurations in Git and use our CI system to roll out
|
|
changes. Keeping DNS information in a VCS means we have full
|
|
history. Using CI enables us to include unit-tests and
|
|
system-tests. Remember when you forgot to include a "." at the end
|
|
of an MX record? We haven't had that problem since we included a
|
|
test to make sure Tom doesn't make that mistake... again.
|
|
* **Adopt PR-based updates.** Allow developers to send updates as PRs,
|
|
which you can review before you approve.
|
|
* **Variables save time!** Assign an IP address to a constant and use the
|
|
variable name throughout the file. Need to change the IP address
|
|
globally? Just change the variable and "recompile."
|
|
* **Macros!** Define your SPF records, MX records, or other repeated data
|
|
once and re-use them for all domains.
|
|
* **Control Cloudflare from a single source of truth.** Enable/disable
|
|
Cloudflare proxying (the "orange cloud" button) directly from your
|
|
DNSControl files.
|
|
* **Keep similar domains in sync** with transforms and other features. If
|
|
one domain is supposed to be a filtered version of another, this is
|
|
easy to set up.
|
|
* **It is extendable!** All the DNS providers are written as plugins.
|
|
Writing new plugins is very easy.
|
|
|
|
# Installation
|
|
|
|
## From source
|
|
|
|
DNSControl can be built with Go version 1.14 or higher.
|
|
|
|
The `go get` command will will download the source, compile it, and
|
|
install `dnscontrol` in your `$GOBIN` directory.
|
|
|
|
To install, simply run
|
|
|
|
GO111MODULE=on go get github.com/StackExchange/dnscontrol/v3
|
|
|
|
To download the source
|
|
|
|
git clone github.com/StackExchange/dnscontrol
|
|
|
|
If these don't work, more info is in [#805](https://github.com/StackExchange/dnscontrol/issues/805).
|
|
|
|
---
|
|
|
|
|
|
## Via packages
|
|
|
|
Get prebuilt binaries from [github releases](https://github.com/StackExchange/dnscontrol/releases/latest)
|
|
|
|
Alternatively, on Mac you can install it using homebrew:
|
|
|
|
`brew install dnscontrol`
|
|
|
|
## Via [docker](https://hub.docker.com/r/stackexchange/dnscontrol/)
|
|
|
|
```
|
|
docker run --rm -it -v $(pwd)/dnsconfig.js:/dns/dnsconfig.js -v $(pwd)/creds.json:/dns/creds.json stackexchange/dnscontrol dnscontrol preview
|
|
```
|
|
|
|
## More info at our web site
|
|
|
|
The website: [https://stackexchange.github.io/dnscontrol/](https://stackexchange.github.io/dnscontrol/)
|
|
|
|
The getting started guide: [https://stackexchange.github.io/dnscontrol/getting-started](https://stackexchange.github.io/dnscontrol/getting-started)
|