2019-04-03 11:28:53 +01:00
|
|
|
## CoreDNS
|
2018-01-04 12:53:07 +00:00
|
|
|
|
2019-10-09 15:24:18 +08:00
|
|
|
*coredns* - pluggable DNS nameserver optimized for service discovery and flexibility.
|
2018-01-04 12:53:07 +00:00
|
|
|
|
|
|
|
|
## Synopsis
|
|
|
|
|
|
2020-01-28 11:13:11 +00:00
|
|
|
*coredns* **[-conf FILE]** **[-dns.port PORT}** **[OPTION]**...
|
2018-01-04 12:53:07 +00:00
|
|
|
|
|
|
|
|
## Description
|
|
|
|
|
|
|
|
|
|
CoreDNS is a DNS server that chains plugins. Each plugin handles a DNS feature, like rewriting
|
|
|
|
|
queries, kubernetes service discovery or just exporting metrics. There are many other plugins,
|
2019-04-21 22:38:40 +01:00
|
|
|
each described on <https://coredns.io/plugins> and their respective manual pages. Plugins not
|
2019-04-03 11:28:53 +01:00
|
|
|
bundled by default in CoreDNS are listed on <https://coredns.io/explugins>.
|
2018-01-04 12:53:07 +00:00
|
|
|
|
2019-04-21 22:38:40 +01:00
|
|
|
When started without options CoreDNS will look for a file named `Corefile` in the current
|
|
|
|
|
directory, if found, it will parse its contents and start up accordingly. If no `Corefile` is found
|
2018-01-04 12:53:07 +00:00
|
|
|
it will start with the *whoami* plugin (coredns-whoami(7)) and start listening on port 53 (unless
|
2019-02-27 15:02:50 +07:00
|
|
|
overridden with `-dns.port`).
|
2018-01-04 12:53:07 +00:00
|
|
|
|
|
|
|
|
Available options:
|
|
|
|
|
|
|
|
|
|
**-conf** **FILE**
|
2019-04-21 22:38:40 +01:00
|
|
|
: specify Corefile to load, if not given CoreDNS will look for a `Corefile` in the current
|
|
|
|
|
directory.
|
2018-01-04 12:53:07 +00:00
|
|
|
|
2021-05-28 16:08:13 +02:00
|
|
|
**-dns.port** **PORT** or **-p** **PORT**
|
2018-06-13 11:02:14 +01:00
|
|
|
: override default port (53) to listen on.
|
2018-01-04 12:53:07 +00:00
|
|
|
|
|
|
|
|
**-pidfile** **FILE**
|
|
|
|
|
: write PID to **FILE**.
|
|
|
|
|
|
|
|
|
|
**-plugins**
|
|
|
|
|
: list all plugins and quit.
|
|
|
|
|
|
|
|
|
|
**-quiet**
|
|
|
|
|
: don't print any version and port information on startup.
|
|
|
|
|
|
|
|
|
|
**-version**
|
|
|
|
|
: show version and quit.
|
|
|
|
|
|
|
|
|
|
## Authors
|
|
|
|
|
|
|
|
|
|
CoreDNS Authors.
|
|
|
|
|
|
|
|
|
|
## Copyright
|
|
|
|
|
|
|
|
|
|
Apache License 2.0
|
|
|
|
|
|
|
|
|
|
## See Also
|
|
|
|
|
|
2018-01-06 15:53:33 +00:00
|
|
|
Corefile(5) @@PLUGINS@@.
|